Disclosure
Divulgación
Un disclosure es un botón que muestra u oculta una sección relacionada. También le indica al software si la sección está abierta.
Divulgación
Un disclosure es un botón que muestra u oculta una sección relacionada. También le indica al software si la sección está abierta.
Úsalo cuando
Úsalo para contenido adicional que las personas puedan elegir ver. Ocultar ese contenido no debe bloquear la tarea principal.
Un ejemplo real
En una página de facturación, “Mostrar desglose de tarifas” revela tres elementos y cambia `aria-expanded` a `true`. El enfoque permanece en el botón. El total sigue siendo visible incluso si falla JavaScript.
Partes principales
- 01Botón de alternancia
- 02Estado ampliado
- 03Región controlada
Úsalo cuando
Úsalo para contenido adicional que las personas puedan elegir ver. Ocultar ese contenido no debe bloquear la tarea principal.
No lo uses cuando
No lo uses como un menú o una opción de formulario. Nunca ocultes errores o instrucciones requeridas dentro de él.
Nombre usado en código
button aria-expanded aria-controls + controlled region Antes de lanzarlo
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 Divulgación (Disclosure). User context: En una página de facturación, “Mostrar desglose de tarifas” revela tres elementos y cambia `aria-expanded` a `true`. El enfoque permanece en el botón. El total sigue siendo visible incluso si falla JavaScript. Recommended pattern: Divulgación (Disclosure). Why it fits: Úsalo para contenido adicional que las personas puedan elegir ver. Ocultar ese contenido no debe bloquear la tarea principal. Do not use it when: No lo uses como un menú o una opción de formulario. Nunca ocultes errores o instrucciones requeridas dentro de él. 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): Es oficial para esa fuente. Otras plataformas o equipos pueden usar el término de otra manera. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Revisa esta petición
Review how Divulgación (Disclosure) is used now. Definition: Un disclosure es un botón que muestra u oculta una sección relacionada. También le indica al software si la sección está abierta. 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.