Files
drawNET/docs/bug_reports/2026-03-22-help-modal-dark-mode-fix.md
T

1.5 KiB

drawNET Bug Report - 2026-03-22 🐞

이 문서는 2026년 03월 22일 발생한 다크모드 가시성 문제 해결 및 그에 따른 조치 사항을 기록합니다.


[Instance #0003] - 다크모드에서 도움말(온보딩 가이드) 가시성 불량 해결

  • 현상: 다크모드 활성화 시, 도움말 모달 내의 텍스트가 배경색과 비슷한 어두운 색으로 표시되어 읽기가 매우 힘듦. (사용자 제보 이미지 확인됨)
  • 원인: static/js/modules/ui/help_modal.js 내부의 HTML 템플릿에서 텍스트 색상(#1e293b, #334155 등)과 배경색을 하드코딩된 인라인 스타일로 정의함. 이로 인해 테마가 바뀌어도 색상이 고정되어 대비(Contrast)가 확보되지 않음.
  • 조치:
    1. 테마 변수 적용: 하드코딩된 색상을 base.css에 정의된 CSS 변수(var(--text-color), var(--sub-text), var(--panel-border), var(--item-bg), var(--accent-color))로 전면 교체.
    2. 가독성 보정: 정보 박스(manual/guide.md 안내)의 배경을 var(--item-bg)로 변경하여 다크모드에서도 자연스럽고 선명하게 보이도록 수정.
  • 관련 이전 이슈: 없음.

모든 항목은 압축하지 말고, 이전 리포트들보다 더 자세하거나 최소한 동일한 상세도로 작성할 것. 절대 요약·생략·간략화하지 마. 각 항목에 구체적인 코드 조각, 이벤트 이름, 함수명, 속성명 등을 최대한 포함.