Шаблон:Fmbox/документація

Меташаблони контейнерів повідомлень
шаблон	контекст
{{Ambox}}	стаття
{{Cmbox}}	категорія
{{Imbox}}	зображення
{{Tmbox}}	обговорення
{{Fmbox}}	верхній/нижній колонтитул
{{Ombox}}	інші сторінки
{{Mbox}}	автовизначення
{{Asbox}}	стаб статті
{{Dmbox}}	неоднозначність

Це меташаблон {{Fmbox}} (англ. [F]ooter and header [m]essage [box]).

Він може використовуватися для побудови контейнерів повідомлень для системних повідомлень, таких як MediaWiki:Sp-contributions-footer-anon. Його також можна використовувати для полів нижнього та верхнього колонтитулів на сторінках користувача та для повідомленнь редагування.

Цей шаблон працює подібно до {{Ambox}} і в основному використовує однакові параметри. Основні відмінності полягають у тому, що цей контейнер має 100% ширину та різні стилі кольорів.

Використання

Простий приклад

{{Fmbox |text=Деякий текст.}}

утворює:

Складний приклад

{{Fmbox
 | type = editnotice
 | image = [[File:Emblem-question-yellow.svg|40px]]
 | style = border:1px solid #f4c430;
 | textstyle = font-style:italic; font-weight:bold; color:red;
 | text = Текст повідомлення.
}}

утворює:

Типи вікон повідомлень нижнього та верхнього колонтитулів

У наступних прикладах використовуються різні параметри type але без параметрів зображення, тобто вони використовують зображення за замовчуванням для кожного типу.

Нестандартні зображення

Зображення за замовчуванням, показані вище, здебільшого призначені для тестування та демонстрації. У більшості випадків доцільніше використовувати більш конкретне зображення або не використовувати зображення взагалі. У наступних прикладах використовується параметр image для використання зображення, відмінного від стандартного.

Параметри

Перелік усіх параметрів:

{{fmbox
| name = назва шаблона
| type  = system / editnotice / warning
| image = none / [[Файл:Some image.svg|40px]]
| imageright = [[Файл:Some image.svg|40px]]
| id = CSS id
| class = назва класу CSS
| style = значення CSS
| textstyle = значення CSS
| plainlinks  = no
| text  = Тіло тексту повідомлення.
}}

name

(Необов'язковий) Назва шаблону. Це додає клас CSS із назвою box-name до елемента HTML для використання ботами або скриптами.

type

Якщо параметр type не задано шаблон приймає значення типу system. Це означає, що він отримує світло-сірий фон.

image

Без параметра = Якщо параметр image не задано шаблон використовує стандартне зображення. Яке стандартне зображення використовується, залежить від параметра type.

Зображення = Має бути зображення зі звичайною вікі-нотацією. 40px - 50px ширини зазвичай задовольняє залежно від співвідношення висоти та ширини зображення. (Але вікно повідомлень може обробляти зображення будь-якого розміру.) Наприклад:

image = [[Файл:User-info.svg|40px]]

none = Означає, що зображення не використовується.

imageright

Без параметра = Якщо параметр imageright не задано, тоді зображення показується з правого боку.

Зображення = Має бути зображення зі звичайною вікі-нотацією. 40px - 50px ширини зазвичай задовольняє залежно від співвідношення висоти та ширини зображення. (Але вікно повідомлень може обробляти зображення будь-якого розміру.) Наприклад:

imageright = [[Файл:Nuvola apps bookcase.png|40px]]

Будь-що = Будь-який інший об’єкт, який ви хочете показати праворуч.

id

Необов'язковий CSS id який використовується для всього контейнера повідомлень. Без лапок " ". Здебільшого призначений для позначення назви вікна повідомлення, щоб було легко виявити наявність повідомлення з javascript. Наприклад MediaWiki:Sp-contributions-footer буде використовувати:

id = sp-contributions-footer

class

Необов'язкове ім'я класу CSS який використовується для всього контейнеру повідомлення. Без лапок " ". Здебільшого призначений для позначення назви вікна повідомлення, щоб його можна було окремо скинути. Наприклад MediaWiki:Sp-contributions-footer буде використовувати:

class = sp-contributions-footer

style

Необов'язкове значення CSS яке використовується для всього контейнера повідомлення. Без лапок " " але з кінцевою крапкою з комою ;. Наприклад:

style = margin-top: 1em;

textstyle

Необов'язкове значення CSS яке використовується для комірки тексту. Наприклад:

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

plainlinks

Зазвичай у Вікіпедії зовнішні посилання мають значок стрілки поруч із собою, як тут: Example.com. Однак у вікнах повідомлень піктограма стрілки не відображається за замовчуванням, як тут: Example.com. Щоб отримати звичайний стиль зовнішнього посилання зі значком стрілки, використовуйте |plainlinks=no.

text

Основний текст повідомлення.

Технічні подробиці

Цей шаблон наразі використовує жорстко закодовані стилі та назви класів. Пізніше він використовуватиме лише класи CSS, що полегшить створення скінів. (Тим часом його можна очистити за допомогою ключа "!important".)

Якщо вам потрібно створити контейнер, який буде меншим за 100% ширини, не використовуйте цей шаблон; натомість, використовуйте {{Ombox}}. Оскільки цей контейнер не має коду "1px empty image cell" це робить так, що інші mboxes отримують кращий процесинг контейнера в усіх браузерах з меншою за 100% шириною.

Якщо вам потрібно використати спеціальні символи у параметрі text, тоді вам потрібно "уникати" їх як показано нижче:

{{Fmbox
| text = <div>
Знак рівності = та дужки початку та кінця { } чудово працюють і так. 
Але якщо використовувати {{!}} та дві дужки закінчення <nowiki>}}</nowiki>. 
А тепер пайп і дужки закінчення <nowiki>|}}</nowiki>.
</div>
}}

Це утворює:

Щоб уникнути потенційних труднощів, напр. парсерні функції або спеціальні символи, цей меташаблон використовує HTML замість вікірозмітки щоб створити таблицю з її виводом.

Оскільки деякі старіші веб-переглядачі мають проблеми з відтворенням прозорості SVG, зображення за замовчуванням для цього меташаблону мають формат PNG, а не SVG, і їх було оптимізовано вручну, щоб забезпечити їх роботу в широкому діапазоні та вікових версіях браузерів. (Піктограми SVG виглядають дещо погано лише в старих браузерах, тому така оптимізація доцільна лише для дуже широко використовуваних піктограм.)

Адміни: у MediaWiki's парсинг та конвертація HTML розмітки для системних повідомлень не така як на звичайних сторінках: <br> наприклад, не конвертується автоматично у <br /> та не має автоматичного додавання тегів </td> та </tr>. Тому будь-який HTML код використовуваний у системних повідомленнях вже має бути дійсним (включати всі додаткові теги закриття, і т.д.).

Задля більших подробиць, див. сторінку обговорення. Оскільки цей шаблон працює майже так само, як {{Ambox}}, {{Tmbox}}, {{Imbox}}, {{Cmbox}} та {{Ombox}}, додаткова інформація, знайдена на їхніх сторінках обговорення, також може бути актуальною.

Див. також

• {{Fmbox warning ruler}}, горизонтальна лінійка, яка використовується в деяких системних попередженнях і використовує той самий червоний колір, що й тип warning цього шаблону.

До сімейства меташаблонів Модуль:Message box входить сім шаблонів:

• {{Ambox}}, для контейнерів повідомлень на сторінках статей.
• {{Cmbox}}, для контейнерів повідомлень на сторінках категорій.
• {{Imbox}}, для контейнерів повідомлень на сторінках файлів (зображень).
• {{Tmbox}}, для контейнерів повідомлень на сторінках обговорень.
• {{Fmbox}}, для контейнерів повідомлень у верхньому/нижньому колонтитулі сторінки.
• {{Ombox}}, для контейнерів повідомлень на сторінках інших типів.
• {{Mbox}}, для контейнерів повідомлень, що використовуються у різних просторах назв та змінюють свій вигляд відповідно.

Тісно пов'язані меташаблони:

• {{Asbox}}, для контейнерів повідомлень на сторінках стабів статей.
• {{Dmbox}}, для контейнерів повідомлень на сторінках неоднозначностей або визначеного індексу.
• {{Ivmbox}}, простий контейнер, повної ширини, із заданим фоном кольору слонової кістки, призначений для оформлення важливих повідомлень або нагадувань.