7.1.1 기본 언어 표시

요구 사항

화면을 구성하는 텍스트 콘텐츠를 화면에 표시하거나 보조기술로 전달할 수 있도록, 콘텐츠에 적용되는 기본 언어를 정의해야 합니다.

개정 내역: 2025년 개정에서 새로 추가된 검사 항목입니다.

왜 필요한가요

화면낭독기와 점자정보단말기가 기본 언어를 올바르게 인식해 알맞은 음성 엔진과 점역 방법을 고를 수 있습니다.

도움받는 사용자

• 화면낭독기 사용자
• 점자정보단말기 사용자

적용 방법

네이티브 앱은 앱의 지역화 리소스(values-ko, ko.lproj)와 개발 언어 설정이 기본 언어 정보가 됩니다. 앱이 기기 언어와 다른 언어로 화면을 고정해 보여 준다면 그 언어를 명시합니다. 웹뷰 콘텐츠는 <html lang="ko">를 지정합니다.

<!-- res/xml/locales_config.xml + AndroidManifest android:localeConfig 로 지원 언어 선언 -->
<locale-config xmlns:android="http://schemas.android.com/apk/res/android">
    <locale android:name="ko"/>
    <locale android:name="en"/>
</locale-config>

// 앱 내 언어 설정을 쓰는 경우
AppCompatDelegate.setApplicationLocales(LocaleListCompat.forLanguageTags("ko"))

// Info.plist: CFBundleDevelopmentRegion = ko, 지역화(ko.lproj) 제공
// 화면 전체 언어를 지정해야 할 때
view.accessibilityLanguage = "ko-KR"

사례

개발 언어(en)만 설정, 한국어 문자열을 기본 리소스에 넣음
→ 일부 화면낭독기가 영어 음성으로 읽음

자주 하는 실수

• 앱의 기본 언어 정보와 실제 화면 언어가 달라 낭독 발음이 틀립니다.
• 웹뷰 문서에 lang 속성이 없습니다.

검사 방법

• TalkBack·VoiceOver로 화면을 읽어 기본 언어가 올바른 음성으로 낭독되는지 확인합니다.
• 앱의 지역화 설정(개발 언어, 리소스 폴더)과 웹뷰 문서의 lang 속성을 확인합니다.

다른 지침의 대응 항목