diff --git a/.jules/palette.md b/.jules/palette.md index 604d7810..79b154fb 100644 --- a/.jules/palette.md +++ b/.jules/palette.md @@ -73,3 +73,7 @@ ## 2026-08-17 - 브라우저 번역과 화면 판독기의 호환성을 위한 텍스트 처리 **Learning:** `aria-label` 속성으로 지정된 화면 판독기용 대체 텍스트는 Chrome Translate 등 브라우저 번역 도구에 의해 번역되지 않는 경우가 많습니다. 이로 인해 문서 언어가 변환되어도 스크린 리더에서는 원본 언어(예: 영어)로 읽혀 다국어 접근성이 저하됩니다. **Action:** 화면 판독기를 위한 숨겨진 설명 텍스트를 제공할 때 `aria-label` 대신 CSS `.visually-hidden` 클래스를 적용한 `` 요소를 사용하여, 브라우저가 일반 텍스트로 인식하고 번역할 수 있도록 하여 다국어 접근성 호환성을 확보하십시오. + +## 2024-09-24 - 내비게이션 랜드마크의 번역 호환성 +**Learning:** `nav` 등의 랜드마크 요소에 `aria-label`을 사용하여 접근성 이름을 제공하면 크롬 번역 등의 브라우저 내장 번역기가 이를 번역하지 못해 접근성이 저하되는 경우가 있습니다. +**Action:** 브라우저 번역 도구와의 호환성을 높이기 위해 `aria-label` 대신 `aria-labelledby`를 시각적으로 숨겨진(`.visually-hidden`) 헤더(예: `

`)와 함께 사용하여 접근성 이름을 제공하십시오. diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt index 0972fa2c..2d0de1da 100644 --- a/src/main/kotlin/html4tree/main.kt +++ b/src/main/kotlin/html4tree/main.kt @@ -427,7 +427,8 @@ fun process_dir(curr_dir: File, excludeSet: Set? = null, dirFiles: Array

${directoryName.escapeHtml()}

-