Skip to content

fix(a11y): hide redundant decorative icons from the accessibility tree - #607

Draft
seonghobae wants to merge 6 commits into
developmentalfrom
palette-a11y-fix-14617504727406957648
Draft

fix(a11y): hide redundant decorative icons from the accessibility tree#607
seonghobae wants to merge 6 commits into
developmentalfrom
palette-a11y-fix-14617504727406957648

Conversation

@seonghobae

@seonghobae seonghobae commented Sep 9, 2026

Copy link
Copy Markdown

범위

인접한 시각 텍스트와 동일한 의미의 로고, 그리고 버튼의 이름·상태에 정보를 추가하지 않는 chevron/icon을 accessibility tree에서 제외하는 후보입니다. org-sidebar.tsx, context-section.tsx, event-list.tsx의 시맨틱 변경 자체와 dependency 변경은 서로 다른 책임입니다.

review finding

현재 PR에는 접근성 수정과 인과관계가 없는 package.json/pnpm-lock.yaml 대규모 dependency override·Next.js 전환이 함께 들어와 있습니다. accessibility acceptance를 dependency migration에 묶으면 regression 원인과 release evidence가 혼합됩니다. 이 PR에서 dependency delta는 protected base bytes로 되돌리거나 별도 dependency-owner PR로 분리해야 합니다. 해당 delta를 accessibility fix의 선행조건이나 우회책으로 인정하지 않습니다.

또한 aria-hidden="true"/alt=""를 추가했다는 source diff만으로 실제 중복 낭독 제거가 검증됐다고 보지 않습니다. 각 button의 accessible name과 aria-expanded 상태, sidebar logo 인접 텍스트가 실제 AX tree에서 의도대로 계산되는지 current head browser에서 확인해야 합니다.

Material UI Delivery Gate

  • 의도성: PASS — 장식/중복 의미만 tree에서 제외한다는 목적은 명확합니다.
  • 기능 완전성: PARTIAL — source semantics는 합리적이나 실제 AX tree·keyboard interaction 검증이 없습니다.
  • 콘텐츠 적합성: FAIL — unrelated dependency/lockfile migration이 같은 PR에 섞여 있습니다.
  • 복원력: PENDING — normal/loading/empty/error, keyboard, narrow/intermediate/desktop에서 current-head E2E가 필요합니다.
  • 증거성: FAIL — 실제 screen-reader/AX evidence 없이 중복 낭독 제거 완료를 주장할 수 없습니다.
  • 고유성: N/A — 시각 디자인 변경이 아닙니다.

Ready acceptance

  1. package.jsonpnpm-lock.yaml의 unrelated dependency delta를 이 PR에서 제거하거나 별도 owner PR로 완전히 분리합니다.
  2. logo + 인접 Argos text, collapsed/expanded report controls, event rows를 current-head browser AX tree에서 검증합니다.
  3. Tab/Enter/Space와 focus state, aria-expanded 전환이 동일하게 유지됩니다.
  4. normal/loading/empty/error 및 narrow/intermediate/desktop layout에 시각 regression이 없습니다.
  5. application tests, Security Scan, SAST, CodeQL이 동일 exact head에서 terminal GREEN이고 current-head independent review에서 valid finding 0입니다.

위 acceptance 전에는 merge/release-ready로 보지 않습니다.

Summary by CodeRabbit

  • 접근성 개선
    • 스크린 리더가 동일한 정보를 중복해서 읽지 않도록 장식용 아이콘과 로고를 보조 기술에서 숨겼습니다.
    • 이벤트 목록과 리포트 펼침/접힘 컨트롤의 아이콘 안내를 정리했습니다.
    • 사이드바 로고가 인접한 제목과 중복 낭독되지 않도록 개선했습니다.
    • 장식용 이미지와 아이콘을 적절히 구분해 보조 기술이 더 명확한 정보를 제공하도록 했습니다.

@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 Sep 9, 2026

Copy link
Copy Markdown

Review Change StackReview Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 8d7697fa-8ef4-439f-864d-0602333e300c

📥 Commits

Reviewing files that changed from the base of the PR and between 11d34a3 and d55831d.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (1)
  • package.json

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

장식용 아이콘과 중복 의미를 가진 로고를 보조 기술에서 숨깁니다. 관련 접근성 지침을 추가합니다. pnpm.overrides의 패키지 버전 제약도 갱신합니다.

Changes

장식 요소 접근성 조정

Layer / File(s) Summary
장식 요소 접근성 지침
.jules/palette.md
중복 의미의 인접 이미지와 상위 요소가 목적 또는 상태를 제공하는 장식용 아이콘을 숨기도록 지침을 추가합니다.
UI 장식 요소 숨김 처리
packages/web/src/components/dashboard/event-list.tsx, packages/web/src/components/dashboard/reports/context-section.tsx, packages/web/src/components/layout/org-sidebar.tsx
대시보드 아이콘에 aria-hidden="true"를 추가합니다. 데스크톱 및 모바일 조직 로고는 빈 alt 값과 aria-hidden="true"를 사용합니다.

패키지 오버라이드 갱신

Layer / File(s) Summary
오버라이드 버전 제약 갱신
package.json
pnpm.overrides에 패키지를 추가하고 hono, js-yaml, sharp, fast-uri의 버전 제약을 상향 조정합니다.

Estimated code review effort: 2 (Simple) | ~10 minutes

Severity of issue fixed: Low

Merge Risk: ⚪ Minimal · up to d5583

The update prevents redundant screen-reader announcements for decorative logos and icons and updates dependency version constraints. No material outstanding risk is identified.

Suggested reviewers: claude

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 3 functions across 3 files. (1 skipped: 1 … Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
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.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed 제목은 장식용 아이콘을 접근성 트리에서 숨기는 핵심 변경을 정확하고 간결하게 설명합니다.
Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 3 functions across 3 files. (1 skipped: 1 unsupported.)

  • Fix all pre-merge checks with AI
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch palette-a11y-fix-14617504727406957648

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.

@seonghobae seonghobae changed the title 🎨 Palette: [UX improvement] 스크린 리더 중복 낭독 방지 및 장식용 아이콘 접근성 개선 fix(a11y): hide redundant decorative icons from the accessibility tree Sep 10, 2026
@seonghobae
seonghobae marked this pull request as draft September 10, 2026 02:45
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