사용자 인터페이스 요소의 로컬라이제이션

eCatalog Viewer에 표시되는 특정 컨텐츠는 확대/축소 단추, 페이지 변경 단추, 축소판 단추, 전체 화면 단추, 닫기 단추 및 스크롤 막대 단추 등 로컬라이제이션의 적용을 받습니다.

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

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

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

이러한 현지화 객체의 예:

{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
 },
 "fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}

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

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

다음 기호가 지원됩니다(containerId가 뷰어 컨테이너의 ID라고 가정).

기호

도구 설명...

Container.LABEL

최상위 뷰어 요소에 대한 ARIA 레이블입니다.

PageView.ROLE_DESCRIPTION

기본 보기 구성 요소에 대한 ARIA 역할 설명입니다.

PageView.USAGE_HINT

키보드 사용자에 대한 ARIA 사용 힌트입니다.

CloseButton.TOOLTIP

닫기 단추.

ZoomInButton.TOOLTIP

확대 단추.

ZoomOutButton.TOOLTIP

축소 단추.

ZoomResetButton.TOOLTIP

확대/축소 재설정 단추.

FullScreenButton.TOOLTIP_SELECTED

일반 상태의 전체 화면 단추.

FullScreenButton.TOOLTIP_UNSELECTED

전체 화면 상태의 전체 화면 단추.

ScrollUpButton.TOOLTIP

위로 스크롤합니다.

ScrollDownButton.TOOLTIP

아래로 스크롤합니다.

<containerid>_rightButton.PanRightButton.TOOLTIP

큰 다음 페이지 단추.

<containerid>_leftButton.PanLeftButton.TOOLTIP

큰 이전 페이지 단추.

<containerid>_lastPageButton.PanRightButton.TOOLTIP

마지막 페이지 단추.

<containerid>_secondaryLastPageButton.PanRightButton.TOOLTIP

마지막 페이지 단추.

<containerid>_firstPageButton.PanLeftButton.TOOLTIP

첫 번째 페이지 단추.

<containerid>_secondaryFirstPageButton.PanLeftButton.TOOLTIP

첫 번째 페이지 단추.

<containerid>_toolBarRightButton.PanRightButton.TOOLTIP

다음 페이지 단추.

<containerid>_toolBarLeftButton.PanLeftButton.TOOLTIP

이전 페이지 단추.

ThumbnailPageButton.TOOLTIP_SELECTED

축소판 모드의 축소판 그림 단추

ThumbnailPageButton.TOOLTIP_UNSELECTED

일반 모드의 축소판 단추

CloseButton.TOOLTIP

닫기 단추.

InfoPanelPopup.TOOLTIP_CLOSE

정보 패널 닫기 단추.

SocialShare.TOOLTIP

소셜 공유 도구.

EmailShare.TOOLTIP

전자 메일 공유 단추입니다.

EmailShare.HEADER

이메일 대화 상자 헤더.

EmailShare.TOOLTIP_HEADER_CLOSE

전자 메일 대화 상자의 오른쪽 상단 닫기 단추입니다.

EmailShare.INVALID_ADDRESSES

전자 메일 주소의 형식이 잘못된 경우 표시되는 오류 메시지입니다.

EmailShare.TO

받는 사람 입력 필드에 대한 레이블입니다.

EmailShare.TOOLTIP_ADD

다른 이메일 주소 추가 단추.

EmailShare.ADD

다른 이메일 주소 추가 단추.

EmailShare.FROM

입력 필드에서.

EmailShare.MESSAGE

메시지 입력 필드.

EmailShare.TOOLTIP_REMOVE

이메일 주소 제거 단추.

EmailShare.CANCEL

취소 단추에 대한 캡션입니다.

EmailShare.TOOLTIP_CANCEL

취소 단추.

EmbedShare.ACTION

모두 선택 단추에 대한 캡션입니다.

EmbedShare.TOOLTIP_ACTION

모두 선택 단추.

EmailShare.CLOSE

양식을 제출한 후 대화 상자 하단에 표시되는 닫기 단추에 대한 캡션입니다.

EmailShare.TOOLTIP_CLOSE

양식을 제출한 후 대화 상자 하단에 표시되는 닫기 단추입니다.

EmailShare.ACTION

양식 제출 단추에 대한 캡션.

EmailShare.TOOLTIP_ACTION

양식 제출 단추입니다.

EmailShare.SEND_SUCCESS

전자 메일을 성공적으로 보냈을 때 확인 메시지가 표시됩니다.

EmailShare.SEND_FAILURE

이메일을 성공적으로 보내지 못할 때 표시되는 오류 메시지입니다.

EmbedShare.TOOLTIP

포함 공유 단추입니다.

EmbedShare.HEADER

포함 대화 상자 헤더.

EmbedShare.TOOLTIP_HEADER_CLOSE

포함 대화 상자의 오른쪽 상단 닫기 단추입니다.

EmbedShare.DESCRIPTION

포함 코드 텍스트에 대한 설명입니다.

EmbedShare.EMBED_SIZE

포함 크기 콤보 상자의 레이블입니다.

EmbedShare.CANCEL

취소 단추에 대한 캡션입니다.

EmbedShare.TOOLTIP_CANCEL

취소 단추.

EmbedShare.CUSTOM_SIZE

포함 크기 콤보 상자의 마지막 "사용자 지정 크기" 항목에 대한 텍스트입니다.

LinkShare.TOOLTIP

링크 공유 단추입니다.

LinkShare.HEADER

링크 대화 상자 헤더입니다.

LinkShare.TOOLTIP_HEADER_CLOSE

링크 대화 상자의 오른쪽 상단 닫기 단추입니다.

LinkShare.DESCRIPTION

공유 링크에 대한 설명입니다.

LinkShare.CANCEL

취소 단추에 대한 캡션입니다.

LinkShare.TOOLTIP_CANCEL

취소 단추.

LinkShare.ACTION

모두 선택 단추에 대한 캡션입니다.

LinkShare.TOOLTIP_ACTION

모두 선택 단추.

FacebookShare.TOOLTIP

Facebook 공유 단추.

TwitterShare.TOOLTIP

Twitter 공유 단추.

Print.TOOLTIP

인쇄 단추.

Print.HEADER

대화 상자 헤더 인쇄

Print.TOOLTIP_HEADER_CLOSE

[인쇄] 대화 상자 오른쪽 상단 닫기 단추

Print.PRINT_RANGE

"인쇄 페이지 선택" 섹션의 레이블입니다.

Print.PRINT_RANGE_CURRENT

"현재 페이지" 라디오 단추에 대한 캡션입니다.

Print.PRINT_RANGE_FROM

"다음에서 범위 확산" 라디오 단추에 대한 캡션입니다.

Print.PRINT_RANGE_TO

끝 숫자 선택기의 캡션.

Print.PRINT_RANGE_ALL

모든 페이지 라디오 단추에 대한 캡션입니다.

Print.PAGE_HANDLING

"페이지 처리" 섹션의 레이블입니다.

Print.PAGE_HANDLING_ONE

"시트당 1페이지" 라디오 단추에 대한 캡션입니다.

Print.PAGE_HANDLING_TWO

"시트당 2페이지" 라디오 단추에 대한 캡션입니다.

Print.CANCEL

취소 단추에 대한 캡션입니다.

Print.TOOLTIP_CANCEL

취소 단추.

Print.ACTION

인쇄로 보내기 단추에 대한 캡션

Print.TOOLTIP_ACTION

인쇄로 보내기 단추.

즐겨찾기 메뉴.도구 설명

즐겨찾기 메뉴 단추.

AddFavoriteButton.TOOLTIP_SELECTED

즐겨찾기 편집 모드에서 "즐겨찾기 추가" 단추를 클릭합니다.

AddFavoriteButton.TOOLTIP_UNSELECTED

일반 모드에서 "즐겨찾기 추가" 단추를 클릭합니다.

RemoveFavoriteButton.TOOLTIP_SELECTED

즐겨찾기 편집 모드에서 "즐겨찾기 제거" 단추

RemoveFavoriteButton.TOOLTIP_UNSELECTED

일반 모드에서 "즐겨찾기 제거" 단추를 클릭합니다.

보기AllFavoriteButton.TOOLTIP_SELECTED

즐겨찾기 보기가 활성 상태일 때 "모든 즐겨찾기 보기" 단추를 클릭합니다.

보기AllFavoriteButton.TOOLTIP_UNSELECTED

즐겨찾기 보기가 비활성화되어 있으면 "모든 즐겨찾기 보기" 단추가 표시됩니다.

즐겨찾기 효과.도구 설명

단일 즐겨찾기 아이콘.

MediaSet.LABEL_XX[_YY]

로드 시 뷰어가 생성하는 페이지 레이블입니다.

해당 심볼의 이름은 템플릿입니다. 여기서 XX 는 가로 방향으로 0을 기반으로 하는 스프레드 색인이고, 선택적 YY XX 에 의해 타깃팅된 스프레드 내에 0을 기반으로 하는 페이지 색인입니다.

처음 로드된 자산에 대해서만 적용됩니다. setAsset() API 호출을 사용하여 자산이 변경되는 경우 무시됩니다.

MediaSet.LABEL_DELIM

스프레드 내의 왼쪽 및 오른쪽 페이지에 대해 레이블이 정의될 경우 페이지 레이블 구분 기호로 사용되는 문자입니다.

ScrollLeftRightButton.TOOLTIP_SELECTED

기본 컨트롤 막대에서 왼쪽으로 스크롤합니다.

ScrollLeftRightButton.TOOLTIP_UNSELECTED

기본 컨트롤 모음 오른쪽 스크롤 단추.

SearchPanel.PLACEHOLDER

사용자가 검색 텍스트를 입력하기 전에 검색 입력 상자 내에 표시된 현지화된 프롬프트.

SearchPanel.INFO_PROMPT

검색 패널을 처음 열 때 현지화된 메시지가 표시되어 사용자가 검색을 수행하도록 제안합니다.

SearchPanel.INFO_NO_RESULTS

검색이 결과를 반환하지 않을 때 현지화된 메시지가 표시됩니다.

이 기호는 다음과 같은 런타임 대체 토큰을 지원합니다. $SEARCH_TEXT$ . 구성 요소는 사용자가 입력한 검색 텍스트로 대체합니다.

SearchPanel.INFO_RESULTS

검색이 성공적으로 완료되고 하나 이상의 결과를 반환하는 경우 지역화된 메시지가 표시됩니다.

이 기호는 다음과 같은 런타임 대체 토큰을 지원합니다.

  • $SEARCH_TEXT$ - 사용자가 입력한 검색 텍스트입니다.
  • $HIT_COUNT$ - 검색된 총 검색 히트 수입니다.
  • $PAGE_COUNT$ - 하나 이상의 검색 히트가 포함된 카탈로그 페이지의 수입니다.

SearchPanel.THUMBNAIL_LABEL

검색 패널의 결과 축소판에 대한 현지화된 레이블입니다.

이 기호는 다음과 같은 런타임 대체 토큰을 지원합니다.

  • $PAGE$ - 페이지 번호.
  • $PAGE_HIT_COUNT$ - 페이지에서 검색된 검색 결과 수입니다.

SearchPanel.LABEL

전체 검색 패널에 대한 aria-label ARIA 속성의 값을 정의합니다.

이 페이지에서는