Ini adalah sebuah subhalamandokumentasi untuk Templat:Flagicon. Templat ini berisi informasi penggunaan, kategori dan konten lainnya yang bukan merupakan bagian dari templat halaman.
Templat ini digunakan pada sekitar70.000 halaman dan perubahannya kemungkinan memicu perubahan massal pada semua halaman yang menggunakannya. Uji cobalah di subhalaman /bak pasir atau /kasus uji Templat:Flagicon, atau subhalaman pengguna Anda. Pertimbangkan untuk mendiskusikan perubahan di halaman pembicaraan sebelum mengimplementasikannya.
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 MOS: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 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
variant2
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 logicbagaimana menampilkan data tersebut.
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).
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.
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}}
