Skip to content

🎨 Palette: Improve accessibility of table collapsible groups - #24

Closed
seonghobae wants to merge 6 commits into
mainfrom
palette/accessible-table-collapsibles-11417230484446285947
Closed

🎨 Palette: Improve accessibility of table collapsible groups#24
seonghobae wants to merge 6 commits into
mainfrom
palette/accessible-table-collapsibles-11417230484446285947

Conversation

@seonghobae

Copy link
Copy Markdown

💡 What: Added aria-controls attributes to the collapsible group toggle buttons in the UsecaseTable and ActorTable components. To support this properly, the conditional unmounting logic was refactored to use a CSS hidden class on a dedicated <tbody> so the target ID is always present in the DOM.
🎯 Why: When a collapsible section hides its content by completely removing it from the DOM, the aria-controls attribute points to an invalid ID, which can confuse screen readers. Keeping the element in the DOM with hidden ensures a consistent and accessible relationship between the toggle button and its content.
📸 Before/After: Visually identical. Verified with Playwright screenshots.
Accessibility: Fixes broken aria-controls references and improves screen reader context for grouped table rows.


PR created automatically by Jules for task 11417230484446285947 started by @seonghobae

Added `aria-controls` to the toggle buttons in `UsecaseTable` and `ActorTable` to properly associate them with the collapsible content.
Refactored the table body structure to use multiple `<tbody>` tags wrapped in a React Fragment, and used CSS `hidden` instead of conditional unmounting to ensure the `aria-controls` target ID remains in the DOM when collapsed.
@google-labs-jules

Copy link
Copy Markdown

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@coderabbitai

coderabbitai Bot commented Jun 14, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 08955161-cfcf-4c82-a3fd-6732ff7487e8

📥 Commits

Reviewing files that changed from the base of the PR and between b686d2f and b2ab02e.

📒 Files selected for processing (1)
  • apps/cli/tests/e2e-cli/UC-033.test.ts

📝 Walkthrough

Summary by CodeRabbit

릴리스 노트

  • Documentation

    • 접근 가능한 테이블 섹션 접기 구현 가이드라인 추가
  • Refactor

    • 테이블 컴포넌트의 접근성 개선 (aria-controls 및 hidden 속성 활용으로 스크린 리더 호환성 향상)
  • Tests

    • CLI 가이드 출력 검증 업데이트

워크스루

ActorTableUsecaseTable에서 그룹 본문 렌더링 방식을 조건부 마운트에서 항상 마운트 후 hidden 클래스 토글로 변경하고, 토글 버튼과 본문 <tbody> 사이에 aria-controls/id를 연결했다. 동일 패턴이 .jules/palette.md에 문서화되었으며 관련 e2e 테스트가 업데이트되었다.

변경 사항

테이블 접근성 개선

Layer / File(s) 요약
접근성 패턴 문서화
.jules/palette.md
접히는 섹션이 있는 테이블에서 aria-controls 대상 ID가 DOM에서 사라지지 않도록 토글 행과 콘텐츠 행을 별도 tbody로 분리하고 hidden 클래스를 사용하는 구현 가이드가 추가되었다.
ActorTable: 접근성 tbody 분리 및 hidden 클래스 적용
apps/app/app/components/ActorTable.tsx
Fragment import를 추가하고, 그룹 헤더와 본문을 별도 <tbody>로 분리해 aria-controls/id로 연결한다. 본문 tbodyisOpen 여부에 따라 hidden 클래스로 표시/숨김이 제어되며, DOM에서 항상 유지된다.
UsecaseTable: 접근성 tbody 분리 및 hidden 클래스 적용
apps/app/app/components/UsecaseTable.tsx
Fragment import를 추가하고, 그룹 컨테이너를 <tbody>에서 Fragment로 변경한다. 헤더 버튼에 contentId 기반 aria-controls를 추가하고, 본문 <tbody id={contentId}>는 항상 마운트하되 hidden 클래스로 접힘 상태를 표현한다.
AI guide 출력 검증 e2e 테스트 업데이트
apps/cli/tests/e2e-cli/UC-033.test.ts
ai-guide CLI 출력 검증을 업데이트하여 "Use vspec step add --at <n> to insert" 문구 기대값을 추가하고 기존 "vspec step add appends" 문구는 제거했다.

코드 리뷰 예상 노력

🎯 2 (Simple) | ⏱️ ~12분

🐇 토끼가 테이블 속을 깡충깡충 뛰어다니며,
hidden 클래스로 숨바꼭질을 하네~
aria-controls로 손잡고 연결하니
스크린리더도 길을 잃지 않는다오! 🎉
DOM에 살며시 남아있는 tbody,
접근성의 꽃이 활짝 피었구나! 🌸


Caution

Pre-merge checks failed

Please resolve all errors before merging. Addressing warnings is optional.

  • Ignore

❌ Failed checks (1 error)

Check name Status Explanation Resolution
Docstring Coverage ❌ Error Docstring coverage is 0.00% which is insufficient. The required threshold is 100.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed 제목은 풀 리퀘스트의 주요 변경 사항인 테이블 콜렉서블 그룹의 접근성 개선을 명확하게 요약하고 있습니다.
Description check ✅ Passed 설명은 변경 사항과 관련이 있으며, 접근성 개선의 이유, 방법, 영향을 명확하게 설명하고 있습니다.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch palette/accessible-table-collapsibles-11417230484446285947
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch palette/accessible-table-collapsibles-11417230484446285947

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install timed out. The project may have too many dependencies for the sandbox.

Warning

Billing warning: we have not been able to collect payment for this subscription for more than 72 hours. Please update the payment method or pay any pending invoices in Billing to avoid service interruption.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

…LI test

Added `aria-controls` to the toggle buttons in `UsecaseTable` and `ActorTable` to properly associate them with the collapsible content.
Refactored the table body structure to use multiple `<tbody>` tags wrapped in a React Fragment, and used CSS `hidden` instead of conditional unmounting to ensure the `aria-controls` target ID remains in the DOM when collapsed.
Fixed a failing unit test in CLI (`UC-033.test.ts`) that checked for the exact old wording of the AI guide, bringing it up to date with the latest content.
The `UC-033.test.ts` test was failing because it asserted the presence of the string "`vspec step add` appends" which was removed from the AI guide in a recent update. It now asserts the presence of "Use `vspec step add --at <n>` to insert" instead.
The `UC-033.test.ts` test was failing because it asserted the presence of the string "`vspec step add` appends" which was removed from the AI guide in a recent update. It now asserts the presence of "Use `vspec step add --at <n>` to insert" instead.
The `UC-033.test.ts` test was failing because it asserted the presence of the string "`vspec step add` appends" which was removed from the AI guide in a recent update. It now asserts the presence of "Use `vspec step add --at <n>` to insert" instead.
The `UC-033.test.ts` test was failing because it asserted the presence of the string "`vspec step add` appends" which was removed from the AI guide in a recent update. It now asserts the presence of "Use `vspec step add --at <n>` to insert" instead.
@seonghobae

Copy link
Copy Markdown
Author

통합 PR에서 유효 변경만 선별해 다시 다루고 있어 이 중복/잔여 PR은 정리합니다. #39 및 vibemafiaclub/vooster#34를 기준으로 후속 검토를 진행합니다.

@seonghobae seonghobae closed this Jul 7, 2026
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.

1 participant