사용자 인터페이스 요소의 현지화 localization-of-user-interface-elements

확대/축소 단추, 페이지 변경 단추, 썸네일 단추, 전체 화면 단추, 닫기 단추 및 스크롤 막대 단추를 포함하여 eCatalog 뷰어에 표시되는 특정 컨텐츠는 현지화가 적용됩니다.

현지화할 수 있는 뷰어의 모든 텍스트 콘텐츠는 SYMBOL이라는 특수한 뷰어 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) 메서드를 사용합니다.

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

기호
다음에 대한 도구 설명...
Container.LABEL
최상위 뷰어 요소에 대한 ARIA 레이블입니다.
PageView.역할 설명
기본 보기 구성 요소에 대한 ARIA 역할 설명입니다.
PageView.USAGE_HINT
키보드 사용자에 대한 ARIA 사용 힌트입니다.
CloseButton.TOOLTIP
닫기 단추.
ZoomInButton.TOOL팁
확대 단추.
ZoomOutButton.TOOL팁
축소 단추.
ZoomResetButton.TOOLTIP
확대/축소 재설정 단추.
FullScreenButton.TOOLS_SELECTED
정상 상태의 전체 화면 단추.
FullScreenButton.TOOLS_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.TOOL팁_CLOSE
정보 패널 닫기 단추.
SocialShare.TOOLTIP
소셜 공유 도구입니다.
EmailShare.TOOLS 팁
이메일 공유 단추.
EmailShare.HEADER
이메일 대화 상자 헤더입니다.
EmailShare.TOOLTIP_HEADER_CLOSE
이메일 대화 상자 오른쪽 위 닫기 단추.
EmailShare.INVALID_ADDRESSS
이메일 주소 형식이 잘못된 경우에 표시되는 오류 메시지.
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.TOOLS_CANCEL
취소 단추.
EmbedShare.CUSTOM_SIZE
포함 크기 콤보 상자의 마지막 "사용자 지정 크기" 항목에 대한 텍스트입니다.
LinkShare.TOOLTIP
링크 공유 단추.
LinkShare.HEADER
링크 대화 상자 헤더.
LinkShare.TOOLTIP_HEADER_CLOSE
링크 대화 상자 오른쪽 위 닫기 단추.
LinkShare.DESCRIPTION
공유 링크에 대한 설명입니다.
LinkShare.CANCEL
취소 단추의 캡션입니다.
LinkShare.TOOLS_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.TOOLS_CANCEL
취소 단추.
Print.ACTION
인쇄로 보내기 단추의 캡션
Print.TOOLTIP_ACTION
인쇄로 보내기 단추.
즐겨찾기 메뉴.툴팁
즐겨찾기 메뉴 단추.
AddFavoriteButton.TOOLS_SELECTED
즐겨찾기 편집 모드의 "즐겨찾기 추가" 버튼.
AddFavoriteButton.TOOLTIP_UNSELECTED
일반 모드에서 "즐겨찾기를 추가합니다." 단추
RemoveFavoriteButton.TOOLS_SELECTED
즐겨찾기 편집 모드에서 "즐겨찾기 제거" 버튼
RemoveFavoriteButton.TOOLTIP_UNSELECTED
일반 모드에서 "즐겨찾기를 제거합니다" 단추
ViewAllFavoriteButton.TOOLTIP_SELECTED
즐겨찾기 보기가 활성화된 경우 "모든 즐겨찾기 보기" 버튼
ViewAllFavoriteButton.TOOLTIP_UNSELECTED
즐겨찾기 보기가 비활성화되어 있을 때 "모든 즐겨찾기 보기" 버튼을 클릭합니다.
FavoritesEffect.TOOL팁
단일 즐겨찾기 아이콘.
MediaSet.LABEL_XX[_YY]

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

해당 기호의 이름은 템플릿입니다. 여기서 XX 는 가로 방향의 0부터 시작하는 스프레드 인덱스이며 선택 사항입니다 YY 은(는) 다음에 의해 타겟팅된 스프레드 내의 0을 기반으로 하는 페이지 색인입니다. XX .

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

MediaSet.LABEL_DELIM
스프레드 내의 왼쪽 및 오른쪽 페이지에 대해 대소문자 레이블을 정의할 때 페이지 레이블 구분 기호로 사용되는 문자입니다.
ScrollLeftRightButton.TOOLTIP_SELECTED
주 제어 막대 스크롤 왼쪽 단추.
ScrollLeftRightButton.TOOLTIP_UNSELECTED
기본 컨트롤 막대 오른쪽으로 스크롤 단추.
SearchPanel.플레이스홀더
사용자가 검색 텍스트 입력을 시작하기 전에 검색 입력 상자 내에 현지화된 프롬프트가 표시됩니다.
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 레이블 전체 검색 패널에 대한 ARIA 속성입니다.
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8