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

마지막 업데이트: 2023-11-03
  • 작성 대상:
  • Developer
    User

확대/축소 단추, 페이지 변경 단추, 썸네일 단추, 전체 화면 단추, 닫기 단추 및 스크롤 막대 단추를 포함하여 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 속성입니다.

이 페이지에서는