Disclosure
A disclosure is a button that shows or hides a related section. It also tells software whether the section is open.
Disclosure
A disclosure is a button that shows or hides a related section. It also tells software whether the section is open.
Choose it when
Use it for extra content that people may choose to view. Hiding that content must not block the main task.
A real example
On a billing page, “Show fee breakdown” reveals three items and changes `aria-expanded` to `true`. Focus stays on the button. The total remains visible even if JavaScript fails.
Main parts
- 01Toggle button
- 02Expanded state
- 03Controlled region
Use it when
Use it for extra content that people may choose to view. Hiding that content must not block the main task.
Do not use it when
Do not use it as a menu or a form choice. Never hide required errors or instructions inside it.
Name used in code
button aria-expanded aria-controls + controlled region Before you ship
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: Use Disclosure to solve this user need without losing the current context. User context: On a billing page, “Show fee breakdown” reveals three items and changes `aria-expanded` to `true`. Focus stays on the button. The total remains visible even if JavaScript fails. Recommended pattern: Disclosure. Why it fits: Use it for extra content that people may choose to view. Hiding that content must not block the main task. Do not use it when: Do not use it as a menu or a form choice. Never hide required errors or instructions inside it. 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): It is official for that source. Other platforms or teams may use the term in another way. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Check this request
Review the current use of Disclosure. Definition: A disclosure is a button that shows or hides a related section. It also tells software whether the section is open. 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, report the evidence you found, gaps, severity, and the smallest safe fix.