localizzazione
Controlla o imposta il layout di un progetto perché regga testi tradotti più lunghi, l'orientamento RTL, l'ordine di lettura e lo zoom. Non modifica file. Si lancia solo su richiesta.
SKILL.mdplugins/kit/skills/localizzazione/SKILL.md
GitHubLayout e localizzazione
Rispondi in italiano. Una sola domanda per messaggio.
Questa skill verifica o imposta il layout perché tenga con le lingue supportate dal progetto (in CLAUDE.md, voce «Lingue supportate»). La localizzazione (chiavi di traduzione, lingua di default) e le date stanno in frontend.md §4.2 e §4.3: qui si applica la procedura di layout.
- Leggi il layout dei componenti principali e le chiavi di traduzione. Se le lingue supportate non sono chiare, chiedi una sola domanda prima di continuare.
- Raggruppa con lo spazio più che con linee divisorie. Le linee servono solo dove lo spazio non basta a distinguere due gruppi.
- Tieni distinti i controlli dal contenuto: un controllo ha un contorno o uno sfondo riconoscibile anche senza bordo visibile, e il contorno rispetta il contrasto di
colori-tema(WCAG 2.2, 1.4.11). - Allinea gli elementi a bordi condivisi: stesso margine sinistro (o di inizio, in RTL) per titolo, testo e campi di una stessa colonna.
- Per gli elementi che si specchiano in RTL usa proprietà logiche (
margin-inline,padding-block,inset-inline-start) al posto di quelle fisiche (left,right). Verifica l'attributodirsul documento e l'attributolangsul contenuto tradotto. - Ordine di lettura: il DOM segue l'ordine visivo, anche in RTL e dopo un reflow (WCAG 2.2, 1.3.2). Un ordine visivo ottenuto solo con CSS è una segnalazione.
- Testo che si espande: ogni etichetta, pulsante e titolo ha spazio per una traduzione più lunga. Il testo che può superare lo spazio va a capo oppure viene troncato con una via d'uscita (tooltip, pagina di dettaglio), mai tagliato senza modo di leggerlo.
- Reflow: il contenuto si legge a 320 px di larghezza senza scorrimento orizzontale, e a zoom del 200% senza perdita di contenuto (WCAG 2.2, 1.4.10 e 1.4.4).
- Contenuto nascosto (pannelli, menu, sezioni espandibili): lo stato è dichiarato (aperto o chiuso) e c'è sempre un controllo per aprirlo (WCAG 2.2, 4.1.2).
- Crescita: nessuna altezza fissa per blocchi di testo; i contenitori crescono con il contenuto (
min-height,max-width, nonheightsu testi). - Chiudi con l'elenco dei componenti controllati e, per ciascuno, il problema trovato o «ok». Le modifiche al codice non si fanno da questa skill: si propongono, e si applicano con una richiesta separata.
Riferimenti: frontend.md §4.2 e §4.3; WCAG 2.2, criteri 1.3.2, 1.4.4, 1.4.10, 1.4.11 e 4.1.2.