Модуль:Message box/doc: различия между версиями
Перейти к навигации
Перейти к поиску
Andras (обсуждение | вклад) Нет описания правки |
Andras (обсуждение | вклад) |
||
| Строка 15: | Строка 15: | ||
Чтобы использовать данный модуль в другом модуле, нужно для начала загрузить его: | Чтобы использовать данный модуль в другом модуле, нужно для начала загрузить его: | ||
{{ | {{Luacode|1= | ||
local messageBox = require('Module:Message box') | local messageBox = require('Module:Message box') | ||
}} | }} | ||
| Строка 21: | Строка 21: | ||
Чтобы создать шаблон-сообщение, используйте функцию <code>main</code>. У неё есть 2 параметра: первый — тип шаблона, второй — таблица с параметрами шаблона. | Чтобы создать шаблон-сообщение, используйте функцию <code>main</code>. У неё есть 2 параметра: первый — тип шаблона, второй — таблица с параметрами шаблона. | ||
{{ | {{Luacode|1= | ||
local box = messageBox.main( boxType, { | local box = messageBox.main( boxType, { | ||
param1 = param1, | param1 = param1, | ||
| Строка 34: | Строка 34: | ||
! Функция !! Шаблон !! Тип страницы | ! Функция !! Шаблон !! Тип страницы | ||
|- | |- | ||
| <code> | | <code>Mbox</code> || {{Tl|Mbox}} || определяется автоматически | ||
|- | |- | ||
| <code> | | <code>Ambox</code> || {{Tl|Ambox}} || статьи | ||
|- | |- | ||
| <code> | | <code>Cmbox</code> || {{Tl|Cmbox}} || категории | ||
|- | |- | ||
| <code> | | <code>Fmbox</code> || {{Tl|Fmbox}} || страницы интерфейса | ||
|- | |- | ||
| <code> | | <code>Imbox</code> || {{Tl|Imbox}} || файлы | ||
|- | |- | ||
| <code> | | <code>Tmbox</code> || {{Tl|Tmbox}} || страницы обсуждения | ||
|- | |- | ||
| <code>Ombox</code> || {{ | | <code>Ombox</code> || {{Tl|Ombox}} || другие пространства имен | ||
|} | |} | ||
Версия от 20:24, 13 мая 2023
 | Внимание! Это один из самых используемых модулей. |
 | Прежде чем вносить какие-либо изменения в данный модуль, просьба оттестировать их в /песочнице и проверить результат на странице с /контрольными примерами. Изменения могут быть внесены после этого в данный модуль всего одной правкой. |
 | Этот шаблон частично реализован на основе Lua:
|
 |
Этот модуль предназначен для создания шаблонов-сообщений (Шаблон:tl, Шаблон:tl, Шаблон:tl, Шаблон:tl, Шаблон:tl, {{Ombox}} и Шаблон:tl), также он может использоваться другими модулями. Этот модуль не должен вызываться напрямую из статей, для этого используйте один из вышеперечисленных шаблонов-сообщений.
Использование
Чтобы использовать данный модуль в другом модуле, нужно для начала загрузить его:
Чтобы создать шаблон-сообщение, используйте функцию main. У неё есть 2 параметра: первый — тип шаблона, второй — таблица с параметрами шаблона.
Существует 7 вариантов оформления в зависимости от пространства имен, в котором располагается шаблон:
| Функция | Шаблон | Тип страницы |
|---|---|---|
Mbox |
{{Mbox}} | определяется автоматически |
Ambox |
{{Ambox}} | статьи |
Cmbox |
{{Cmbox}} | категории |
Fmbox |
{{Fmbox}} | страницы интерфейса |
Imbox |
{{Imbox}} | файлы |
Tmbox |
{{Tmbox}} | страницы обсуждения |
Ombox |
{{Ombox}} | другие пространства имен |
Подробнее о дополнительных параметрах шаблонов см. их документации.
Вызов через #invoke
Помимо функции main, в модуле есть отдельные функции для каждого типа сообщений. Они вызываются кодом Шаблон:tc, Шаблон:tc и т. д. Также эти функции могут быть вызваны другими модулями, однако это менее эффективно, чем вызов функции main.
Технические детали
Все перечисленные выше шаблоны основаны на одном базовом коде, а различия между каждым из них настраиваются на отдельной странице. Ниже перечислены различные параметры конфигурации:
types— таблица, содержащая данные, используемые типами сообщения. Ключи таблицы — это значения, которые можно передать определенному типу сообщения, а значения таблицы — это таблицы, содержащие класс и изображение, используемые этим типом.default— тип, используемый, если параметру типа не было передано значение или если было указано недопустимое значение.showInvalidTypeError— показывать ли ошибку, если значение, переданное параметру типа, было недопустимым.allowBlankParams— обычно пустые значения удаляются из параметров, передаваемых модулю. Однако пробел сохраняется для параметров, включенных в таблицуallowBlankParams.allowSmall— можно ли создать уменьшенную версию сообщения с помощью Шаблон:para.smallParam— пользовательское имя для малого параметра. Например, если установлено значениеleft, вы можете создать малое сообщение, используя Шаблон:para.smallClass— класс, используемый для малых сообщений.substCheck— выполнять проверку подстановки или нет.classes— массив классов для использования в сообщении.imageEmptyCell— использовать ли пустую ячейку Шаблон:tag, если нет набора изображений. Это используется для сохранения интервалов между окнами сообщений шириной менее 100 % экрана.imageEmptyCellStyle— следует ли стилизовать пустые ячейки изображения.imageCheckBlank— приводит ли Шаблон:para к отсутствию изображения.imageSmallSize— обычно изображения, используемые в малых сообщениях, имеют размер 30x30px. Этот параметр устанавливает пользовательский размер.imageCellDiv— следует ли заключать изображение в div, обеспечивая максимальный размер изображения.useCollapsibleTextFields— использовать ли текстовые поля, которые можно свернуть, то есть Шаблон:para, Шаблон:para, Шаблон:para и т. д. В настоящее время используется только в ambox.imageRightNone— если Шаблон:para приводит к тому, что изображение не отображается в правой части окна сообщения.allowMainspaceCategories— разрешить категоризацию в основном пространстве имен.templateCategory— название категории для размещения на странице шаблона.templateCategoryRequireName— требуется ли параметр Шаблон:para для отображения категории шаблона.templateErrorCategory— имя категории ошибок, которая будет использоваться на странице шаблона.templateErrorParamsToCheck— массив имен параметров для проверки. Если таковые отсутствуют, к странице шаблона применяетсяtemplateErrorCategory.