Formação

Um curso ao seu ritmo para uma equipa que adota o Lily: oito módulos, cada um com um objetivo, algo para ler, um exercício num navegador real e uma autoavaliação com respostas. Cerca de um dia ao todo; um módulo por sessão funciona bem.

Antes de começar

Escolha um tutorial de framework e conclua-o primeiro. Execute uma das aplicações de exemplo localmente, ou use as páginas de componentes deste site, para os exercícios. Precisa de um teclado e, para o módulo 8, de um leitor de tela: VoiceOver no macOS e iOS, NVDA no Windows ou TalkBack no Android, todos gratuitos.

Módulo 1 — O que significa headless

Objetivo: saber o que o Lily decide e o que você decide.

Leia: a página Sobre, e uma página de componente, como Button, do início ao fim.

Faça: apresente um Button e um TextInput sem folha de estilos. Depois ligue um tema, e outro. Anote o que mudou e o que não mudou.

Autoavaliação: o que um componente Lily nunca traz? O que traz sempre?

Nunca: CSS, tipos de letra, ícones ou imagens (exceto os ícones dos seletores), texto em inglês, obtenção de dados, idioma ou moeda por omissão. Sempre: o elemento HTML mais específico, a sua classe em kebab-case primeiro, ARIA onde o HTML não chega, comportamento de teclado e os seus outros atributos transmitidos.

Autoavaliação: quer uma borda vermelha num botão. Onde a coloca?

No seu CSS, na classe (.button) ou numa classe que acrescente. Nunca no componente.

Módulo 2 — Teclado e foco

Objetivo: usar e testar cada componente sem rato.

Leia: a tabela de interações de teclado de TabBar, Listbox e Dialog.

Faça: desligue o rato. Em cada uma dessas três páginas, chegue à demonstração com Tab e faça tudo o que a tabela lista. Abra a caixa de diálogo, prima Escapee repare onde fica o foco.

Autoavaliação: porque é que uma barra de separadores ocupa uma só paragem de Tab e não uma por separador?

O padrão composto da APG: Tab move entre widgets e as setas movem dentro de um (um índice de tabulação itinerante). Uma barra com dez paragens obriga quem usa o teclado a premir Tab dez vezes para a passar.

Autoavaliação: depois de fechar uma caixa de diálogo modal, onde deve estar o foco?

No controlo que a abriu. As caixas de diálogo modais do Lily usam showModal(), que também mantém Tab dentro da caixa enquanto está aberta.

Módulo 3 — Nomes, papéis e estados

Objetivo: dar a cada controlo um nome que um leitor de tela possa dizer, com as suas palavras.

Leia: a secção ARIA de IconButton e SwitchButton.

Faça: na sua própria aplicação, com o servidor de desenvolvimento, apresente um IconButton sem o seu label. Abra a consola do navegador: o Lily avisa que o controlo não tem nome acessível. Acrescente o rótulo e verifique que o aviso desaparece. (Os avisos só existem numa compilação de desenvolvimento, por isso uma página de produção, como este site, fica em silêncio.)

Autoavaliação: quando usar aria-labele quando texto visível?

Texto visível sempre que puder: todos o veem e quem usa entrada por voz pode dizê-lo. aria-label só onde não há texto visível, como num ícone. Se existirem ambos, o nome tem de conter as palavras visíveis (WCAG 2.5.3).

Autoavaliação: um estado mostrado só a vermelho. O que falta?

Texto. A cor pode repetir um significado mas nunca transmiti-lo sozinha (WCAG 1.4.1); o estado precisa de palavras.

Módulo 4 — Formulários

Objetivo: construir um formulário cujos erros qualquer pessoa consiga encontrar e corrigir.

Leia e faça: o tutorial de formulários acessíveis, os cinco passos.

Autoavaliação: o formulário falha a validação. Para onde vai o foco e o que é lido?

Para o resumo de erros, anunciado com o título e a lista de ligações, uma por erro, cada uma a levar ao seu campo.

Autoavaliação: porque não desativar o botão de envio até o formulário ser válido?

Um botão desativado não consegue dizer o que está errado, e muitas pessoas não percebem porque não faz nada.

Módulo 5 — Temas e contraste

Objetivo: reestilizar o Lily sem estragar o contraste nem o foco.

Leia: o tutorial de temas e a tabela de contraste dos temas .

Faça: substitua --color-primary pela cor da sua marca. Verifique que o seu par, --color-primary-content, atinge 4,5:1, e que o anel de foco continua visível na página.

Autoavaliação: a cor da sua marca é demasiado clara para texto branco. Ainda pode usá-la?

Sim, como decoração (--lily-brand: uma faixa de cabeçalho, uma linha, o fundo de um logótipo), nunca para texto nem para a borda de um controlo. O texto e as bordas usam os pares de conteúdo do tema.

Módulo 6 — Todo o mundo

Objetivo: não tornar nenhum país o predefinido.

Leia e faça: um formulário que funciona em todo o mundo.

Autoavaliação: porque é que CurrencyInput não tem moeda por omissão?

Qualquer valor por omissão seria o dinheiro de um só país, errado em silêncio em todos os outros. Um currencyCode em falta é um defeito de quem chama.

Autoavaliação: uma página em árabe. O que define, e o que deve fazer o seu CSS?

lang="ar" e dir="rtl" (o seletor de idioma define ambos); o seu CSS usa propriedades lógicas para que o layout se espelhe sozinho.

Módulo 7 — Movimento

Objetivo: animar sem prejudicar ninguém.

Leia: as receitas de movimento.

Faça: ative «reduzir movimento» no sistema operativo e recarregue uma página com a receita do letreiro. Deve ficar parado e quebrar em linhas. Depois chegue ao botão de pausa pelo teclado.

Autoavaliação: algo se move sozinho durante mais de cinco segundos. O que deve ter?

Uma forma de o pausar, parar ou esconder (WCAG 2.2.2), acessível pelo teclado, não só ao passar o ponteiro.

Módulo 8 — Verifique o seu trabalho

Objetivo: testar uma página como o Lily testa as suas.

Faça: pegue numa página que construiu neste curso e faça quatro verificações:

  1. axe (a extensão do navegador, ou @axe-core/playwright num teste): nenhuma violação.
  2. Só teclado: todas as tarefas feitas, foco sempre visível, nunca preso.
  3. Zoom a 400% e janela reduzida a 320 píxeis: sem deslocamento lateral, nada cortado.
  4. Um leitor de tela: cada controlo tem nome, papel e estado, e os erros são anunciados.
Autoavaliação: o axe não reporta violações. A página é acessível?

Ainda não está provado. Os testes automáticos encontram talvez um terço dos problemas; as verificações de teclado, zoom e leitor de tela encontram grande parte do resto. Veja a página de qualidade para o que o próprio Lily verificou e não verificou.

Depois do curso