Документація шаблону[перегляд] [редагувати] [історія] [очистити кеш]

Цей шаблон використовує Lua: Модуль:Flagg Модуль:CountryData

{{flagg}} (головний прапо р) це шаблон прапора з можливістю внесення змін. Шаблон використовує скрипти Lua замість стандартного механізму, що дозволяє змінити назву зображення та посилання на статтю, навіть коли не існує (без виклику ресурсомістких функцій парсера).

Шаблон не призначений для повної заміни будь-яких спеціалізованих шаблонів прапорів, який він може імітувати (див. нижче), але він може допомогти у випадках коли шаблон не існує або коли потрібні додаткові опції.

Псевдоніми (варіанти) для кожного параметра або значення подані в квадратних дужках.

Перший параметр - алфавітний код, який вказує вихідний формат. Перша літера відповідає за зображення, друга роздільник, а третя назва країни. Параметр не враховує регістр.

Якщо відсутня будь-яка позиція у значенні параметра або символ не відповідає опції, наведеній нижче, буде використано опцію, яка визначена поточною; наприклад, якщо перший параметр дорівнює i, i** або izz читати його будуть, як isc.

Зображення (перша літера)

Літера	Значення	Опис	Приклад
u	(unlinked)	Зображення без посилання (за замовченням).	{{flagg|uxx|Франція}} →
c	(country)	Зображення має посилання на країну/статтю.	{{flagg|cxx|Франція}} →
p [f]	(prefix/suffix)	Зображення має посилання на країну з текстом у префіксі і/або суфіксі (за замовченням "Прапор ..."), налаштувати можно параметрами |pref= та |suff= (див. нижче).	{{flagg|pxx|Франція}} →
i	(image page)	Зображення має посилання на сторінку опису файлу; треба використовувати для зображень, які потребують атрибутів при використанні.	{{flagg|ixx|Франція}} →
d	(data template)	Зображення має посилання на шаблон даних країни, використовується у обговореннях/документації. Автоматично додається redirect=no якщо посилання є редиректом.	{{flagg|dxx|Франція}} →
x	X mark	Зображення відсутнє. Якщо друга літера є будь-якою окрім x та o, буде використано порожнє прозоре зображенняan для збереження місця.	{{flagg|xnx|Франція}} →

Роздільник (друга літера)

Літера	Значення	Опис	Приклад
s	span box	Зображення прапору розміщено у ярлику <span> з фіксованою шириною, для розташування назв країн у вертикальному списку.	{{flagg|usu|Нігер}} → Нігер
n	non-breaking space	Нерозривний простір (& ) використовується, як і у більшості шаблонів, включаючи шаблон {{Прапорець}}. Зауважте, що у деяких браузерах роздільник &  може не працювати; використовуйте роздільник w, якщо це потрібно.	{{flagg|unu|Нігер}} →  Нігер
l	line break	Можно використовувати розрив рядка (<br/>) для перенесення тексту.	{{flagg|ulu|Нігер}} → Нігер
t	table cell	Можно використовувати для створення таблиці.		Нігер
x	X mark	Заборона використання роздільника.	{{flagg|uxu|Нігер}} → Нігер

Назва (третя літера)

Можно використати деякі додаткові опції використавши наступні літери у коді у будь-якому порядку:

Літера	Опис	Приклад
a	Додає назву країни (параметр "назва" або або якщо не зазначено другий параметр) у якості alt альтернативного тексту і при наведенні миші на зображення. Якщо використано параметр |alt=, нема потреби його повторювати.	{{flagg|uxxa|Пакистан}} →
e	Використовує назву країни яка визначена в шаблоні даних країни так само, як у шаблоні {{Країна з прапорцем}}.	{{flagg|unue|PAK}} →  Пакистан
o	Прибирає пропуск зображення та пробіл у разі, якщо зображення є невидимим, тобто пробіл використовується лише коли є прапор. Корисно для вбудованого/автономного використання або для горизонтальних списків, де вирівнювання назв не потрібно.	{{flagg|unuo|Пакистан|image=}} → Пакистан У порівнянні: {{flagg|unu|Пакистан|image=}} →  Пакистан
r	Міняє місцями елементи, розташовує зображення за назвою; схоже на шаблон {{flagright}}. Не впливає на порядок букв у коді формату.	{{flagg|uncr|Пакистан}} → Пакистан
w	Уникає обтікання, додаючи ... .	{{flagg|unuw|Пакистан}} →  Пакистан

Другий параметр це країна або назва об'єкту. Шаблон намагається зчитати прапор та посилання з "Шаблон:Дані країни країна"; якщо його не існує, за замовченням буде використано такий самий параметр, як і поточне посилання на країну. Параметр також визначає поточну назву країну, що буде відображатися, якщо опція e не використовується.

|variant= [третій безіменний параметр]

Визначає варіанти зображення, які зазначені в документації по кожному шаблону. Наприклад, шаблон {{flagg|ixx|Німеччина|ВМС}} → використовує "ВМС" варіант з шаблону Шаблон:Дані країни Німеччина.

|image=

Назва файлу зображення, з або без префіксу "Файл:". Можно використовувати коли відсутній потрібний варіант зображення або коли відсутній шаблон даних. Оберіть "none" ["blank", порожній рядок] щоб використати прозоре зображення без посилання (функціонально схоже на формат x).

|size= [|sz=]

Налаштування розміру зображення; поточний розмір становить 23×15 пікселів (більший для деяких шаблонів). Можно використовувати певний розмір у пікселях (наприклад, 30x20px; суфікс "px" можно не використовувати) або один з розмірів "xs" (половина від поточного розміру), "s", "m", "l" та "xl" (вдвічі більше від поточного розміру).

|border=

За замовченням значок прапору має кордони, окрім тих випадків коли в шаблоні відключено цей параметр. Опція |border= може позначатися, як "yes" ["y", "1"] для примусового включення кордонів, якщо вони вимкнені або "no" ["n", "0", порожній рядок] для вимикання.

|align= [|al=]

Оберіть одну з наступних опцій: "left" ["l"], "center" ["centre", "c", "middle", "m"] або "right" ["r"], для розташування зображення при використання параметру span box (s) або при створенні таблиці (t). У таблиці t, за замовченням зображення розташовано в центрі; у форматі s, воно розташовано праворуч при використанні опції r, у іншому випадку ліворуч.

|width= [|w=]

Встановлення ширини прямокутника, який оточує зображення при використання формату span box (s), у пікселях, без суфіксу "px". Розмір обчислюється в Module:Flaglist/size і залежить від розміру зображення.

|alt=

Опція додає альтернативний текст та текст який з'являється при наведенні курсору на зображення, якщо це для інформації, а не просто для прикраси. Якщо потрібний текст співпадає з назвою зображення використовуйте опцію a.

|ilink=

Замінює посилання на зображення (використовувати лише у тому випадку, якщо жоден із наведених вище форматів зображень не дозволяє створити посилання на потрібну сторінку)

|name=

Змінює відображену назву країни. Зверніть увагу, що у форматі f, опція має префікс і/або суфікс.

|clink= [|link=]

Перезаписує посилання на статтю країни; також використовується для створення посилання у префіксі/суфіксі в опціях f, p та b.

|pref=, |suff=, |plink=

|pref= та |suff= визначають префікс та суфікс для використання посилань у префіксах/суфіксах (формати f, p та b). За замовченням, якщо не зазначено жодних опцій, префіксом є "Прапор" (cf. {{flagof}}), а суфікс відсутній. |plink= можно використовувати для перезапису комбінованого посилання.

|section=

Посилання на розділ пов'язаної статті без відображення назви розділу. При використання посилання на країну та посиланні у префіксі/суфіксі, використовуйте |csection= для розділу статті про країну та |psection= для розділу статті у префіксі/суфіксі.

|altvar= [|avar=], |age=

Дозволяє використовувати один варіант із набору стандартних суфіксів для зв’язку зі спортивними командами та військовими. Дані для altvar суфіксу завантажуються з Module:Flagg/Altvar data. Можливими значеннями параметрів є базові імена відповідних спеціалізованих шаблонів. Для молодіжних команд у деяких видах спорту, вікове обмеження треба визначати параметром |age=.

|nalign= [|nal=]

Визначає розташування тексту у таблиці при використанні формату (t). За замовченням текст розташовується ліворуч; варіанти такі самі як і в параметрі |align=.

|text=

Заміняє поточний текст; треба використовувати лише для нестандартних форматів. Також ви можете встановити третю літеру у параметрах формату, як x (без тексту) та додати свій текст за межами шаблону.

Формати:

• {{flagg|usc|Фіджі}} → Фіджі (поточний формат)
• {{flagg||Фіджі}} → Фіджі (поточний формат
• {{flagg|pnbr|Фіджі}} → Прапор Фіджі 
• <span style="display:inline-block;text-align:center;">{{flagg|ilf|Фіджі|sz=xl}}</span> →
  Прапор Фіджі

Формат таблиці і положення:

{{flagg|utu|Ямайка}}		Ямайка
{{flagg|utur|Ямайка}}	Ямайка
{{flagg|utu|Ямайка|al=l|nal=l}}		Ямайка
{{flagg|utu|Ямайка|al=c|nal=c}}		Ямайка
{{flagg|utu|Ямайка|al=r|nal=r}}		Ямайка

• {{flagg|usu|Швейцарія}} → Швейцарія
• {{flagg|usu|Швейцарія|al=l}} → Швейцарія
• {{flagg|usu|Швейцарія|al=c}} → Швейцарія
• {{flagg|usu|Швейцарія|al=r}} → Швейцарія

Стандартні параметри зображення та імені:

• {{flagg|isc|М'янма}} → М'янма
• {{flagg|isc|М'янма|border=}} → М'янма
• {{flagg|isc|М'янма|1974}} → М'янма
• {{flagg|isc|М'янма|варіант=1974}} → М'янма
• {{flagg|isc|М'янма|варіант=1974|назва=Бирма}} → М'янма
• {{flagg|isc|Бірма|варіант=1974}} → Бірма
• {{flagg|isc|М'янма|sz=30}} → М'янма
• {{flagg|isc|М'янма|розмір=30}} → М'янма
• {{flagg|isc|М'янма|розмір=30px}} → М'янма
• {{flagg|isc|М'янма|розмір=30x18px}} → М'янма
• {{flagg|isc|М'янма|розмір=xs}} → М'янма
• {{flagg|isc|М'янма|розмір=xl}} → М'янма
• {{flagg|isc|М'янма|width=30|sрозмірze=xs}} → М'янма
• {{flagg|isc|М'янма|image=}} → М'янма
• {{flagg|isc|М'янма|image=Flag of None.svg}} → М'янма
• {{flagg|isc|М'янма|image=File:Flag of None.svg}} → М'янма

Посилання та альтернативні варіанти:

• {{flagg|psp|Єгипет}} → Єгипет
• {{flagg|psf|Єгипет}} → Прапор Єгипет
• {{flagg|psb|Єгипет}} → Прапор Єгипет
• {{flagg|psb|Філіппіни|the=1}} → Прапор the Філіппіни
• {{flagg|csc|Єгипет|section=Історія}} → Єгипет
• {{flagg|csb|Єгипет|csection=Історія}} → Прапор Єгипет
• {{flagg|psb|Єгипет|варіант=1922|psection=Королівство Єгипет (1922–1953)}} → Прапор Єгипет
• {{flagg|psb|Єгипет|plink=Перелік Єгипетських прапорів}} → Прапор Єгипет
• {{flagg|psf|Єгипет|pref=Історія}} → Історія Єгипет
• {{flagg|psp|Єгипет|suff=на Олімпійських іграх}} → Єгипет
• {{flagg|psp|Єгипет|avar=fb}} → Єгипет
• {{flagg|psp|Єгипет|avar=football}} → Єгипет
• {{flagg|psp|Єгипет|avar=fbu|age=20}} → Єгипет
• {{flagg|psf|Єгипет|avar=ВМФ}} → Єгипет ВМФ

Не існуючі шаблони даних:

• {{flagg|isc|Белфаст}} → Белфаст
• {{flagg|isc|Белфаст|image=Flag of Belfast.svg}} → Белфаст

Ці "спеціалізовані" шаблони передують шаблону Flagg, і через те, що більшість не має посилань і зображень, вони, ймовірно, швидші тому що вони роблять два виклики не викороистовуючи Lua.

Шаблон	Відповідний {{flagg}} синтаксис	Приклад
{{flag|країна}}	{{flagg|unc|країна}}	{{flag|Китай}} → {{flagg|unc|Китай}} →  Китай
{{flagbig|країна}}	{{flagg|ulc|країна|sz=l}}	{{flagbig|Китай}} → Китай {{flagg|ulc|Китай|sz=l}} → Китай
{{flagc|країна}}	{{flagg|inc|країна}}	{{flagc|Китай}} →  Китай {{flagg|inc|Китай}} →  Китай
{{Країна з прапорцем|країна}}	{{flagg|unce|країна}}	{{Країна з прапорцем|CHN}} →  КНР {{flagg|unce|CHN}} →  Китай
{{ПрапорДеко|країна}}	{{flagg|uxx|країна}}	{{ПрапорДеко|Китай}} → {{flagg|uxx|Китай}} →
{{ПрапорЗначок|країна}}	{{flagg|cxx|країна}}	{{ПрапорЗначок|Китай}} → {{flagg|cxx|Китай}} →
{{flagicon image|image}}	{{flagg|uxx|image=image}}	{{flagicon image|Flag of China.svg}} → {{flagg|uxx|image=Flag of China.svg}} →
{{Прапорпосилання|країна|suffix}}	{{flagg|unp|країна|suff=suffix}}	{{Прапорпосилання|Китай|на Кубку Хопмана}} →  Китай {{flagg|unp|Китай|suff=на Кубку Хопмана}} →  Китай
{{flag+link|prefix|країна}}	{{flagg|unp|країна|pref=prefix}} (перевірка існування)	{{flag+link|Сільське господарство у|Китай}} → Китай {{flagg|unp|Китай|pref=Сільське господарство у}} →  Китай
{{flaglist|країна}}	{{flagg|usc|країна}}	{{flaglist|Китай}} → Китай {{flagg|usc|Китай}} → Китай
{{flagof|країна}}	{{flagg|unp|країна|sz=l}}	{{flagof|Китай}} →  Китай {{flagg|unp|Китай|sz=l}} →  Китай
{{flagright|країна}}	{{flagg|uncr|країна}}	{{flagright|Китай}} → Китай  {{flagg|uncr|Китай}} → Китай
{{ПрапорБП|країна}}	{{flagg|unu|країна}}	{{ПрапорБП|Китай}} →  Китай {{flagg|unu|Китай}} →  Китай
{{noflag|країна}}	{{flagg|xnu|країна}}	{{noflag|Китай}} →  Китай {{flagg|xnu|Китай}} →  Китай
{{noflag|[[країна]]}}	{{flagg|xnc|країна}}	{{noflag|[[Китай]]}} →  Китай {{flagg|xnc|Китай}} →  Китай

Тут використано футбольні шаблони; інші види спорту мають власні шаблони.

Шаблон	Відповідний {{flagg}} синтаксис	Приклад
{{fb|країна}}	{{flagg|unpe|країна|avar=fb}}	{{fb|Китай}} →  КНР {{flagg|unpe|Китай|avar=fb}} →  Китай
{{fb|країна|align=1}}	{{flagg|uspe|країна|avar=fb|al=c}}	{{fb|Китай|align=1}} →  КНР {{flagg|uspe|Китай|avar=fb|al=c}} → Китай
{{fb-big|країна}}	{{flagg|ulpe|країна|avar=fb|sz=l}}	{{fb-big|Китай}} → КНР {{flagg|ulpe|Китай|avar=fb|sz=l}} → Китай
{{fb-rt|країна}}	{{flagg|unpre|країна|avar=fb}}	{{fb-rt|Китай}} → КНР  {{flagg|unpre|Китай|avar=fb}} → Китай
{{fbu|age|країна}}	{{flagg|unpe|країна|avar=fbu|age=age}}	{{fbu|17|Китай}} →  КНР {{flagg|unpe|Китай|avar=fbu|age=17}} →  Китай
{{fbw|країна}}	{{flagg|unpe|країна|avar=fbw}}	{{fbw|Китай}} →  КНР {{flagg|unpe|Китай|avar=fbw}} →  Китай
{{fbwu|age|країна}}	{{flagg|unpe|країна|avar=fbwu|age=age}}	{{fbwu|17|Китай}} →  КНР {{flagg|unpe|Китай|avar=fbwu|age=17}} →  Китай
{{армія|країна}}	{{flagg|unfe|країна|avar=армія}} (немає автоматично перевизначення назви)	{{армія|Китай}} →  Сухопутні війська Китайської Народної Республіки {{flagg|unfe|Китай|avar=армія}} →  Китай армія
{{Флот|країна}}	{{flagg|unfe|країна|avar=ВМФ}} (немає автоматично перевизначення назви)	{{флот|Китай}} →  Військово-морські сили Китайської Народної Республіки {{flagg|unfe|Китай|avar=ВМФ}} →  Китай ВМФ
{{ВПС|країна}}	{{flagg|unfe|країна|avar=ВПС}} (немає автоматично перевизначення назви)	{{ВПС|Китай}} →  Повітряні сили Китайської Народної Республіки {{flagg|unfe|Китай|avar=ВПС}} →  Китай ВПС

• User:SiBr₄/Flagg tests — extensive tests of the template's functions, which may also serve as additional examples