사용자 인터페이스 요소의 현지화

마지막 업데이트: 2024년 7월 22일
  • 주제:

작성 대상:

  • 개발자
  • 사용자

슬라이드 뷰어가 표시하는 특정 컨텐츠는 현지화가 적용됩니다. 이 콘텐츠에는 슬라이드 탐색 버튼이 포함되어 있습니다.

현지화할 수 있는 뷰어의 모든 텍스트 콘텐츠는 SYMBOL이라는 특수한 뷰어 SDK 식별자에 의해 표현됩니다. 모든 SYMBOL에는 기본 뷰어와 함께 제공되는 영어 로케일("en")에 대한 기본 관련 텍스트 값이 있으며, 필요한 만큼 로케일에 대해 사용자 정의 값이 설정되어 있을 수도 있습니다.

뷰어가 시작되면 현재 로케일을 확인하여 해당 로케일에 대해 지원되는 각 SYMBOL에 대한 사용자 정의 값이 있는지 확인합니다. 있는 경우 사용자 정의 값을 사용하고, 그렇지 않은 경우 기본 텍스트로 돌아갑니다.

사용자 정의 로컬라이제이션 데이터를 로컬라이제이션 JSON 개체로 뷰어에 전달할 수 있습니다. 이러한 객체에는 지원되는 로케일 목록, 각 로케일에 대한 SYMBOL 텍스트 값 및 기본 로케일이 포함됩니다.

이러한 현지화 객체의 예는 다음과 같습니다.

{
"en":{
"PanLeftButton.TOOLTIP":"Left",
"PanRightButton.TOOLTIP":"Right"
 },
 "fr":{
"PanLeftButton.TOOLTIP":"Gauchiste",
"PanRightButton .TOOLTIP":"Droit"
},
defaultLocale:"en"
}

위의 예에서 로컬라이제이션 개체는 두 개의 로케일("en" 및 "fr")을 정의하고 각 로케일에서 두 개의 사용자 인터페이스 요소에 대한 로컬라이제이션을 제공합니다.

웹 페이지 코드는 구성 개체의 localizedTexts 필드 값으로 지역화 개체를 뷰어 생성자에 전달해야 합니다. 다른 방법은 setLocalizedTexts(localizationInfo) 메서드를 호출하여 현지화 개체를 전달하는 것입니다.

지원되는 기호는 다음과 같습니다.

기호다음에 대한 도구 설명...
PlayPauseButton.TOOLTIP_SELECTED재생 일시 중지 단추 상태를 선택했습니다.
PlayPauseButton.TOOLTIP_UNSELECTED재생 일시 중지 단추 상태를 선택하지 않았습니다.
CAROUSELVIEWER_TOOLTIP_GOTO

이전 및 다음 슬라이드 단추에 대한 도구 설명 및 ARIA 레이블입니다.

두 개의 대체 토큰( $CURRENT_FRAME$ (현재 슬라이드 인덱스)과 $TOTAL_FRAMES$ (총 슬라이드 수)을 허용합니다.

Container.LABEL최상위 뷰어 요소에 대한 ARIA 레이블입니다.
CarouselView.ROLE_DESCRIPTION기본 보기 구성 요소에 대한 ARIA 역할 설명입니다.
CarouselView.USAGE_HINT키보드 사용자에 대한 ARIA 사용 힌트입니다.

Experience Manager