Templat:Flagicon/doc

Templat ini menampilkan bendera dari parameter yang diinput dalam ukuran "icon", 22x20 pixel ditambah garis pinggir satu pixel. Gambarnya juga memiliki alt attribute (biasanya "Flag of name"), yang ditampilkan oleh penjelajah web ketika pointer mouse berada di atas gambar, atau diinterpretasikan oleh perangkat lunak screen reader dan penjelajah web ketika gambar diatur untuk tidak ditampilkan.

Harap baca dan cermati WP:BENDERA sebelum menggunakan templat ini!

Penggunaan

{{flagicon|name|variant=|size=|noredlink=}}

nama: Parameter pertama ini wajib, dan mengidentifikasi nama dari negara, wilayah, kota, dll. Daftar lengkap parameter yang tersedia dapat dilihat pada Kategori:Templat data negara. Sebagai contoh, Templat:Country data Polandia digunakan ketika parameter name diisi dengan Polandia. Beberapa bendera juga tersedia dengan "alias" singkatan, seperti kode negara tiga-huruf ISO 3166-1 alpha-3, IOC, atau FIFA. Daftar "alias" untuk setiap negara dicantumkan di halaman templat terkait. Kode negara ini dapat berubah-ubah, sehingga disarankan untuk menggunakan nama lengkap saja.
varian: Parameter kedua ini opsional, dan mengidentifikasi jenis bendera yang akan ditampilkan selain bendera standar. Paling sering digunakan untuk menampilkan bendera masa lalu tetapi juga dapat digunakan untuk bendera angkatan laut, bendera untuk olahraga (apabila berbeda), dll. Daftar variant untuk setiap negara dicantumkan di halaman templat terkait. Sebagai contoh, dalam Templat:Country data Polandia tersedia berbagai jenis bendera yang berbeda-beda untuk Polandia. Parameter ini dapat berupa parameter nama (seperti "variant=1815"), atau parameter posisional, selalu setelah nama negara.
size: Parameter ini juga opsional, dan digunakan untuk mengatur lebar dan/atau tinggi maksimum gambar bendera. Parameter ini dijelaskan menggunakan sintaks gambar standar.

Templat data

Ini dokumennya TemplateData untuk template ini digunakan oleh VisualEditor dan alat lainnya; lihat laporan penggunaan parameter bulanan untuk templat ini.

TemplateData untuk Flagicon

Templat ini menampilkan bendera wikilink dari parameter bernama dalam ukuran 'ikon', saat ini 23×15 piksel (ditentukan dalam Templat: Ikon bendera/inti) ditambah batas satu piksel.

Parameter templat
Parameter		Keterangan	Jenis	Status
Nama	`1`	Nama negara, wilayah, kota, dll.; nama lengkap direkomendasikan untuk negara	Kata	wajib diisi
Varian	`variant` `2`	Mengidentifikasi varian bendera untuk digunakan sebagai pengganti bendera standar, mis. 1815	Kata	opsional
Dimensi maksimum	`size`	Lebar atau tinggi maksimum, ditentukan melalui 'sintaks gambar diperpanjang' standar' (e.g. x30px)	Kata	opsional
No redlink	`noredlink`	Jika disetel ke nilai apa pun yang dievaluasi sebagai benar (yaitu '1', 'true', 'yes', atau 'y'), ini tidak menampilkan apa pun jika file data negara tidak ada. (Defaultnya adalah menampilkan redlink)	Kata	opsional

Contoh

Markup wiki	Tampilan	Catatan
`{{flagicon\|Polandia}}`
`{{flagicon\|POL}}`		Menggunakan kode negara ISO/IOC/FIFA
`{{flagicon\|Polandia\|1815}}`		Menampilan jenis bendera yang berbeda
`{{flagicon\|Polandia\|variant=1815}}`
`{{flagicon\|POL\|naval}}`		Menampilkan lambang angkatan laut
`{{flagicon\|POL\|air force}}`		Menampilkan bendera angkatan udara
`{{flagicon\|Polandia\|size=50px}}`		Mengatur lebar 50 pixel
`{{flagicon\|POL\|naval\|size=999x30px}}`		Mengatur tinggi 30 pixel

Implementasi

Templat ini menggunakan templat data yang ada di Kategori:Templat data negara, yang mengandung data apa yang akan ditampilkan, dan pemformat Templat:Country flagicon2, yang mengandung logic bagaimana menampilkan data tersebut.

{{flagicon|Polandia}} → — menggunakan Templat:Country data Polandia
{{flagicon|POL}} → — menggunakan Templat:Country data POL, yang merupakan halaman pengalihan ke Templat:Country data Polandia

Dalam setiap templat data negara, templat ini menggunakan paramater-parameter beikut:

flag alias — nama berkas gambar yang akan ditampilkan
flag alias-xxxx — nama berkas gambar varian bendera xxxx
alias — digunakan untuk menampilkan alt attribute dari gambar (standar: "Flag of alias")

Kategori pelacakan

Kategori:Halaman yang menggunakan templat flagicon dengan parameter yang tidak diketahui (0)

Di mana {{Flagicon|Foo}} digunakan, tetapi Templat:Country data Foo tidak ada, kemudian redlink ditampilkan, kecuali parameter |noredlink=yes telah disetel. Di mana redlink ditampilkan, halaman ditambahkan ke kategori pelacakan: * Kategori:Bendera dengan templat data negara tidak ada (populasi:0)

Templat terkait

Templat:Flag digunakan untuk menampilkan teks berpranala-wiki di sebelah bendera. Teks yang ditampilkan akan sama dengan parameter yang digunakan, tetapi pranala tetap tertuju ke artikel negara yang bersangkutan (dalam contoh ini, Polandia).
- {{flag|Polandia}} → Polandia
- {{flag|POL}} → POL
Templat:Flagcountry juga digunakan untuk menampilkan teks berpranala-wiki di sebelah bendera. Teks yang ditampilkan akan selalu sama, tanpa melihat apakah nama atau kode negara yang digunakan sebagai paramater.
- {{flagcountry|Polandia}} → Polandia
- {{flagcountry|POL}} → Polandia

Alternatif untuk menghindari Pasca-perluasan termasuk ukuran batas Wikipedia

Halaman dengan banyak ikon bendera mungkin mendekati atau melebihi batas Pasca perluasan termasuk ukuran Wikipedia. Dalam kasus ini, pertimbangkan untuk menggunakan modul atau templat module-wrapper sebagai gantinya:

{{flagg}} adalah pembungkus sederhana untuk Modul:Flagg: Untuk penggunaan dasar, {{flagicon|country}} bisa diganti dengan {{flaggi>cxxloi>negara}}