어려운 항목엔 물음표 도움말

KRDS SP-134 — 입력 항목에 대한 레이블에 전문 용어를 사용해야 할 경우 도움 컴포넌트를 사용하여 설명을 제공하고 있다.

0. 들어가며 — 입력 항목 이름이 무슨 뜻인지 모르면

이번 808편은 입력 항목 레이블에 전문 용어를 사용해야 할 경우 도움 컴포넌트를 사용하여 설명을 제공하라는 규칙입니다.

신청서 입력 항목의 레이블이 — 부득이 전문 용어(법적 용어 등)일 때, 그 뜻을 모르면 사용자는 채울 수 없죠. SP-134는 도움 컴포넌트(물음표 툴팁 등)로 설명하라고 규정합니다. 이번 편을 풀어냅니다.

1. 원문 — 전문 용어 도움 컴포넌트 설명

SP-134 (서비스 패턴 > 신청 > 신청서 작성) “입력 항목에 대한 레이블에 전문 용어를 사용해야 할 경우 도움 컴포넌트를 사용하여 설명을 제공하고 있다.”

전문 용어 레이블에 도움 컴포넌트로 설명을 제공하라는 뜻입니다.

정리: 전문 용어 레이블에 도움 컴포넌트로 설명을 제공하라. 이게 SP-134입니다.

2. 왜 도움 컴포넌트 설명인가

신청서 입력 항목의 레이블은, 쉬운 용어가 좋습니다(SP-112). 하지만 부득이 전문 용어(법적·행정 정의가 필요한 용어)를 써야 하는 경우가 있죠. 이때 그 뜻을 설명 안 하면, 사용자는 무엇을 입력할지 모릅니다. SP-134는 도움 컴포넌트로 설명하라고 합니다.

전문 용어를 설명 없이 둘 때의 문제:

입력 못 함 레이블이 ’○○(전문 용어)’인데 뜻을 모르면, 사용자는 무엇을 입력할지 모릅니다. 추측 으로 잘못 입력하거나 멈추죠.

오류·포기 이해 못 한 항목에서 막혀, 신청을 포기합니다.

그래서 SP-134는 — 도움 컴포넌트 설명을 요구합니다:

도움 컴포넌트 전문 용어 레이블 옆에, 도움 컴포넌트(물음표 아이콘 ⓘ/?, 툴팁 CP-376~384, 도움 패널 CP-335~348)를 둡니다. 사용자가 누르거나·호버하면, 그 용어의 쉬운 설명이 나타나죠.

쉬운 설명 설명을, 쉬운 말로요(SP-112). 그 전문 용어가 무슨 뜻인지, 무엇을 입력하는지를요. 예: ‘소득인정액(?)’ → ‘소득과 재산을 합산한 금액으로…’.

레이블은 정확, 설명은 쉽게 레이블은 공식·정확한 용어(법적 필요), 설명은 쉬운 풀이로요. 정확성 (레이블) + 이해도(설명)를 둘 다요(SP-106·112 정신).

접근성 도움 컴포넌트도, 키보드·스크린 리더로 접근 가능하게요(툴팁 접근성 CP-376~384, SP-137 도움말 정확성).

도움(BP)·툴팁(CP)·맥락 도움(CP)의 신청 적용. 도움(BP-017030)·툴팁(CP-376384)·맥락 도움(CP-355~365)의 정신을, 신청서 전문 용어에 적용한 게 SP-134입니다. 사용자가 막히는 지점(어려운 항목)에, 그 자리에서 도움을 주죠.

SP-136(항목 자체에 참고 사항)과 연계. 작성 참고 사항은, 화면 상단·하단이 아니라 입력 항목 자체에 (SP-136) 둡니다. 도움 컴포넌트(SP-134)도, 그 항목 옆에요. 사용자가 그 항목을 채울 때 바로 도움을 보게요.

이 규칙은 신청(SP)의 ’항목 도움’을 담당합니다 — 전문 용어 레이블에 도움 컴포넌트로 설명을 제공해(134), 사용자가 어려운 항목도 이해하고 채우게 하죠. SP-135(다양한 도움)·SP-136(항목 자체 참고)과 함께 갑니다.

정리하면 — 입력 항목 레이블이 부득이 전문 용어일 때 설명이 없으면 사용자가 채울 수 없으므로, 도움 컴포넌트(물음표 툴팁 등)로 쉬운 설명을 제공해(레이블은 정확·설명은 쉽게) 이해하고 채우게 해야 합니다.

3. 점검 / 개선

무엇을 점검하나

도움 컴포넌트 — 전문 용어 레이블에 도움 컴포넌트(?/ⓘ 툴팁)가 있는가.

쉬운 설명 — 설명이 쉬운 말로 그 용어·입력 내용을 설명하는가.

접근성 — 도움 컴포넌트가 키보드·스크린 리더로 접근 가능한가.

개선 방향

전문 용어 레이블에 물음표 툴팁·도움 패널(CP-376384·335348).

쉬운 설명(SP-112). 레이블 정확·설명 쉽게. 접근성(SP-137).

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

역할	책임
UX 라이터	용어 설명 작성
퍼블리셔/개발	도움 컴포넌트 구현

기관 유형	SP-134 적용
중앙행정기관(대표·운영) / 공공기관 / 지자체	✅ 권장 (전문 용어 신청서)

전문 용어가 쓰이는 신청서가 해당됩니다.

5. 30초 자가진단 + FAQ

✅ 30초 자가진단

□ 전문 용어 레이블에 도움 컴포넌트(?/ⓘ 툴팁)가 있나요?

□ 설명이 쉬운 말로 그 용어·입력 내용을 설명하나요?

□ 도움 컴포넌트가 키보드·스크린 리더로 접근 가능한가요?

❓ FAQ

Q1. 전문 용어를 안 쓰면 안 되나요? 가급적 쉬운 말을 쓰되(SP-112), 법적·행정 정의가 필요한 경우는 부득이 전문 용어 를 씁니다. 그때 도움 컴포넌트로 쉬운 설명을 곁들이죠. Q2. 어떻게 설명하나요? 물음표 아이콘(?/ⓘ)·툴팁(CP-376~384)·도움 패널을 항목 옆에 둬, 누르거나 호버하면 쉬운 설명 이 나타나게요. ‘소득인정액(?)’ → ’소득과 재산을 합산한 금액’처럼요. Q3. 레이블과 설명은 어떻게 다르나요? 레이블은 공식·정확한 용어(법적 필요), 설명은 쉬운 풀이요. 정확성(레이블) + 이해도(설명)를 둘 다 잡습니다(SP-106·112).

6. 마무리

SP-134의 메시지:

어려운 항목엔 물음표 도움말 — 전문 용어 레이블에 도움 컴포넌트로 설명을 제공하라.

전문 용어 레이블에 설명이 없으면 사용자가 채울 수 없습니다. 도움 컴포넌트로 쉬운 설명을 제공해 이해하고 채우게 하는 게 핵심이죠. 다음 편은 신청서 작성 다양한 도움 수단입니다.

다음 편 예고 ▶ 「809. (SP-135) 신청서 작성에 대해 도움받을 수 있는 다양한 수단(문의처, 도움 컴포넌트, FAQ, 작성 예시 링크)을 제공하고 있다.」

ViewCheck는 전문 용어 레이블에 도움 컴포넌트 설명이 제공되는지를 진단합니다.

📚 참고 출처

KRDS 서비스 패턴 — 신청 가이드 — https://www.krds.go.kr/html/site/service/service_04.html

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

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