← Todas as regras

Alternativas textuais

iframes precisam de título

• Regra: frame-title
• Gravidade: Grave
• Nível WCAG A

Por que isso importa

Um quadro sem título é anunciado pela URL, ou simplesmente pulado. Tudo o que estiver embutido — um formulário de pagamento, um mapa, um vídeo — vira um buraco sem rótulo na página.

Como corrigir

1. Acrescente um atributo title descrevendo o conteúdo do quadro.
2. Em quadros puramente decorativos ou vazios, use title="" e aria-hidden="true".
3. Incorporações de terceiros também contam: o título vai no seu lado da marcação.

Na marcação

<iframe src="/payment"></iframe>

<iframe src="/payment" title="Payment form"></iframe>

A exigência por trás disso

Esta regra é uma das formas de falhar nos seguintes critérios de sucesso das WCAG 2.2. O W3C, que publica a norma, explica cada um deles:

• 4.1.2 Nome, função e valor (abre em nova aba) — Nível WCAG A

Para aprofundar

Deque University sobre frame-title (abre em nova aba)

A Deque mantém o axe-core, o motor de código aberto que o nosso scanner executa. A página deles documenta a regra como o motor a implementa.

Verificações automáticas encontram falhas que o navegador consegue comprovar. Elas não julgam se uma legenda está correta, se um texto alternativo é útil, nem se a página pode ser operada de ponta a ponta pelo teclado — isso exige uma pessoa.