매쉬업 작성기 > 위젯 > 표준 위젯 > 메뉴 모음 위젯(테마 적용 가능)
메뉴 모음 위젯(테마 적용 가능)
* 
이 위젯은 미리 보기로 사용할 수 있는 웹 구성 요소입니다. 여기에는 현재 메뉴 위젯의 기능 하위 세트가 포함되어 있습니다. 향후 릴리즈에는 추가 기능과 마이그레이션 지원이 추가될 예정입니다.
메뉴 모음 위젯을 사용하여 여러 매쉬업 또는 페이지가 포함된 솔루션의 탐색 레이아웃을 생성합니다. 위젯은 탐색 링크를 사용자가 선택할 수 있는 항목 목록으로 표시합니다. 위젯의 각 항목을 구성하여 사용자가 매쉬업, 웹 페이지 또는 하위 메뉴로 이동하도록 할 수 있습니다. 위젯은 레이아웃에서 최상위 컨테이너의 왼쪽에 영구적으로 표시됩니다. 위젯을 사용하여 단일 수준 또는 여러 수준의 탐색이 포함된 메뉴를 생성할 수 있습니다. Composer에서 메뉴 엔티티를 생성하거나 데이터 기반 메뉴를 생성하는 데이터 서비스를 작성하여 메뉴 항목을 정의할 수 있습니다. 이렇게 하면 여러 페이지에 다양한 보기를 사용하여 보다 복잡한 매쉬업을 작성할 수 있습니다.
메뉴 항목을 정의하고 위젯을 사용하여 포함된 매쉬업을 바꾸는 방법은 다음 비디오를 시청하십시오. 새 탭에서 비디오를 열려면 플레이어에서 제목을 클릭합니다.
Mashup Builder 위젯 외에도 메뉴 모음에는 다음 구성 요소가 포함됩니다.
MenuEntry 데이터 셰이프. 데이터 서비스의 메뉴 모음 구성에 대한 인포테이블을 정의하는 데 사용됩니다.
사전 구성된 레이아웃 컨테이너와 메뉴 모음 위젯이 포함된 매쉬업 및 마스터 레이아웃 템플릿. 이 템플릿을 사용하면 단순한 레이아웃을 빠르게 생성할 수 있습니다.
알려진 문제
메뉴 엔티티 내에서 로그아웃으로 구성된 메뉴 항목은 ThingWorx 9.4 이상에서만 지원됩니다. 이전 버전에서 이 기능을 사용하려면 메뉴 위젯을 대신 사용합니다.
메뉴 설계 선택: 아코디언 및 계단식 메뉴
SubMenuType 속성을 사용하여 메뉴 모음에 여러 탐색 수준이 표시되는 방법을 제어하도록 위젯을 구성할 수 있습니다. 하위 메뉴는 다음 두 가지 방법 중 하나로 표시됩니다.
계단식 메뉴(기본값) - 오른쪽으로 열리며, 각 탐색 수준을 별개의 하위 메뉴로 표시합니다.
중첩 아코디언 섹션 - 세로로 열리며, 각 탐색 수준을 오른쪽을 들여 씁니다.
다음 이미지에서 왼쪽에는 기본 계단식 메뉴가, 오른쪽에는 중첩 아코디언 메뉴가 있습니다.
이러한 두 가지 메뉴 모음 위젯에서는 간단히 보기가 비활성화되며, 기본 및 보조 탐색 데이터 속성에 대해 동일한 메뉴 엔티티가 선택됩니다. 계단식 메뉴는 세 개의 섹션으로 나뉩니다. 최상위 섹션은 기본 탐색 항목을 표시하는 데 사용됩니다. 하단의 두 섹션에는 보조 탐색 항목과 바닥글이 표시됩니다. 아코디언 메뉴에서 바닥글 위에 표시되는 보조 탐색 항목은 기본 항목과 함께 하나의 섹션에 결합됩니다.
* 
바닥글 섹션은 메뉴 모음 유형의 영향을 받지 않습니다.
메뉴 모음 분석
여러 가지 방법으로 메뉴 모음 위젯을 구성할 수 있습니다. 다음 그림에서는 기본 구성인 계단식 메뉴로 메뉴를 보여줍니다.
1. 확장 및 축소 전환 버튼(선택 사항)
2. 기본 탐색 항목
3. 메뉴 모음의 너비를 늘리거나 줄이는 데 사용되는 끌기 핸들(선택 사항)
4. 보조 탐색 항목(선택 사항)
5. 바닥글 섹션(선택 사항)
위젯의 최상위 수준에 있는 항목은 세로로 나열됩니다. 위젯에는 현재 구성에 따라 메뉴 항목을 표시할 수 있는 여러 섹션이 포함되어 있습니다.
키보드 탐색 및 포커스
일반적인 바로 가기 키를 사용하여 메뉴 모음의 항목 간을 탐색할 수 있습니다. 이때 사용하는 키는 다음과 같습니다.
설명
Tab
SHIFT+TAB
확장/축소 버튼, 보조 및 기본 탐색 항목, 바닥글과 같은 위젯 내의 다음 섹션으로 포커스 상자를 이동합니다. 이전 섹션으로 포커스를 이동하려면 SHIFT+TAB을 누릅니다.
ENTER
스페이스바
하위 메뉴가 포함된 상위 항목을 확장하거나 축소합니다.
섹션을 열거나 닫습니다.
위쪽/아래쪽 화살표
현재 섹션의 다음 또는 이전 메뉴 항목에 포커스를 설정합니다.
오른쪽/왼쪽 화살표
현재 섹션의 다음 또는 이전 하위 메뉴 수준에 포커스를 설정합니다.
HOME
현재 섹션의 첫 번째 항목에 포커스를 설정합니다.
END
현재 섹션의 마지막 항목에 포커스를 설정합니다.
위젯 속성
다음 표에는 메뉴 모음 위젯의 속성이 나열되어 있습니다.
속성
설명
기본 유형
기본값
바인딩
로컬리제이션 가능 여부
AlwaysOpen
확장된 보기 모드와 간단히 보기 모드 간에 메뉴를 전환하는 데 사용되는 확장/축소 버튼을 숨깁니다. 간단히 보기 모드를 비활성화하려면 이 속성을 True로 설정합니다.
BOOLEAN
False
없음
N
DataSource
메뉴 모음 항목을 인포테이블을 사용하여 정의할지 또는 메뉴 엔티티를 사용하여 정의할지 여부를 지정합니다. 다음 옵션 중 하나를 선택할 수 있습니다.
메뉴 엔티티 - 표시할 메뉴 항목을 포함하는 메뉴 엔티티를 선택합니다. 메뉴 엔티티를 선택하려면 PrimaryNavMenuSecondaryNavMenu 속성을 사용합니다.
인포테이블 - 데이터 서비스의 메뉴 항목 정의가 포함된 인포테이블을 바인딩합니다. MenuEntry 데이터 셰이프를 사용하여 인포테이블의 형식을 지정해야 합니다. 메뉴 데이터를 바인딩하려면 PrimaryNavDataSecondaryNavData 속성을 사용합니다.
STRING
인포테이블
내부
N
DisableResizing
사용자가 실행 시간에 메뉴 모음의 너비를 변경할 수 있는 끌기 핸들을 제거합니다.
BOOLEAN
False
없음
N
Disabled
매쉬업에서 위젯을 비활성화합니다. 비활성화된 위젯은 표시되지만 대화식이 아닙니다.
BOOLEAN
False
내부
N
FooterIcon
바닥글 섹션에 표시할 아이콘입니다. 바닥글 아이콘은 계단식 메뉴와 아코디언을 비롯한 모든 메뉴 유형에 대해 표시됩니다.
IMAGE
해당 없음
없음
N
FooterLinkTargetWindow
바닥글 링크를 같은 창 또는 새 창에서 열 것인지 여부를 제어합니다. 같은 창 또는 새 창으로 설정할 수 있습니다.
STRING
같은 창
없음
N
FooterText
바닥글 섹션에 표시할 텍스트를 지정합니다.
STRING
해당 없음
내부
FooterURL
바닥글 링크를 클릭할 때 탐색할 URL을 설정합니다.
STRING
해당 없음
내부
N
FooterLogo
위젯을 확장할 때 바닥글 섹션에 표시할 로고입니다.
* 
ThingWorx 9.3 이상에서 사용할 수 있습니다.
IMAGE
해당 없음
없음
N
HideAlteranteIcons
메뉴 항목에 대한 사용자 정의 아이콘이 없을 때 자동으로 표시되는 대체 아이콘을 숨깁니다.
BOOLEAN
False
없음
N
HideFooter
메뉴 모음에서 바닥글 섹션을 숨깁니다.
BOOLEAN
False
내부
N
MashupControl
실행 시간에 메뉴 모음이 매쉬업 간을 탐색하는 방법을 제어합니다. 다음 옵션 중 하나를 선택할 수 있습니다.
현재 매쉬업 제어 - 전체 매쉬업을 대체합니다.
매쉬업 매개 변수에 바인딩 - 포함된 매쉬업만 대체됩니다. 포함된 매쉬업 위젯에 바인딩해야 하는 Mashup이라는 위젯 속성을 추가합니다.
STRING
현재 매쉬업 제어
없음
N
Mashup
메뉴 모음에서 현재 선택된 매쉬업의 이름을 포함하는 텍스트 속성입니다. 이 속성을 사용하여 포함된 매쉬업 위젯에 표시할 매쉬업을 지정합니다.
STRING
해당 없음
외부
N
MaxWidth
메뉴 모음의 최대 너비입니다. 이 속성은 메뉴 모음이 확장될 때 적용됩니다.
NUMBER
해당 없음
내부
N
MinWidth
메뉴 모음의 최소 너비입니다.
NUMBER
해당 없음
내부
N
PrimaryNavData
기본 탐색 섹션의 항목을 정의하는 인포테이블을 바인딩합니다. MenuEntry 데이터 셰이프를 사용하여 인포테이블의 형식을 지정해야 합니다.
INFOTABLE
해당 없음
내부
N
PrimaryNavIcons
메뉴 모음의 기본 탐색 항목에 대한 아이콘을 표시합니다. 아이콘은 선택한 메뉴 엔티티 또는 바인딩된 인포테이블에 정의됩니다.
IMAGE
False
없음
N
PrimaryNavMaxItems
기본 탐색 섹션에 표시되는 최대 항목 수를 설정합니다. 메뉴 엔티티에서 이보다 많은 항목은 오버플로 메뉴에 표시됩니다.
NUMBER
5
내부
N
SecondaryNavIcons
메뉴 모음의 보조 탐색 항목에 대한 아이콘을 표시합니다. 아이콘은 선택한 메뉴 엔티티 또는 바인딩된 인포테이블에 정의됩니다.
IMAGE
False
없음
N
SecondaryNavData
보조 탐색 항목에 대한 항목이 포함된 인포테이블을 바인딩합니다. MenuEntry 데이터 셰이프를 사용하여 인포테이블의 형식을 지정해야 합니다.
INFOTABLE
해당 없음
내부
N
ShowDataLoading
보조 탐색 섹션의 항목을 정의하는 인포테이블을 바인딩합니다. MenuEntry 데이터 셰이프를 사용하여 인포테이블의 형식을 지정해야 합니다.
BOOLEAN
True
없음
N
StayOpenOnSelection
메뉴 모음에 있는 항목을 선택할 때는 아코디언 섹션을 열어둡니다.
* 
ThingWorx 9.3.3 이상에서 사용할 수 있습니다.
BOOLEAN
False
없음
N
SubMenuMaxWidth
계단식 하위 메뉴의 최대 너비입니다.
NUMBER
해당 없음
없음
N
SubMenuMinWidth
계단식 하위 메뉴의 최소 너비입니다.
NUMBER
해당 없음
없음
N
SubMenuType
위젯에 여러 수준의 탐색이 포함되어 있을 때 메뉴 항목의 표시 방식을 제어합니다.
계단식 메뉴
중첩 아코디언
STRING
계단식 메뉴
내부
N
TabSequence
Tab 키를 누를 때 위젯의 시퀀스 번호입니다.
NUMBER
해당 없음
없음
N
Visible
메뉴 모음 위젯의 표시 유형을 제어합니다.
BOOLEAN
True
내부
N
도움이 되셨나요?