モジュール:LinkMail/doc
このページは、モジュール:LinkMailの説明文を記述するページです。
 |
このテンプレートは、以下のLuaモジュールを使用しています。 |
このモジュールは、メールアドレスを整形し、メール用のリンクを付け加えます。
コメントはメールアドレスの後に括弧で囲んで追加する必要があります。認識できないエラーが出ている場合、メールアドレスに左から右のマーク（通常@の前後またはメールアドレスの末尾）などの目に見えない制御文字が含まれていたり、ハイフンの文字が間違っている可能性があります。ソフトハイフン（U+00AD：「」）やハイフンマイナス（U+002D：「-」）ではなくハイフン（U+2010：「‐」）を使用してください。また、全角になっていないかも注意が必要です。
ウィキデータでのバージョン： 2023-12-08 
使用状況
[編集]このモジュールを使用しているモジュールは以下の通りです：
このモジュールを使用しているテンプレートは以下の通りです：
メンテナンスカテゴリ
[編集]このモジュールは以下のメンテナンスカテゴリを使用します：
使用例
[編集]| メールアドレス | ウィキ構文 | 出力 |
|---|---|---|
| cafe@xyz.hotel.com | {{#invoke:LinkMail|linkMails|cafe@xyz.hotel.com}} | cafe@xyz.hotel.com |
| café@xyz.hotel.com | {{#invoke:LinkMail|linkMails|café@xyz.hotel.com}} | café@xyz.hotel.com Category:Unicode文字を含んだメールアドレス |
| info.main@xyz.hotel-abc.com | {{#invoke:LinkMail|linkMails|info.main@xyz.hotel-abc.com (情報)}} | info.main@xyz.hotel-abc.com (情報) Category:無効なフォーマットのメールアドレス メールアドレスのフォーマットが無効です |
| info@xyz.hotel.com, reservation@xyz.hotel.travel | {{#invoke:LinkMail|linkMails|info@xyz.hotel.com, reservation@xyz.hotel.travel}} | info@xyz.hotel.com、reservation@xyz.hotel.travel |
| info@$xyz.hotel.com | {{#invoke:LinkMail|linkMails|info@$xyz.hotel.com}} | info@$xyz.hotel.com Category:無効なフォーマットのメールアドレス メールアドレスのフォーマットが無効です |
エラーが発生した場合、メンテナンスカテゴリに加えてメールアドレスの後にエラーメッセージが表示されます。
関数
[編集]function lm._isEmail( s )
s: string;
メールアドレス s が有効なフォーマットかどうかを調べます。
function lm._linkMail( m, args, ignoreUnicode )
m: string;args: arguments array;ignoreUnicode: boolean;
渡されたメールアドレスの有効性を確認して、有効ならばリンクを付けて返します．
function lm.linkMailSet( args )
args: arguments array;
この関数は複数のメールアドレスを切り分け、1つずつlm.linkMailに渡します。
function lm.linkMails( frame )
frame: frame object;
この関数は、ウィキテキスト内でのマジックワード呼び出しのインターフェースを提供します。
function lm.linkMailsTemplate( frame )
frame: frame object;
この関数はテンプレート呼び出しのインターフェースを提供します。
変数
[編集]lm.categories— エラーメッセージと同じ名前のカテゴリを含む配列lm.delimiters— 電話番号の様々な区切り文字を含む配列。この配列に半角カンマを入れる必要はありません。lm.addNum— 実際に表示されるメールアドレスの数。余分なアドレス（何もしなければ非表示のアドレス）はHTMLのソースに入っており、CSSスタイルを使うことで表示できます。
CSSクラス
[編集]このモジュールは以下のCSSクラスを使用します：
error— エラーメッセージに付与されるクラスlisting-check-recommended— 推奨される注意事項のクラスlisting-add-contact— 非表示のメールアドレスのクラス。メールアドレスが既定の数以上ある場合、余ったアドレスは非表示になりますが、HTMLのソーステキストには追加されます。