도움말이 도움말을 부르지 않게

KRDS CP-358 — 맥락적 도움말에서 또 다른 맥락적 도움말을 실행하거나 모달을 실행하지 않고 있다.

0. 들어가며 — 도움말 안의 도움말

이번 478편은 맥락적 도움말에서 또 다른 맥락적 도움말이나 모달을 실행하지 않게 하라는 규칙입니다.

도움말 팝오버 안에서 — 또 다른 도움말이 열리거나, 본문을 막는 모달이 뜨면, 사용자는 도움말 미로에 빠지고 가벼운 도움이라는 본질이 깨지죠. CP-358은 도움말의 중첩과 모달 실행을 금지합니다. 맥락적 도움말을 ‘가볍게’ 유지하는 규칙이죠. 이번 편을 풀어냅니다.

1. 원문 — 중첩·모달 실행 금지

CP-358 (컴포넌트 > 맥락적 도움말) “맥락적 도움말에서 또 다른 맥락적 도움말을 실행하거나 모달을 실행하지 않고 있다.”

맥락적 도움말 안에서 또 다른 맥락적 도움말을 열거나, 모달 다이얼로그를 실행하지 말라는 뜻입니다.

정리: 도움말 안에서 또 도움말·모달을 띄우지 마라. 이게 CP-358입니다.

2. 왜 중첩·모달을 금지하나

맥락적 도움말은 — 그 자리에 작게 뜨는 가벼운 인라인 도움입니다(CP-355~357). 본문을 막지 않고, 잠깐 참고하고 닫는 게 본질이죠. 그런데 — 이 도움말 안에서 또 다른 무거운 UI(중첩 도움말·모달)를 띄우면, 그 가벼움이 깨지고 사용자가 복잡한 상황에 빠집니다. CP-358은 두 가지를 금지합니다.

① 또 다른 맥락적 도움말 실행 금지(중첩 금지). 도움말 팝오버 안에서 — 또 다른 도움말을 여는 것을 금지합니다.

도움말 미로 — 도움말 A를 열었는데 — 그 안에 또 도움말 B를 여는 아이콘이 있고, B 안에 또 C가 있으면, 사용 자는 도움말 미로에 빠지죠. 어디까지 들어왔는지, 어떻게 돌아가는지 헷갈립니다.

초점·닫기 혼란 — 도움말이 중첩되면 — 키보드 초점 관리(CP-364), 닫기 순서가 복잡해집니다. 어느 걸 닫으면 어디로 가는지 모르죠. 스크린 리더 사용자에게 특히 혼란스럽습니다.

가벼움 상실 — 맥락적 도움말은 ‘잠깐 참고하고 닫는’ 가벼운 도움입니다. 중첩되면 — 무거운 탐색 구조가 돼, 본질이 깨지죠.

② 모달 실행 금지. 도움말 안에서 — 본문을 막는 모달 다이얼로그를 띄우는 것을 금지합니다.

맥락 단절 맥락적 도움말은 본문과 공존하는 가벼운 팝오버입니다(본문을 안 막음, CP-357). 그런데 도움말에서 모달을 띄우면, 모달이 화면 전체를 덮어 본문을 막죠. 사용자는 작업 맥락에서 갑자기 전체 화면 모달로 끌려가, ’맥락적’이라는 본질이 완전히 깨집니다.

무거운 전환 — 모달은 — 초점을 가두고(focus trap), 배경을 비활성화하는 무거운 UI죠. 가벼운 도움말에서 이런 무거운 전환이 일어나면 사용자가 당황합니다.

그래서 CP-358은 — 맥락적 도움말을 가볍게 유지하라고 합니다:

단층 구조 — 도움말은 — 한 층(팝오버 하나)으로 끝납니다. 그 안에서 또 도움말을 열지 않죠.

모달 미실행 — 도움말 안에서 모달을 띄우지 않습니다. 본문과 공존하는 가벼움을 유지하죠.

더 많은 정보가 필요하면 — 도움말에 담기 어려운 많은 정보가 있으면 — 새 창 링크(CP-359)로 별도 페이지에 보내거나, 본문에 인라인으로 제공합니다. 도움말 안에 무거운 UI를 중첩하지 않고요.

도움 패널과의 구분(CP-360 연계). 맥락적 도움말(가벼운 팝오버)과 도움 패널(큰 영역)을 함께 쓰지 않는 것 (CP-360)과도 통합니다. 둘 다 — 맥락적 도움말을 단순·가볍게 유지하려는 규칙이죠.

이 규칙은 맥락적 도움말의 ’가벼움 유지’를 담당합니다 — 도움말 안에서 또 도움말·모달을 안 띄워(358), 사용자가 미로·맥락 단절에 빠지지 않고 잠깐 참고하고 닫게 하죠. 인라인 도움의 단순함을 지키는 원칙입니다.

정리하면 — 도움말 안에서 또 도움말을 열면 미로에 빠지고 모달을 띄우면 맥락이 단절되므로, 맥락적 도움말은 단층으로 유지하고 중첩·모달 실행 없이 가볍게 표현해야 합니다.

3. 점검 / 개선

무엇을 점검하나

중첩 없음 — 도움말 팝오버 안에서 또 다른 도움말을 열지 않는가.

모달 없음 — 도움말 안에서 모달을 실행하지 않는가.

가벼움 — 도움말이 단층으로 잠깐 참고하고 닫는 구조인가.

개선 방향

도움말 안의 도움말 트리거·모달 실행 제거.

많은 정보는 새 창 링크(CP-359)나 본문 인라인으로. 도움말은 단층 유지.

4. 누가 담당하나 / 우리 사이트에 해당될까?

역할	책임
기획/UX	도움말 구조 단순화 정책
퍼블리셔/개발	중첩·모달 제거 구현

기관 유형	CP-358 적용
중앙행정기관(대표·운영) / 공공기관 / 지자체	✅ 조건부 (맥락적 도움말 사용 시)

맥락적 도움말을 쓰는 사이트에 해당됩니다.

5. 30초 자가진단 + FAQ

✅ 30초 자가진단

□ 도움말 팝오버 안에서 또 다른 도움말을 열지 않나요?

□ 도움말 안에서 모달을 실행하지 않나요?

□ 도움말이 단층으로 잠깐 참고하고 닫는 구조인가요?

❓ FAQ

Q1. 도움말 안에 더 자세한 도움말 링크를 넣으면 안 되나요? 또 다른 맥락적 도움말·모달은 안 됩니다. 많은 정보는 새 창 링크(CP-359)로 별도 페이지에 보내죠. Q2. 왜 모달을 띄우면 안 되나요? 맥락적 도움말은 본문과 공존하는 가벼운 팝오버입니다. 모달은 본문을 막아 맥락이 단절되죠. Q3. 정보가 정말 많으면요? 새 창 링크나 본문 인라인으로 제공합니다. 도움말 안에 무거운 UI를 중첩하지 않죠.

6. 마무리

CP-358의 메시지:

도움말이 도움말을 부르지 않게 — 중첩·모달 없이 가볍게 유지하라.

도움말 안에서 또 도움말을 열면 미로에 빠지고, 모달을 띄우면 맥락이 단절됩니다. 맥락적 도움말을 단층으로 유지하고 중첩·모달을 금지하는 게 핵심이죠. 다음 편은 도움말 내부 링크의 새 창 실행입니다.

다음 편 예고 ▶ 「479. (CP-359) 도움말 내부 링크는 새 창으로 실행하고 있다.」

ViewCheck는 맥락적 도움말이 중첩·모달 없이 가볍게 유지되는지를 진단합니다.

📚 참고 출처

KRDS 컴포넌트 — 맥락적 도움말(Contextual help) 가이드 — https://www.krds.go.kr/html/site/component/component_35.html

KRDS #ViewCheck #공공웹사이트 #전자정부 #디지털정부 #웹접근성 #디자인시스템 #UIUX #UI컴포넌트 #웹표준

KRDS,ViewCheck,공공웹사이트,전자정부,디지털정부,웹접근성,디자인시스템,UIUX,UI컴포넌트,웹표준