Модуль:Message box/doc
Это страница документации Модуль:Message box.
Внимание! Это один из самых используемых модулей. Каждое его изменение создаёт дополнительную нагрузку на серверы проекта. Пожалуйста, убедитесь в адекватности и правильности ваших изменений, проверьте их на тестовых страницах.
|
Этот модуль относится к критическим. У него очень много включений или он используется с подстановкой. Из-за опасности вандализма или ошибочного редактирования он был защищён. |
Прежде, чем вносить какие-либо изменения в данный модуль, просьба оттестировать их в /песочнице и проверить результат на странице с /контрольными примерами. Изменения могут быть внесены после этого в данный модуль всего одной правкой. |
Этот модуль предназначен для создания шаблонов-сообщений ({{mbox}}, {{ambox}}, {{cmbox}}, {{fmbox}}, {{imbox}}, {{ombox}} и {{tmbox}}), также он может использоваться другими модулями. Этот модуль не должен вызываться напрямую из статей, для этого используйте один из вышеперечисленных шаблонов-сообщений.
Использование
[править]Чтобы использовать данной модуль в другом модуле, нужно для начала загрузить его:
local messageBox = require('Module:Message box')
Чтобы создать шаблон-сообщение, используйте функцию main
. У неё есть 2 параметра: первый — тип шаблона, второй — таблица с параметрами шаблона.
local box = messageBox.main( boxType, {
param1 = param1,
param2 = param2,
-- Еще параметры...
})
Существует 7 вариантов оформления в зависимости от пространства имен, в котором располагается шаблон:
Функция | Шаблон | Тип страницы |
---|---|---|
mbox |
{{mbox}} | определяется автоматически |
ambox |
{{ambox}} | статьи |
cmbox |
{{cmbox}} | категории |
fmbox |
{{fmbox}} | страницы интерфейса |
imbox |
{{imbox}} | файлы |
tmbox |
{{tmbox}} | страницы обсуждения |
ombox |
{{ombox}} | другие пространства имен |
Подробнее о дополнительных параметрах шаблонов см. их документации.
Вызов через #invoke
[править]Помимо функции main
, в модуле есть отдельные функции для каждого типа сообщений. Они вызываются кодом {{
invoke:Message box|mbox|...}}
,{{
invoke:Message box|ambox|...}}
и т. д. Также эти функции могут быть вызваны другими модулями, однако это менее эффективно, чем вызов функцииmain
.
Технические детали
[править]Все перечисленные выше шаблоны основаны на одном базовом коде, а различия между каждым из них настраиваются на отдельной странице. Ниже перечислены различные параметры конфигурации:
types
— 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.default
— the type to use if no value was passed to the type parameter, or if an invalid value was specified.showInvalidTypeError
— whether to show an error if the value passed to the type parameter was invalid.allowBlankParams
— usually blank values are stripped from parameters passed to the module. However, whitespace is preserved for the parameters included in the allowBlankParams table.allowSmall
— whether a small version of the message box can be produced with «small=yes».smallParam
— a custom name for the small parameter. For example, if set to «left» you can produce a small message box using «small=left».smallClass
— the class to use for small message boxes.substCheck
— whether to perform a subst check or not.classes
— an array of classes to use with the message box.imageEmptyCell
— whether to use an empty Шаблон:Tag 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.imageEmptyCellStyle
— whether empty image cells should be styled.imageCheckBlank
— whether «image=blank» results in no image being displayed.imageSmallSize
— usually, images used in small message boxes are set to 30x30px. This sets a custom size.imageCellDiv
— whether to enclose the image in a div enforcing a maximum image size.useCollapsibleTextFields
— whether to use text fields that can be collapsed, i.e. «issue», «fix», «talk», etc. Currently only used in ambox.imageRightNone
— whether imageright=none results in no image being displayed on the right-hand side of the message box.sectionDefault
— the default name for the «section» parameter. Depends onuseCollapsibleTextFields
.allowMainspaceCategories
— allow categorisation in the main namespace.templateCategory
— the name of a category to be placed on the template page.templateCategoryRequireName
— whether thename
parameter is required to display the template category.templateErrorCategory
— the name of the error category to be used on the template page.templateErrorParamsToCheck
— an array of parameter names to check. If any are absent, thetemplateErrorCategory
is applied to the template page.