KWCAG 2.2 · 7.1.1

기본 언어 표시

html 요소에 lang 속성으로 페이지의 주 언어를 알려 화면 낭독기가 올바른 발음으로 읽게 하는 방법. lang 누락, 잘못된 값, 다른 언어로 된 부분 표시를 고치는 코드를 정리했습니다.

마지막 수정

무엇을 요구하나요?

페이지의 주로 사용하는 언어를 <html> 요소의 lang 속성으로 알려야 합니다. 화면 낭독기는 이 값을 보고 어떤 언어의 음성(발음 규칙)으로 읽을지 정합니다. 값이 없거나 틀리면 한국어 글을 영어 발음으로 읽어 알아들을 수 없게 됩니다.

자주 틀리는 예

1. lang이 없음

<!doctype html>
<html>
<!doctype html>
<html lang="ko">

2. 템플릿 기본값이 영어로 남아 있음

<html lang="en">
  <body><h1>회원가입</h1> …
<html lang="ko">
  <body><h1>회원가입</h1> …

해외 템플릿·프레임워크로 만든 사이트에서 매우 흔합니다. 프레임워크 설정(예: 레이아웃 파일, document 템플릿)에서 한 번에 바꾸세요.

3. 잘못된 값

lang="kr"(국가 코드), lang="korean", lang="ko_KR"(밑줄)은 올바른 언어 코드가 아닙니다. 한국어는 ko, 영어는 en처럼 언어 코드를 쓰세요.

4. 다른 언어로 된 부분

<p>Accessibility is essential for developers who want to reach everyone.</p>
<p lang="en">Accessibility is essential for developers who want to reach everyone.</p>

확인하는 방법

  1. 확장 프로그램 페이지 검사로 열린 페이지를 검사하면 lang 누락과 존재하지 않는 언어 코드(예: korean, ko_KR)를 찾아줍니다. kr은 다른 언어(카누리어)의 코드라서 일반적인 자동 검사 도구는 통과시키지만, 이 확장 프로그램은 따로 찾아줍니다.
  2. 페이지 소스 맨 위의 <html lang="…">을 직접 확인하세요. 모든 페이지가 같은 템플릿을 쓰는지도 확인합니다.
  3. 화면 낭독기로 읽어 한국어 발음으로 자연스럽게 읽히는지 들어보세요.

직접 점검해 보기

자주 묻는 질문

lang="ko-KR"과 lang="ko" 중 무엇을 써야 하나요?

둘 다 올바른 값입니다. 한국어 페이지라면 보통 ko를 씁니다. 중요한 것은 값이 페이지의 실제 주 언어와 맞는 것입니다.

본문 중 영어 문장에도 lang을 붙여야 하나요?

주 언어 표시가 이 항목의 핵심이지만, 다른 언어로 된 문단에 lang="en"처럼 표시해 주면 화면 낭독기가 그 부분을 알맞은 발음으로 읽어 더 좋습니다.

이 글은 셀프 점검을 돕는 안내이며 공식 해설이나 인증 심사 기준을 대신하지 않습니다. 정확한 기준은 한국형 웹 콘텐츠 접근성 지침 2.2 원문을 확인하세요.