Disclosure
Divulgação
Uma divulgação é um botão que mostra ou oculta uma seção relacionada. Ele também informa ao software se a seção está aberta.
Divulgação
Uma divulgação é um botão que mostra ou oculta uma seção relacionada. Ele também informa ao software se a seção está aberta.
Escolha quando
Use-o para conteúdo extra que as pessoas podem escolher visualizar. Ocultar esse conteúdo não deve bloquear a tarefa principal.
Um exemplo real
Em uma página de faturamento, “Mostrar detalhamento da taxa” revela três itens e altera `aria-expanded` para `true`. O foco permanece no botão. O total permanece visível mesmo se o JavaScript falhar.
Partes principais
- 01Botão de alternância
- 02Estado expandido
- 03Região controlada
Use-o quando
Use-o para conteúdo extra que as pessoas podem escolher visualizar. Ocultar esse conteúdo não deve bloquear a tarefa principal.
Não o use quando
Não o use como um menu ou uma opção de formulário. Nunca esconda erros ou instruções obrigatórias dentro dele.
Nome usado no código
button aria-expanded aria-controls + controlled region Antes de lançar
Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery.
Outcome: Complete the task with Divulgação (Disclosure). User context: Em uma página de faturamento, “Mostrar detalhamento da taxa” revela três itens e altera `aria-expanded` para `true`. O foco permanece no botão. O total permanece visível mesmo se o JavaScript falhar. Recommended pattern: Divulgação (Disclosure). Why it fits: Use-o para conteúdo extra que as pessoas podem escolher visualizar. Ocultar esse conteúdo não deve bloquear a tarefa principal. Do not use it when: Não o use como um menu ou uma opção de formulário. Nunca esconda erros ou instruções obrigatórias dentro dele. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): É oficial para essa fonte. Outras plataformas ou equipes podem usar o termo de outra maneira. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Divulgação (Disclosure) is used now. Definition: Uma divulgação é um botão que mostra ou oculta uma seção relacionada. Ele também informa ao software se a seção está aberta. Release checks: Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.