From 31df9a395916540434bb2249b79ad344e1c10eaf Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Sun, 26 Jul 2026 20:51:47 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20=EB=B9=88=20=EB=94=94?= =?UTF-8?q?=EB=A0=89=ED=86=A0=EB=A6=AC=20=EC=83=81=ED=83=9C=20=EB=A9=94?= =?UTF-8?q?=EC=8B=9C=EC=A7=80=20=EC=A0=91=EA=B7=BC=EC=84=B1=20=EA=B0=95?= =?UTF-8?q?=ED=99=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - `src/main/kotlin/html4tree/main.kt`: 빈 디렉토리 안내 메시지가 포함된 `
`에 `role="status"` 추가 - `src/test/kotlin/html4tree/MainTest.kt`: 변경된 HTML에 맞게 단위 테스트 Assertion 수정 - `.jules/palette.md`: 정적 HTML 생성기에서의 상태 롤(Status Role) 활용 접근성 개선 경험 기록 추가 --- .jules/palette.md | 3 +++ src/main/kotlin/html4tree/main.kt | 2 +- src/test/kotlin/html4tree/MainTest.kt | 2 +- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/.jules/palette.md b/.jules/palette.md index 9a12c9de..caabaed2 100644 --- a/.jules/palette.md +++ b/.jules/palette.md @@ -48,3 +48,6 @@ ## 2024-08-01 - 네이티브 브라우저 UI의 다크 모드 지원 강제 **학습:** CSS 미디어 쿼리(`@media (prefers-color-scheme: dark)`)를 통해 다크 모드를 지원하더라도, 브라우저의 네이티브 UI 요소(스크롤바, 기본 폼 컨트롤, 기본 백그라운드 등)는 테마 변경을 인식하지 못해 어두운 테마 환경에서 밝은 스크롤바가 표시되는 등 시각적 불일치를 초래합니다. **조치:** 항상 HTML 문서의 `` 영역에 `` 메타 태그를 명시적으로 추가하여 브라우저 수준에서 사용자의 시스템 테마(다크 모드 등)를 완전히 상속받아 일관성 있는 네이티브 UI를 렌더링하도록 보장하십시오. +## 2026-07-26 - 빈 디렉토리 메시지 접근성 개선 +**Learning:** 정적인 HTML 생성 결과물에서도 스크린 리더 등 보조 기기가 상태 변화나 빈 상태를 올바르게 인지할 수 있도록 적절한 ARIA role(예: `role="status"`)을 제공하는 것이 중요함. +**Action:** 빈 디렉토리 등 상태를 나타내는 메시지 요소에 `role="status"`를 추가하여 접근성을 높일 것. diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt index b4558624..e57b9307 100644 --- a/src/main/kotlin/html4tree/main.kt +++ b/src/main/kotlin/html4tree/main.kt @@ -370,7 +370,7 @@ ${cssContent} } if(l.isEmpty()){ - l.append("""
  • 이 디렉토리는 비어 있습니다.
    • """) + l.append("""
  • 이 디렉토리는 비어 있습니다.
    • """) l.append('\n') } diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt index 13494714..f939058d 100644 --- a/src/test/kotlin/html4tree/MainTest.kt +++ b/src/test/kotlin/html4tree/MainTest.kt @@ -93,7 +93,7 @@ class MainTest { assertTrue(indexFile.exists()) val htmlContent = indexFile.readText() assertTrue(htmlContent.contains("")) - assertTrue(htmlContent.contains("이 디렉토리는 비어 있습니다.")) + assertTrue(htmlContent.contains("
    이 디렉토리는 비어 있습니다.
    ")) assertTrue(htmlContent.contains("role=\"list\"")) }