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:
- axe (a extensão do navegador, ou
@axe-core/playwrightnum teste): nenhuma violação. - Só teclado: todas as tarefas feitas, foco sempre visível, nunca preso.
- Zoom a 400% e janela reduzida a 320 píxeis: sem deslocamento lateral, nada cortado.
- 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
- O guia de saúde, para software clínico.
- Os ajudantes: seletores, a grelha de dados, o calendário.
- Ajuda, e o projeto para perguntas.