Skip to content

feat: Add Play/Pause toggle button for Icon Cloud component so that satisfies WCAG G186#991

Merged
Yeom-JinHo merged 6 commits into
magicuidesign:mainfrom
510208:main
Jul 21, 2026
Merged

feat: Add Play/Pause toggle button for Icon Cloud component so that satisfies WCAG G186#991
Yeom-JinHo merged 6 commits into
magicuidesign:mainfrom
510208:main

Conversation

@510208

@510208 510208 commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Description

The original Icon Cloud component did not provide a play/pause control button.

This pull request adds this functionality to comply with WCAG G186 (which requires dynamically updated components to provide a pause/update button to accessibility by people with disabilities).

Changes

  • Introduce a Play/Pause button to toggle the cloud animation state
  • Add a new boolean property showControl to select whether to show the button
  • Edit documentation, create a section named ## With Control Button
  • Create an example named icon-cloud-demo-4 to show the control button toggle
  • Update registry to enable the example mentioned above

Motivation

Currently, the Icon Cloud component auto-plays continuous animations without built-in control options. This presents an accessibility barrier for users with cognitive or visual impairments who require more time to inspect the icons, and it falls short of WCAG 2.1 Success Criterion 2.2.2 (Pause, Stop, Hide) and G186 techniques.

This PR introduces a Play/Pause control toggle to the component. This allows users to pause the rotation at any time, enhancing readability and ensuring the component meets standard accessibility requirements.

Breaking Changes

None.

This PR introduces an optional showControl property, which is disabled by default. It does not introduce any breaking changes to existing implementations.

Note

Enabling showControl will render an additional control element within the component interface. Users enabling this feature should verify that their custom layout accounts for the added element.

Screenshots

Device / Browser / Viewport: Desktop (Microsoft Windows 11) / Chrome 150

Before After
magicui design_docs_components_icon-cloud (1) localhost_3000_docs_components_icon-cloud (2)

510208 added 2 commits July 21, 2026 20:55
Add a control button and a prop to toggle its visibility in the

IconCloud component to meet accessibility standards.
Add icon-cloud-demo-4 to showcase the control button functionality.

Update icon-cloud.mdx with 'With Control Button' section and showControl prop docs.
@vercel

vercel Bot commented Jul 21, 2026

Copy link
Copy Markdown

@510208 is attempting to deploy a commit to the product-studio Team on Vercel.

A member of the Team first needs to authorize it.

@510208
510208 marked this pull request as ready for review July 21, 2026 13:40
@510208 510208 changed the title feat: Add Play/Pause toggle button for Icon Cloud component so that satisfies a11y tru feat: Add Play/Pause toggle button for Icon Cloud component so that satisfies WCAG G186 Jul 21, 2026
@Yeom-JinHo
Yeom-JinHo self-requested a review July 21, 2026 14:11

@Yeom-JinHo Yeom-JinHo left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@510208
Thanks for the thoughtful accessibility work here! I've pushed a few follow-up commits to your branch to address some issues I found during review — the commit messages explain the reasoning for each.

@Yeom-JinHo
Yeom-JinHo merged commit 8e5e9eb into magicuidesign:main Jul 21, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants