Elementi RP e RT

Silktide esamina le annotazioni ruby, i piccoli suggerimenti sulla pronuncia scritti sopra il testo dell'Asia orientale, e segnala quelli privi degli elementi che contengono la pronuncia o forniscono un'alternativa per i browser meno recenti.

Le annotazioni ruby vengono scritte con l'elemento HTML <ruby>. Al suo interno, <rt> contiene il testo della pronuncia e <rp> contiene le parentesi dell'alternativa visualizzate dai browser che non supportano ruby.

<!-- Problema: manca la pronuncia (<rt>) o l'alternativa (<rp>) -->
<ruby>漢字</ruby>

<!-- Correzione: pronuncia più parentesi dell'alternativa -->
<ruby>漢字<rp>(</rp><rt>kanji</rt><rp>)</rp></ruby>

Perché è importante

Le annotazioni ruby servono a indicare ai lettori come pronunciare i caratteri, una funzione essenziale per lingue come il giapponese, in cui gli stessi caratteri possono essere letti in diversi modi, e utile per chi sta ancora imparando a leggerli. Un elemento <ruby> senza <rt> non comunica alcuna pronuncia e, senza <rp>, un visitatore che utilizza un browser privo di supporto per ruby vede l'annotazione fondersi con il testo circostante in un insieme illeggibile.

Questo supporta il criterio di successo 3.1.6 di WCAG (Pronuncia), un requisito di Livello AAA.

Come correggere il problema

1. Aggiungi un elemento <rt> all'interno di ogni <ruby> segnalato, contenente il testo della pronuncia o dell'annotazione.
2. Racchiudi l'annotazione in elementi <rp> contenenti parentesi di apertura e chiusura, in modo che i browser senza supporto per ruby mostrino qualcosa di leggibile.

Come Silktide esegue il controllo

1. Individua ogni elemento <ruby> nella pagina, ignorando gli elementi che hai escluso dai controlli.
2. Segnala l'elemento se non contiene alcun discendente <rt>.
3. Segnala separatamente l'elemento se non contiene alcun discendente <rp>.

Per saperne di più

• Understanding Pronunciation (WCAG 3.1.6)
• The ruby element (MDN)