기본 언어 표시
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>
확인하는 방법
- 확장 프로그램 페이지 검사로 열린 페이지를 검사하면 lang 누락과 존재하지 않는 언어 코드(예:
korean,ko_KR)를 찾아줍니다.kr은 다른 언어(카누리어)의 코드라서 일반적인 자동 검사 도구는 통과시키지만, 이 확장 프로그램은 따로 찾아줍니다. - 페이지 소스 맨 위의
<html lang="…">을 직접 확인하세요. 모든 페이지가 같은 템플릿을 쓰는지도 확인합니다. - 화면 낭독기로 읽어 한국어 발음으로 자연스럽게 읽히는지 들어보세요.
직접 점검해 보기
- 페이지 검사 — 확장 프로그램으로 열린 페이지에서 이 항목과 관련된 문제를 찾습니다
- 수동 점검표 — 33개 항목을 직접 확인하고 기록합니다
- 자주 틀리는 10개 항목 맛보기 점검표 — 무료 엑셀
자주 묻는 질문
lang="ko-KR"과 lang="ko" 중 무엇을 써야 하나요?
둘 다 올바른 값입니다. 한국어 페이지라면 보통 ko를 씁니다. 중요한 것은 값이 페이지의 실제 주 언어와 맞는 것입니다.
본문 중 영어 문장에도 lang을 붙여야 하나요?
주 언어 표시가 이 항목의 핵심이지만, 다른 언어로 된 문단에 lang="en"처럼 표시해 주면 화면 낭독기가 그 부분을 알맞은 발음으로 읽어 더 좋습니다.
함께 보면 좋은 항목
이 글은 셀프 점검을 돕는 안내이며 공식 해설이나 인증 심사 기준을 대신하지 않습니다. 정확한 기준은 한국형 웹 콘텐츠 접근성 지침 2.2 원문을 확인하세요.