Modulo:CountryFlags/man
Questa è la pagina di documentazione per Modulo:CountryFlags
Questo modulo converte i codici paese di due lettere (come IT, US) in emoji di bandiere nazionali (come 🇮🇹, 🇺🇸) e viceversa. Si basa sui simboli indicatori regionali Unicode che, quando combinati in coppie, vengono visualizzati come bandiere nazionali nella maggior parte dei browser e sistemi operativi moderni.
Istruzioni
La funzione toFlag accetta un codice paese di due lettere (non sensibile alle maiuscole) e restituisce l'emoji della bandiera corrispondente.
| Codice | Risultato |
|---|---|
{{#invoke: CountryFlags | toFlag | IT }} |
🇮🇹 |
{{#invoke: CountryFlags | toFlag | us }} |
🇺🇸 |
{{#invoke: CountryFlags | toFlag | JP }} |
🇯🇵 |
{{#invoke: CountryFlags | toFlag | de }} |
🇩🇪 |
{{#invoke: CountryFlags | toFlag | troppolungo }} |
Error: Input must be a 2-letter country code |
La funzione fromFlag accetta un'emoji di bandiera e restituisce il codice paese di due lettere corrispondente.
| Codice | Risultato |
|---|---|
{{#invoke: CountryFlags | fromFlag | 🇮🇹 }} |
IT |
{{#invoke: CountryFlags | fromFlag | 🇺🇸 }} |
US |
{{#invoke: CountryFlags | fromFlag | 🇯🇵 }} |
JP |
{{#invoke: CountryFlags | fromFlag | 🇩🇪 }} |
DE |
{{#invoke: CountryFlags | fromFlag | 💩 }} |
Error: Input is not a valid flag emoji |
Uso programmatico
Per utilizzare il modulo all'interno di altri moduli Lua, è possibile importarlo e utilizzare le funzioni getFlagEmoji e getCountryCode:
local flags = require('Module:CountryFlags')
local bandiera = flags.getFlagEmoji("IT") -- restituisce 🇮🇹
local codice = flags.getCountryCode("🇮🇹") -- restituisce IT
Note tecniche
Gli emoji delle bandiere funzionano combinando due simboli indicatori regionali Unicode (intervallo da U+1F1E6 a U+1F1FF). Questi simboli corrispondono alle 26 lettere dell'alfabeto latino, permettendo la rappresentazione di 676 possibili combinazioni di due lettere. Non tutte le combinazioni di due lettere rappresentano un paese esistente o riconosciuto, ma il modulo accetterà qualsiasi input di due lettere valido.
È importante notare che la visualizzazione delle emoji delle bandiere può variare a seconda del browser, del sistema operativo o del dispositivo utilizzato. Alcuni sistemi più vecchi potrebbero visualizzare i due simboli indicatori regionali separati invece dell'emoji della bandiera completa. Per ovviare parzialmente a questo problema, Pokémon Central Wiki implementa un polyfill che viene aggiunto all'HTML delle pagine unicamente su Windows e su browser basati su Chromium.