From 73dda1b9fda9baec539cb37ea963aeed8a48a37a Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Sat, 4 Jul 2026 03:31:31 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20[UX/a11y=20improvemen?= =?UTF-8?q?t]=20=ED=8C=8C=EC=9D=BC=20=EC=95=84=EC=9D=B4=EC=BD=98=20?= =?UTF-8?q?=EA=B0=9C=EC=84=A0=20=EB=B0=8F=20=EB=8B=A4=EA=B5=AD=EC=96=B4=20?= =?UTF-8?q?=EC=A7=80=EC=9B=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit πŸ’‘ What: 1. `nav` μš”μ†Œμ˜ `aria-label`을 'Directory listing'μ—μ„œ λ¬Έμ„œ 언어인 ν•œκ΅­μ–΄μ— 맞게 '디렉토리 λͺ©λ‘'으둜 λ²ˆμ—­ν–ˆμŠ΅λ‹ˆλ‹€. 2. μƒμœ„ 디렉토리 이동 링크('..')에 `title="μƒμœ„ λ””λ ‰ν† λ¦¬λ‘œ 이동"` 속성을 μΆ”κ°€ν•˜μ—¬ νˆ΄νŒμ„ μ œκ³΅ν–ˆμŠ΅λ‹ˆλ‹€. 3. 파일 μ•„μ΄μ½˜μ„ 일반적인 ν…μŠ€νŠΈ μ•„μ΄μ½˜(▸)μ—μ„œ 더 직관적인 λ¬Έμ„œ μ•„μ΄μ½˜(📄)으둜 λ³€κ²½ν–ˆμŠ΅λ‹ˆλ‹€. 🎯 Why: 1. ``둜 μ„ μ–Έλœ λ¬Έμ„œ 내에 ν•˜λ“œμ½”λ”©λœ 영문 ARIA 라벨은 ν•œκ΅­μ–΄ μŒμ„± ν”„λ‘œνŒŒμΌμ„ μ‚¬μš©ν•˜λŠ” 슀크린 λ¦¬λ”μ—μ„œ λΆ€μžμ—°μŠ€λŸ½κ²Œ μ½νžˆκ±°λ‚˜ μ‚¬μš©μžμ—κ²Œ ν˜Όλž€μ„ μ€λ‹ˆλ‹€. 2. '..' 같은 λͺ…령쀄 약어에 μ΅μˆ™ν•˜μ§€ μ•Šμ€ 일반 μ‚¬μš©μžλ₯Ό μœ„ν•΄ ν˜Έλ²„ μ‹œ 의미λ₯Ό μ„€λͺ…ν•˜λŠ” 툴팁이 ν•„μš”ν–ˆμŠ΅λ‹ˆλ‹€. 3. κΈ°μ‘΄ μ‚Όκ°ν˜• μ•„μ΄μ½˜(β–Έ)은 νŒŒμΌλ³΄λ‹€ 'μž¬μƒ' λ˜λŠ” 'λͺ©λ‘ μ—΄κΈ°'λ₯Ό μ—°μƒμ‹œμΌœ 직관적이지 μ•Šμ•˜μŠ΅λ‹ˆλ‹€. πŸ“Έ Before/After: Before: - 파일 ν‘œμ‹œ: β–Έ file.txt - μƒμœ„ 디렉토리: .. (툴팁 μ—†μŒ) - ARIA: aria-label="Directory listing" After: - 파일 ν‘œμ‹œ: πŸ“„ file.txt - μƒμœ„ 디렉토리: .. (ν˜Έλ²„ μ‹œ 'μƒμœ„ λ””λ ‰ν† λ¦¬λ‘œ 이동' 툴팁 ν‘œμ‹œ) - ARIA: aria-label="디렉토리 λͺ©λ‘" β™Ώ Accessibility: 슀크린 λ¦¬λ”μ˜ λ¬Έμ„œ 언어와 μ»΄ν¬λ„ŒνŠΈ ARIA 라벨 μ–Έμ–΄λ₯Ό μΌμΉ˜μ‹œμΌœ μŒμ„± 합성을 μžμ—°μŠ€λŸ½κ²Œ λ§Œλ“€κ³ , λΉ„μ‹œκ° μž₯μ• μΈμ—κ²Œλ„ μ–΄λ €μš΄ μ•½μ–΄λ₯Ό μ‰½κ²Œ 이해할 수 μžˆλ„λ‘ νˆ΄νŒμ„ μΆ”κ°€ν–ˆμŠ΅λ‹ˆλ‹€. --- .jules/palette.md | 3 +++ src/main/kotlin/html4tree/main.kt | 8 ++++---- src/test/kotlin/html4tree/MainTest.kt | 3 ++- 3 files changed, 9 insertions(+), 5 deletions(-) diff --git a/.jules/palette.md b/.jules/palette.md index b8df5bd..8636493 100644 --- a/.jules/palette.md +++ b/.jules/palette.md @@ -13,3 +13,6 @@ ## 2024-06-25 - Directory Listing Navigation Landmark **Learning:** Generated directory listings act as navigation regions, and screen readers benefit when the listing is announced separately from the page's main content. **Action:** Wrap generated directory listing `