같은 걸 같은 이름으로

KRDS BP-021 — [공통] 동일한 페이지 제목, 버튼 이름을 지칭하기 위한 텍스트는 모든 서비스에서 동일하게 사용하고 있다.

0. 들어가며 — 같은 버튼을 다른 이름으로 부르면

이번 587편은 동일한 페이지 제목·버튼 이름을 지칭하는 텍스트를 모든 서비스에서 동일하게 사용하라는 규칙입니다.

도움말에서 — ’제출 버튼을 누르세요’라고 안내했는데, 화면 버튼은 ’신청하기’면 사용자가 헷갈리죠. 같은 대상은 — 어디서든 같은 이름으로 불러야 합니다. BP-021은 용어·이름 일관성을 규정합니다. WCAG 3.2.4(일관된 식별) 정신이죠. 이번 편을 풀어냅니다.

1. 원문 — 모든 서비스에서 동일 텍스트

BP-021 (기본 패턴 > 도움 [공통]) “[공통] 동일한 페이지 제목, 버튼 이름을 지칭하기 위한 텍스트는 모든 서비스에서 동일하게 사용하고 있다.”

같은 페이지·버튼을 가리키는 텍스트(이름)를, 도움말·안내·화면 전반에서 동일하게 사용하라는 뜻입니다.

정리: 같은 대상은 어디서든 같은 이름으로 지칭하라. 이게 BP-021입니다.

2. 왜 용어·이름 일관성인가

도움말은 — 화면의 요소(페이지·버튼·메뉴)를 지칭해 안내합니다(‘○○ 페이지로 가서’, ‘△△ 버튼을 누르세요’). 이때 — 도움말에서 부르는 이름과 실제 화면의 이름이 일치해야, 사용자가 그 요소를 찾죠. BP-021은 이 일관성을 요구합니다.

이름이 불일치할 때의 문제:

요소를 못 찾음 도움말에서 ‘제출 버튼을 누르세요’라고 했는데, 실제 화면 버튼은 ’신청하기’면, 사용자는 ’제출 버튼이 어디 있지?’ 하며 못 찾습니다. 같은 버튼인데 이름이 달라 다른 것으로 오인하죠.

혼란·불신 같은 대상을 여기선 ‘신청’, 저기선 ‘제출’, 또 다른 곳에선 ‘등록’으로 부르면, 사용자는 ’이게 다 같은 건가? 다른 건가?’ 헷갈립니다. 일관성 없는 용어는 혼란과 불신을 키우죠.

서비스 간 불일치 — 한 기관의 여러 서비스에서 — 같은 기능을 다른 이름으로 부르면, 서비스를 옮길 때마다 새로 익혀야 합니다.

그래서 BP-021은 — 같은 대상을 모든 서비스에서 동일한 텍스트로 지칭하라고 합니다:

이름 통일 — 같은 페이지·버튼·기능은 — 화면에서도, 도움말에서도, 모든 서비스에서 같은 이름으로 부릅니다. ’신청하기’면 어디서든 ’신청하기’로요. 도움말이 그 버튼을 지칭할 때도 ’신청하기 버튼’으로.

용어 사전 — 기관·서비스 전반에서 — 용어 사전(terminology)을 만들어 일관되게 적용합니다. 같은 개념엔 같은 용어, 다른 개념만 다른 용어를요.

화면-도움말 일치 — 특히 — 도움말이 화면 요소를 지칭할 때, 화면의 실제 레이블과 정확히 일치시킵니다. 화면 버튼이 바뀌면 도움말도 갱신하고요.

WCAG 3.2.4 일관된 식별. 이는 WCAG 3.2.4 Consistent Identification(일관된 식별) 기준입니다 같은 기능을 하는 요소는 일관되게 식별(이름)돼야 한다는 거죠. 같은 ‘제출’ 기능 버튼이 페이지마다 다른 이름이면 안 됩니다.

용어 일관성의 효과:

요소 식별 — 같은 이름이면 — 사용자가 도움말의 지칭과 화면 요소를 즉시 매칭하죠.

학습 전이 — 한 번 익힌 용어를 — 다른 서비스에도 적용합니다(인지 부담 감소).

신뢰 — 일관된 용어는 — 서비스가 정돈돼 있다는 신뢰를 줍니다.

텍스트 목록·도움 패널 일관성과 통함. 텍스트 목록 일관 어투(CP-249), 도움 패널 제목 일치(CP-338) 등 — 일관성 규칙들의 서비스 전반 적용입니다.

이 규칙은 도움 패턴의 ’용어 일관성’을 담당합니다 — 같은 대상을 같은 이름으로 지칭해(021), 도움말과 화면이 일치 하고 사용자가 요소를 정확히 찾게 하죠.

정리하면 — 도움말의 지칭과 화면 요소 이름이 다르면 사용자가 못 찾고 혼란스러우므로, 같은 페이지·버튼을 모든 서비스 에서 동일한 텍스트로 일관되게 지칭해야 합니다.

3. 점검 / 개선

무엇을 점검하나

화면-도움말 일치 — 도움말이 지칭하는 이름이 화면 요소의 실제 이름과 일치하는가.

서비스 간 일관 — 같은 기능을 모든 서비스에서 같은 이름으로 부르는가.

용어 사전 — 용어 일관성을 관리하는가(WCAG 3.2.4).

개선 방향

같은 페이지·버튼·기능을 동일 이름으로 통일. 화면-도움말 일치.

용어 사전으로 일관 관리. 화면 변경 시 도움말 갱신.

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

역할	책임
콘텐츠/UX	용어 사전·일관 이름
퍼블리셔/개발	화면-도움말 이름 일치 구현

기관 유형	BP-021 적용
중앙행정기관(대표·운영) / 공공기관 / 지자체	✅ 필수

여러 페이지·서비스를 운영하는 모든 사이트가 해당됩니다.

5. 30초 자가진단 + FAQ

✅ 30초 자가진단

□ 도움말이 지칭하는 이름이 화면 요소의 실제 이름과 일치하나요?

□ 같은 기능을 모든 서비스에서 같은 이름으로 부르나요?

□ 용어 일관성을 관리하나요(용어 사전)?

❓ FAQ

Q1. 같은 버튼을 다른 이름으로 부르면 왜 안 되나요? 사용자가 도움말의 ’제출 버튼’을 화면의 ’신청하기’와 매칭 못 해 못 찾습니다. 같은 이름이어야 하죠. Q2. 다양한 표현이 풍부하지 않나요? 같은 대상엔 같은 이름이 명확합니다. 다양한 표현은 혼란을 키우죠(WCAG 3.2.4 일관된 식별). Q3. 어떻게 일관성을 관리하나요? 용어 사전을 만들어 같은 개념엔 같은 용어를 적용하고, 화면 변경 시 도움말도 갱신합니다.

6. 마무리

BP-021의 메시지:

같은 걸 같은 이름으로 — 동일한 페이지·버튼 이름을 모든 서비스에서 동일하게 사용하라.

도움말 지칭과 화면 요소 이름이 다르면 사용자가 못 찾고 혼란스럽습니다. 같은 대상을 동일한 텍스트로 일관되게 지칭 하는 게 핵심이죠. 다음 편은 관련 링크 새 탭입니다.

다음 편 예고 ▶ 「588. (BP-022) [공통] 관련 화면/리소스 링크는 새 탭에서 화면이 연결되도록 제공하고 있다.」

ViewCheck는 페이지·버튼 이름이 일관되게 사용되는지를 진단합니다.

📚 참고 출처

KRDS 기본 패턴 — 도움 가이드 — https://www.krds.go.kr/html/site/pattern/pattern_02.html

WCAG 2.1 SC 3.2.4 Consistent Identification — https://www.w3.org/WAI/WCAG21/Understanding/consistent-identification.html

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

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