Шаблон:fmbox

{{{text}}}

Документация

[просмотр | править | история | обновить]

Этот мета-шаблон используется для формирования информационных сообщений сверху и снизу страницы (footer & header message box). Шаблон позволяет задать различные цвета окна сообщения, вид значка и прочее.

Этот шаблон подобен шаблону {{ambox}} и использует большинство его параметров. Основное его отличие в том, что он использует другие цвета и его ширина равна 100% ширины страницы, на которой он помещён.

Использование

Простое использование:

{{fmbox | text = Some text.}}

Some text.

Сложное использование:

{{fmbox
| type      = editnotice
| image     = [[Image:Emblem-question-yellow.svg|40px]]
| style     = border: 1px solid #f4c430;
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = The message body text.
}}

The message body text.

Типы сообщений сверху и снизу

Следующие примеры используют различные значения параметра type, но не меняют параметры отображения значка (иконки), поэтому везде отображается картинка по умолчанию.

type=warning – Предупреждения.

type=editnotice – Информационные сообщения с прозрачным фоном.

type=system – Информационные сообщения на светло-сером фоне. (по умолчанию).

Другие значки

Значки по умолчанию в примерах выше используются в основном для тестирования и демонстрации. В большинстве случаев целесообразнее более конкретно указывать вид значка. Ниже показаны несколько примеров, поясняющих как использовать параметр image для отображения других значков.

image = [[Image:User-info.svg|40px]]
Этот значок можно использовать на личной странице.

image = [[Image:Commons-logo.svg|40x40px]]
Обратите внимание, что использование параметра "40x40px" также ограничивает высоту значка. Этот значок можно использовать для информирования о изображении находящемся на викискладе.

Дополнительно

Примеры использования других параметров и их комбинаций.

Не заданы параметры type и image (по умолчанию)

Не заданы параметр type и image=none – Значок не показывается и текст занимает всю ширину окна сообщения.

image = [[Image:User-info.svg|40px]]
imageright = [[Image:Nuvola apps bookcase.svg|40px]]

Параметры

Список всех параметров:

{{fmbox
| type  = system / editnotice / warning
| image = none / [[Image:Some image.svg|40px]]
| imageright = [[Image:Some image.svg|40px]]
| id = CSS id
| class = CSS class names
| style = CSS values
| textstyle = CSS values
| text  = The message body text.
}}

type

нет параметра = если параметр type не задан, то используется значение по умолчанию system (голубой фон).

image

нет параметра = если параметр image не задан, то используется значок по умолчанию в зависимости от того что задано в параметре type.

файл изображения = ссылка на файл использующая вики разметку. Размер подгоняется под 40px - 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:

image = [[Image:Sub-arrows.svg|40px]]

none = обозначает, что не нужно отображать значок.

imageright

нет параметра = если параметр imageright не задан, то значок справа не показывается.

файл изображения = ссылка на файл использующая вики разметку. Размер подгоняется под 40px - 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:

imageright = [[Image:Nuvola apps bookcase.png|40px]]

одругое = все что вы хотите отобразить справа.

id

Необязательный CSS идентификатор сообщения. В основном используется для пометы сообщения, чтобы упростить определение его присутствия из javascript. Например:

id = sp-contributions-footer

class

Необязательное имя класса CSS сообщения. В основном используется для пометы сообщений одинакового типа, чтобы упрости настройку их вида. Например:

class = sp-contributions-footer

style

Дополнительный параметр стиля CSS для всей таблицы. Например:

style = margin-top: 1em;

textstyle

Дополнительный параметр стиля CSS для текстовой ячейки. Например:

textstyle = font-size: 90%; text-align: center;

text

Текст сообщения.

Технические детали

Если вам необходимо использовать специальные символы внутри параметра text, то вам необходимо заменять их ESC-последовательностями :

{{fmbox
| text  = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.  
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>. 
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}

Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. А здесь знак разделения параметров | и две угловые скобки }}. А здесь знак разделения параметров перед двумя закрывающими фигурными скобками |}}.

Этот шаблон использует fmbox CSS классы в MediaWiki:Common.css влияющие на его внешний вид, т.е. он полностью перенастраиваемый.

Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, т.к. у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.

Файлы значков по умолчанию для этого мета-шаблона имеют формат png, а не svg. Основная причина в том, что у некоторых старых браузеров есть проблемы с отображением прозрачного фона, который подставляет MediaWiki движок для svg изображений. Все png изображение оптимизированы вручную и имеют прозрачный фон чтобы одинаково хорошо отображаться во всех браузерах. Обратите внимание, что svg значки выглядят плохо только в старых браузерах, поэтому такая ручная оптимизация сделана только для наиболее часто использующихся иконок.