기능
|
설명
|
---|---|
widgetProperties()
|
매쉬업의 모든 위젯에 대한 정보를 가져옵니다. 표시 이름 및 설명과 같은 정보를 읽어들입니다.
|
widgetEvents()
|
모든 위젯에 의해 노출되는 이벤트에 대한 정보를 가져옵니다.
|
widgetServices()
|
모든 위젯에 의해 노출되는 서비스에 대한 정보를 가져옵니다.
|
기능
|
설명
|
---|---|
afterload()
|
객체가 로드되고 파일에서 속성이 복원된 후 객체가 렌더링되기 전에 호출됩니다.
|
기능
|
설명
|
---|---|
renderHtml()
|
매쉬업 DOM 요소에 삽입되는 HTML 조각을 가져옵니다.
|
afterRender()
|
위젯을 나타내는 HTML 조각이 매쉬업 DOM 요소에 삽입되고, 위젯 콘텐츠를 포함하는 DOM 요소에 사용 가능한 요소 ID가 지정된 후에 호출됩니다. 그러면 DOM 요소를 조작할 준비가 된 것입니다.
|
기능
|
설명
|
---|---|
beforeSetProperty()
|
위젯 속성이 업데이트되기 전에 호출됩니다.
|
afterSetProperty()
|
위젯 속성이 업데이트된 후에 호출됩니다.
|
기능
|
설명
|
---|---|
beforeDestroy()
|
위젯의 DOM 요소가 제거되고 위젯이 상위 위젯에서 분리되고 할당 취소되기 전에 호출됩니다. 위젯의 수명 주기 동안 얻은 플러그인 및 이벤트 처리기와 같은 리소스를 확보해야 합니다.
|
속성
|
설명
|
---|---|
description
|
도구 설명으로 사용되는 위젯에 대한 설명입니다.
|
iconImage
|
위젯 아이콘 또는 이미지의 파일 이름입니다.
|
category
|
위젯을 사용할 수 있는 카테고리를 지정하는 문자열의 배열입니다.
예를 들어, 공통, 차트, 데이터, 컨테이너 등이 있습니다. 이를 사용하면 사용자가 위젯을 카테고리 유형별로 필터링할 수 있습니다.
|
isResizable
|
위젯의 크기를 조정할 수 있는지 지정합니다.
|
defaultBindingTargetProperty
|
데이터 또는 이벤트 바인딩 대상으로 사용해야 하는 속성의 이름입니다.
|
borderWidth
|
위젯에 테두리가 있는 경우 이 속성을 테두리 너비로 설정합니다. 이 속성은 개발 및 런타임 중에 픽셀이 완벽한 설계를 보장하는 데 도움이 됩니다.
예를 들어, 런타임 시 크기가 테두리 크기가 1픽셀인 10X10 픽셀이어야 하는 위젯의 경우 디자인 타임 시 위젯의 크기는 디자인 타임에 추가된 1픽셀을 처리하도록 8X8 픽셀이어야 합니다. 그러면 위젯 내부에 테두리가 배치되고 위젯 속성의 너비 및 높이가 정확하게 설정됩니다.
|
isContainer
|
위젯 인스턴스가 다른 위젯 인스턴스에 대한 컨테이너가 될 수 있는지 지정합니다. 유효한 값은 true 및 false입니다. 속성의 기본값은 false입니다.
|
customEditor
|
위젯 구성을 설정하고 편집하는 데 사용해야 하는 사용자 정의 편집기 대화 상자의 이름입니다. 위젯 프로젝트에서 이름이 TW.IDE.Dialogs.<name>인 대화 상자를 만듭니다.
|
customEditorMenuText
|
위젯의 플라이아웃 메뉴에 나타나는 텍스트입니다. 또한 ThingWorx Composer에서 위젯의 도구 설명으로 표시되는 텍스트이기도 합니다. 예를 들어, 그리드 열 구성입니다.
|
allowPositioning
|
위젯을 패널에 배치할 수 있는지 확인합니다. 유효한 값은 true 및 false입니다. 속성의 기본값은 true입니다.
|
supportsLabel
|
위젯이 레이블 속성을 지원하는지 지정합니다. 유효한 값은 true 및 false입니다. 속성의 기본값은 false입니다.
true로 설정하면 위젯에서 레이블 속성을 노출합니다. 이 속성은 ThingWorx Composer 및 런타임 시 위젯 옆에 표시되는 텍스트 레이블을 만드는 데 사용됩니다.
|
supportsAutoResize
|
위젯이 크기 조정을 자동으로 지원하는지 지정합니다. 유효한 값은 true 및 false입니다. 속성의 기본값은 false입니다.
true로 설정하면 위젯이 열, 행, 반응형 탭 및 반응형 매쉬업 등의 반응형 컨테이너에 배치될 수 있습니다.
|
properties
|
위젯이 매쉬업에 추가될 때 수정할 수 있는 위젯의 속성을 설명하는 위젯에 대한 JSON 객체의 컬렉션입니다. 이러한 속성은 속성 이름으로 사용되는 각 객체의 이름과 함께 Mashup Builder의 속성 창에 표시됩니다. 해당 속성은 속성 값이 설정되는 방법을 제어합니다.
예:
properties: {
Prompt: { defaultValue: 'Search for...', baseType: STRING, isLocalizable: true }, Width: { defaultValue: 120 }, Height: { defaultValue: 20, isEditable: false }, } |
속성
|
설명
|
||||
---|---|---|---|---|---|
description
|
도구 설명에 사용되는 위젯에 대한 설명입니다.
|
||||
baseType
|
위젯의 기본 유형입니다. 기본 유형 값이 FIELDNAME이면 위젯 속성 창에 인포테이블에서 사용할 수 있는 필드 목록이 표시됩니다. 필드는 기본 유형 제한에 따라 sourcePropertyName 값에 바인딩됩니다.
다른 특수 기본 유형은 다음과 같습니다.
• STATEDEFINITION - 상태 정의를 선택합니다.
• STYLEDEFINITION - 스타일 정의를 선택합니다.
• RENDERERWITHSTATE - 데이터 렌더러 및 상태 서식 적용을 선택할 수 있는 대화 상자를 표시합니다.
• STATEFORMATTING - 고정 스타일 또는 상태 기반 스타일을 선택할 수 있는 대화 상자를 표시합니다.
• VOCABULARYNAME - 런타임 시 데이터 태그 어휘를 선택합니다.
|
||||
mustImplement
|
기본 유형이 THINGNAME이고 mustImplement 속성을 지정하는 경우 Mashup Builder는 대화 상자에서 지정된 EntityType 및 EntityName을 구현하는 팝업만 열리도록 제한합니다. Mashup Builder는 QueryImplementingThings 함수를 호출하여 전달된 값이 EntityType 유형인지 검사하고 EntityName이 구현되었는지 확인합니다.
예:
'baseType': 'THINGNAME',
'mustImplement': { 'EntityType': 'ThingShapes', 'EntityName': 'Blog' } |
||||
baseTypeInfotableProperty
|
위젯의 기본 유형이 RENDERERWITHFORMAT으로 설정된 경우 이 속성은 구성에 사용되는 인포테이블의 속성을 지정합니다.
|
||||
sourcePropertyName
|
위젯의 기본 유형이 FIELDNAME으로 설정된 경우 이 속성은 구성에 사용되는 인포테이블의 속성을 확인합니다.
|
||||
baseTypeRestriction
|
이 속성을 지정하는 경우 값을 사용하여 FIELDNAME 드롭다운 목록에서 사용 가능한 필드를 제한합니다.
|
||||
tagType
|
기본 유형이 TAGS로 설정된 경우 이 속성은 태그 유형을 지정합니다. 유효한 값은 기본값인 DataTags 또는 ModelTags입니다.
|
||||
defaultValue
|
속성의 기본값을 설정하는 데 사용됩니다. 기본값은 undefined입니다.
|
||||
isBindingSource
|
속성이 데이터 바인딩 소스인지 지정합니다. 유효한 값은 true 및 false입니다. 속성의 기본값은 fasle입니다.
|
||||
isBindingTarget
|
속성이 데이터 바인딩 대상인지 지정합니다. 유효한 값은 true 및 false입니다. 속성의 기본값은 fasle입니다.
|
||||
isEditable
|
ThingWorx Composer에서 속성을 편집할 수 있는지 지정합니다. 유효한 값은 기본값인 true 및 false입니다.
|
||||
isVisible
|
속성 창에 속성이 표시되는지 지정합니다. 유효한 값은 true 및 false입니다. 속성의 기본값은 true입니다.
|
||||
isLocalizable
|
속성을 지역화할 수 있는지 지정합니다. 이 속성은 기본 유형이 STRING으로 설정된 경우에 필요합니다. 유효한 값은 true 및 false입니다.
|
||||
selectOptions
|
값 또는 표시 텍스트 구조의 배열입니다.
예:
[{value: ‘optionValue1’, text: ‘optionText1’},
{value: ‘optionValue2’, text: ‘optionText2’}] |
||||
warnIfNotBoundAsSource
|
ThingWorx Composer에서 속성이 데이터 바인딩 소스인지 확인합니다. 유효한 값은 true 및 false입니다.
속성 값이 true로 설정되었지만 속성이 바인딩되지 않은 경우 ThingWorx Composer에서 매쉬업을 저장하기 위해 완료해야 하는 항목 목록을 생성합니다.
|
||||
warnIfNotBoundAsTarget
|
Composer에서 속성이 데이터 바인딩 대상인지 확인합니다. 유효한 값은 true 및 false입니다.
속성 값이 true로 설정되었지만 속성이 바인딩되지 않은 경우 ThingWorx Composer에서 매쉬업을 저장하기 위해 완료해야 하는 항목 목록을 생성합니다.
|