「モジュール:Message box/doc」を編集中

{{Documentation subpage}}
{{Used in system}}
{{module rating|p}}
英語版の Revision as of 09:03, 2 October 2017 まで取り込んだ時点で用意されていた、2019年初頭の文書の翻訳です。

このメタモジュールには、メッセージボックス・テンプレート（{{tl|mbox}}, {{tl|ambox}}, {{tl|cmbox}}, {{tl|fmbox}}, {{tl|imbox}}, {{tl|ombox}}, and {{tl|tmbox}}）が実装されています。Luaモジュールから呼び出されることが想定され、ウィキのページから直接使用すべきではありません。もしこのモジュールの機能をウィキページで使いたいのであれば、代わりにそれぞれのメッセージボックス・テンプレートを使用してください。

== 使用法 ==

このモジュールを他のLuaモジュールにて使うには、最初に読み込みが必要です。

<syntaxhighlight lang="lua">
local messageBox = require('Module:Message box')
</syntaxhighlight>

メッセージボックスを作るには、<code>main</code>関数を使います。2つの引数があります: 1つ目はメッセージボックスの type （文字列） 2つ目はメッセージボックスの引数を含んだ連想配列です。

<syntaxhighlight lang="lua">
local box = messageBox.main( boxType, {
    param1 = param1,
    param2 = param2,
    -- More parameters...
})
</syntaxhighlight>

7種類のメッセージボックスがあります:

{| class="wikitable"
! Box type !! Template !! Purpose
|-
| <code>mbox</code> || {{tl|mbox}} || 複数の名前空間 multiple
|-
| <code>ambox</code> || {{tl|ambox}} || 記事 Article 名前空間
|-
| <code>cmbox</code> || {{tl|cmbox}} || カテゴリ 名前空間
|-
| <code>fmbox</code> || {{tl|fmbox}} || interface message boxes
|-
| <code>imbox</code> || {{tl|imbox}} || 画像 image ファイル 名前空間
|-
| <code>tmbox</code> || {{tl|tmbox}} || ノート talk page 名前空間
|-
| <code>ombox</code> || {{tl|ombox}} ||他の other 名前空間
|}

使用できる引数については、それぞれのテンプレートのページをご覧ください。

== #invokeからの使用 ==

<code>main</code> 関数と同様に、このモジュールはそれぞれの種類のボックスのための関数に分かれています。<code><nowiki>{{#invoke:Message box|mbox|...}}</nowiki></code>, <code><nowiki>{{#invoke:Message box|ambox|...}}</nowiki></code> といったコードを使って利用します。
他のモジュールから呼び出された場合に動作しますが、この呼び出しからは #invoke に渡された引数を処理するためのコードを利用し、<code>main</code>を呼び出すより効率は悪いでしょう。

== 専門的な詳細 ==

このモジュールは、それぞれのテンプレートのために、以下のような同じ基礎となるコードを使っています。違いは[[Module:Message box/configuration]]のデータを使って設定されます。設定可能なオプションは以下です。

* <code>types</code> - a table containing data used by the type parameter of the message box. The table keys are the values that can be passed to the type parameter, and the table values are tables containing the class and the image used by that type.
* <code>default</code> - the type to use if no value was passed to the type parameter, or if an invalid value was specified.
* <code>showInvalidTypeError</code> - whether to show an error if the value passed to the type parameter was invalid.
* <code>allowBlankParams</code> - usually blank values are stripped from parameters passed to the module. However, whitespace is preserved for the parameters included in the allowBlankParams table.
* <code>allowSmall</code> - whether a small version of the message box can be produced with "small=yes".
* <code>smallParam</code> - a custom name for the small parameter. For example, if set to "left" you can produce a small message box using "small=left".
* <code>smallClass</code> - the class to use for small message boxes.
* <code>substCheck</code> - whether to perform a subst check or not.
* <code>classes</code> - an array of classes to use with the message box.
* <code>imageEmptyCell</code> - whether to use an empty {{tag|td}} cell if there is no image set. This is used to preserve spacing for message boxes with a width of less than 100% of the screen.
* <code>imageEmptyCellStyle</code> - whether empty image cells should be styled.
* <code>imageCheckBlank</code> - whether "image=blank" results in no image being displayed.
* <code>imageSmallSize</code> - usually, images used in small message boxes are set to 30x30px. This sets a custom size.
* <code>imageCellDiv</code> - whether to enclose the image in a div enforcing a maximum image size.
* <code>useCollapsibleTextFields</code> - whether to use text fields that can be collapsed, i.e. "issue", "fix", "talk", etc. Currently only used in ambox.
* <code>imageRightNone</code> - whether imageright=none results in no image being displayed on the right-hand side of the message box.
* <code>sectionDefault</code> - the default name for the "section" parameter. Depends on <code>useCollapsibleTextFields</code>.
* <code>allowMainspaceCategories</code> - allow categorisation in the main namespace.
* <code>templateCategory</code> - the name of a category to be placed on the template page.
* <code>templateCategoryRequireName</code> - whether the <code>name</code> parameter is required to display the template category.
* <code>templateErrorCategory</code> - the name of the error category to be used on the template page.
* <code>templateErrorParamsToCheck</code> - an array of parameter names to check. If any are absent, the <code>templateErrorCategory</code> is applied to the template page.