Просмотр кода страницы Шаблон:Fmbox/doc

{{docpage}}
{{onLua|Message box}}
{{high-use}}
{{Используйте песочницу}}
{{Mbox templates|nocat=1}}
Этот мета-шаблон ('''f'''ooter & header '''m'''essage '''box''') используется для формирования информационных сообщений сверху и снизу страницы. Шаблон позволяет задать различные цвета окна сообщения, вид значка и прочее.

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

=== Использование ===
Простое использование:
<pre>
{{fmbox | text = Обычный текст. }}
</pre>

{{fmbox | text = Обычный текст. }}


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

<pre>
{{fmbox
| type      = editnotice
| 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.
}}
</pre>

{{fmbox
| type = editnotice
| 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.
}}

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

{{fmbox
| type = warning
| text = type=<u>warning</u> — предупреждения.
}}

{{fmbox
| type = editnotice
| text = type=<u>editnotice</u> — информационные сообщения с прозрачным фоном.
}}

{{fmbox
| type = system
| text = type=<u>system</u> — информационные сообщения на светло-сером фоне (по умолчанию).
}}

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

{{fmbox
| image = [[Файл:User-info.svg|40px]]
| text  = image = <nowiki>[[Файл:User-info.svg|40px]]</nowiki> <br> Этот значок можно использовать на личной странице. 
}}
{{fmbox
| image = [[Файл:Commons-logo.svg|40x40px]]
| text  = image = <nowiki>[[Файл:Commons-logo.svg|40x40px]]</nowiki> <br> Обратите внимание, что использование параметра "40x40px" также ограничивает высоту значка. Этот значок можно использовать для информирования о изображении находящемся на викискладе.
}}

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

{{fmbox
| text  = Не заданы параметры type и image (по умолчанию)
}}
{{fmbox
| image = none
| text  =  Не заданы параметр type и '''image=none''' — значок не показывается и текст занимает всю ширину окна сообщения.
}}
{{fmbox
| image = [[Файл:User-info.svg|40px]]
| imageright = [[Файл:Nuvola apps bookcase.svg|40px]]
| text  = image = <nowiki>[[Файл:User-info.svg|40px]]</nowiki> <br> imageright = <nowiki>[[Файл:Nuvola apps bookcase.svg|40px]]</nowiki>
}}

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

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

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

'''image'''
: '''нет параметра''' = если параметр '''image''' не задан, то используется значок по умолчанию в зависимости от того что задано в параметре '''type'''.
: '''файл изображения''' = ссылка на файл использующая вики разметку. Размер подгоняется под 40px — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
:: <code><nowiki>image = [[Файл:Sub-arrows.svg|40px]]</nowiki></code>
: '''none''' = обозначает, что не нужно отображать значок.

'''imageright'''
: '''нет параметра''' = если параметр '''imageright''' не задан, то значок справа не показывается.
: '''файл изображения''' = ссылка на файл использующая вики разметку. Размер подгоняется под 40px — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
:: <code><nowiki>imageright = [[Файл:Nuvola apps bookcase.png|40px]]</nowiki></code>
: '''одругое''' = все что вы хотите отобразить справа.

'''id'''
: Необязательный [[CSS]]-идентификатор сообщения. В основном используется для пометы сообщения, чтобы упростить определение его присутствия из javascript. Например:
:: <code>id = sp-contributions-footer</code>

'''class'''
: Необязательное имя класса [[CSS]] сообщения. В основном используется для пометы сообщений одинакового типа, чтобы упростить настройку их вида. Например:
:: <code>class = sp-contributions-footer</code>

'''style'''
: Дополнительный параметр стиля CSS для всей таблицы. Например:
:: <code>style = margin-top: 1em;</code>

'''textstyle'''
: Дополнительный параметр стиля CSS для текстовой ячейки. Например:
:: <code>textstyle = font-size: 90%; text-align: center;</code>

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

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

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

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

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


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

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

<includeonly>
<!-- CATEGORIES HERE, THANKS -->
[[Категория:Шаблоны:Для шаблонов]]
</includeonly>