샘플 ContextHub UI 모듈 유형

ContextHub는 솔루션에서 사용할 수 있는 몇 가지 샘플 UI 모듈을 제공합니다. 다음 정보가 제공됩니다.

• UI 모듈의 주요 기능입니다.
• 학습 목적으로 열 수 있도록 소스 코드를 찾을 위치.
• UI 모듈을 구성하는 방법입니다.

ContextHub에 UI 모듈 추가에 대한 자세한 내용은 UI 모듈 추가를 참조하십시오. UI 모듈 개발에 대한 자세한 내용은 ContextHub UI 모듈 유형 만들기를 참조하십시오.

contexthub.base UI 모듈 유형

contexthub.base UI 모듈 유형은 다른 모든 UI 모듈 유형의 기본 유형입니다. 따라서 저장소 데이터를 렌더링하기 위한 일반 기능을 제공합니다.

다음 기능을 사용할 수 있습니다.

• 제목 및 아이콘: UI 모듈의 제목과 아이콘을 지정합니다. 아이콘은 URL이나 Coral UI 아이콘 라이브러리를 사용하여 참조할 수 있습니다.
• 데이터 저장: 데이터를 검색할 저장소를 한 개 이상 식별합니다.
• 컨텐츠: ContextHub 도구 모음에 표시되는 대로 UI 모듈에 나타나는 컨텐츠를 지정합니다.
• 팝업 컨텐츠: UI 모듈을 클릭하거나 탭할 때 팝오버에 나타나는 컨텐츠를 지정합니다.
• 전체 화면 모드: 전체 화면 모드가 허용되는지 여부를 제어합니다.

소스 코드는 /libs/granite/contexthub/code/ui/container/js/ContextHub.UI.BaseModuleRenderer.js에 있습니다.

구성

JSON 형식의 Javascript 개체를 사용하여 contexthub.base UI 모듈을 구성합니다. 다음 속성 중 하나를 포함하여 UI 모듈 기능을 구성합니다.

• 이미지: 아이콘으로 표시할 이미지의 URL입니다.
• 아이콘: Coral UI 아이콘 클래스의 이름입니다. 아이콘과 이미지 속성 모두에 값을 지정하면 이미지가 사용됩니다.
• 제목: UI 모듈의 제목입니다. UI 모듈 아이콘 위에서 포인터가 일시 중지되면 제목이 나타납니다.
• fullscreen: UI 모듈이 전체 화면 모드를 지원하는지 여부를 나타내는 부울 값입니다. 전체 화면을 지원하려면 true 을 사용하고, 전체 화면 모드를 방지하려면 false 를 사용하십시오.
• 템플릿: ContextHub 🔗 도구 모음에서 렌더링할 컨텐츠를 지정하는 Handlebarstemplate입니다. 최대 두 개의 <p> 태그를 사용합니다.
• storeMapping: 키/저장소 매핑입니다. Handlebar 템플릿의 키를 사용하여 연결된 ContextHub 저장소 데이터에 액세스합니다.
• 목록: UI 모듈을 클릭할 때 팝오버에 목록으로 표시할 항목의 배열입니다. 이 항목을 포함하는 경우 popooverTemplate을 포함하지 마십시오. 값은 다음 키를 사용하는 개체 배열입니다.
  • 제목:이 항목에 대해 표시할 텍스트입니다
  • 이미지:(선택 사항) 왼쪽에 표시되어야 하는 이미지의 URL입니다
  • 아이콘:(선택 사항) 왼쪽에 표시되어야 하는 CUI 아이콘 클래스입니다.이미지가 지정된 경우 무시됩니다.
  • 선택:(선택 사항) 이 항목을 선택한 상태로 표시할지를 지정하는 부울 값입니다(true=selected). 기본적으로 선택한 항목은 굵은 글꼴을 사용하여 나타납니다. 다른 모양을 구성하려면 listType 속성을 사용합니다(아래 참조).
• listType: 팝오버 목록 항목에 사용할 스타일입니다. 다음 값 중 하나를 사용합니다.
  • 확인 표시
  • 확인란
  • 라디오
• popooverTemplate: UI 모듈을 클릭할 때 팝오버에서 렌더링할 컨텐츠를 지정하는 Handlebars 템플릿입니다. 이 항목을 포함하는 경우 list 항목을 포함하지 마십시오.

예

다음 예에서는 contexthub.emulators 저장소의 정보를 표시하도록 contexthub.base UI 모듈을 구성합니다. template 항목은 storeMapping 항목이 설정하는 키를 사용하여 저장소에서 데이터를 가져오는 방법을 보여 줍니다.

{
   "icon": "coral-Icon--move",
    "title": "Screen Resolution",
    "storeMapping": {
      "emulator": "emulators"
    },
    "template": "<p>{{{ i18n \"Resolution\"}}}</p><p>{{{emulator.currentDevice.width}}} x {{{emulator.currentDevice.height}}}</p>"
}

contexthub.browserinfo UI 모듈 유형

contexthub.browserinfo UI 모듈은 클라이언트 웹 브라우저 및 운영 체제에 대한 정보를 표시합니다. 정보는 contexthub.surferinfo 스토어 후보자를 기반으로 surferinfo store에서 얻습니다.

UI 모듈의 소스 코드는 /libs/granite/contexthub/components/modules/browserinfo에 있습니다. contexthub.browserinfo 은 contexthub.base UI 모듈을 확장하지만 이 모듈은 재정의하거나 추가 기능을 제공하지 않습니다. 이 구현에서는 브라우저 정보를 렌더링하기 위한 기본 구성을 제공합니다.

구성

contexthub.browserinfo UI 모듈의 인스턴스에는 세부 구성 값이 필요하지 않습니다. 다음 JSON 텍스트는 모듈의 기본 구성을 나타냅니다.

{
   "icon":"coral-Icon--globe",
   "title":"Browser/OS Information",
   "storeMapping":{"surferinfo":"surferinfo"},
   "template":"<p>{{surferinfo.browser.family}} {{surferinfo.browser.version}}</p><p>{{surferinfo.os.name}} {{surferinfo.os.version}}</p>"
}

contexthub.datetime UI 모듈 유형

contexthub.datetime UI 모듈은 contexthub.datetime 저장소 후보를 기반으로 하는 datetime이라는 저장소에 저장되는 날짜 및 시간을 표시합니다.

이 모듈은 저장소에서 날짜 및 시간을 변경할 수 있는 팝업 양식을 제공합니다.

contexthub.datetime UI 모듈의 소스는 /libs/granite/contexthub/components/modules/datetime에 있습니다.

구성

contexthub.datetime UI 모듈의 인스턴스에는 세부 구성 값이 필요하지 않습니다. 다음 JSON 텍스트는 모듈의 기본 구성을 나타냅니다.

{
   "icon":"coral-Icon--clock",
   "title":"DATE&TIME",
   "clickable":true,
   "storeMapping":{"d":"datetime"},
   "template":"<p class=\"contexthub-module-line1\">{{i18n \"Date&Time\"}}</p><p class=\"contexthub-module-line2\">{{d.formatted.locale.date}} {{d.formatted.locale.time}}</p>",
   "popoverTemplate":"<div class=\"datetime center\"><div class=\"coral-DatePicker-calendar\" data-init=\"datepicker\"><input class=\"coral-Textfield\" type=\"datetime\" value=\"{{d.formatted.iso}}\"><button class=\"coral-Button coral-Button--secondary coral-Button--square\" title=\"{{i18n \"Datetime picker\"}}\"><i class=\"coral-Icon coral-Icon--calendar coral-Icon--sizeS\"></i></button></div></div>"
}

contexthub.location UI 모듈 유형

contexthub.location UI 모듈은 클라이언트의 경도 및 위도를 표시합니다. 이 모듈은 현재 위치를 변경하기 위해 클릭할 수 있는 Google 맵을 표시하는 팝오버를 제공합니다. 이 모듈은 contexthub.geolocation 저장소 후보를 기반으로 하는 지리적 위치라는 ContextHub 저장소에서 정보를 가져옵니다.

UI 모듈의 소스는 /etc/cloudsettings/default/contexthub/geolocation에 있습니다.

구성

contexthub.location UI 모듈의 인스턴스에는 세부 구성 값이 필요하지 않습니다. 다음 JSON 텍스트는 모듈의 기본 구성을 나타냅니다.

{
 "icon":"coral-Icon--compass",
 "title":"Location",
 "clickable":true,
 "editable":{"key":"/geolocation","disabled":[],"hidden":["/geolocation/generatedThumbnail","/geolocation/city","/geolocation/country"]},
 "fullscreen":true,
 "storeMapping":{"g":"geolocation"},
 "template":"<p>{{i18n \"Location\"}}</p><p>{{g.address.postalCode}} {{g.address.city}}{{#if g.address.city}}{{#if g.address.region}},{{/if}}{{/if}} {{g.address.region}}</p>",
 "list":[
  {"title":"Basel, Switzerland",
  "data":{"longitude":7.58929,"latitude":47.554746,"city":"Basel","country":"Switzerland"}},
  {"title":"Melbourne, Australia",
  "data":{"longitude":144.96328,"latitude":-37.814107,"city":"Melbourne","country":"Australia"}},
  {"title":"Beijing, China",
  "data":{"longitude":116.407526,"latitude":39.90403,"city":"Beijing","country":"China"}},
  {"title":"New York, NY, USA",
  "data":{"longitude":-74.005973,"latitude":40.714353,"city":"New York","country":"United States"}},
  {"title":"Paris, France",
  "data":{"longitude":2.352222,"latitude":48.856614,"city":"Paris","country":"France"}},
  {"title":"Rio de Janeiro, Brazil",
  "data":{"longitude":-43.20071,"latitude":-22.913395,"city":"Rio","country":"Brazil"}},
  {"title":"San Jose, CA, USA",
  "data":{"longitude":-121.894955,"latitude":37.339386,"city":"San Jose","country":"United States"}},
  {"title":"Tokyo, Japan",
  "data":{"longitude":139.691706,"latitude":35.689487,"city":"Shinjuku","country":"Japan"}}
 ],
 "listType":"checkmark"
}

contexthub.screen-orientation UI 모듈 유형

contexthub.screen-orientation UI 모듈은 클라이언트의 현재 화면 방향을 표시합니다. 기본적으로 비활성화되어 있지만 이 모듈은 방향을 선택할 수 있는 팝오버를 제공합니다. 이 모듈은 granite.에뮬레이터 저장소 후보를 기반으로 하는 에뮬레이터라는 ContextHub 저장소에서 정보를 가져옵니다.

UI 모듈의 소스는 /libs/granite/contexthub/components/modules/screen-orientation에 있습니다.

구성

contexthub.screen-orientation UI 모듈의 인스턴스에는 세부 구성 값이 필요하지 않습니다. 다음 JSON 텍스트는 모듈의 기본 구성을 나타냅니다. 기본적으로 clickable 속성은 false입니다. clickable 을 true(으)로 설정하도록 기본 구성을 무시하면 모듈을 클릭하면 방향을 선택할 수 있는 팝업이 표시됩니다.

{
   "icon":"coral-Icon--rotateRight",
   "title":"Screen Orientation",
   "clickable":false,
   "storeMapping":{"emulator":"emulators"},
   "template":"<p>{{{ i18n \"Screen Orientation\" }}}</p><p>{{{ emulator.currentDevice.orientation }}}",
   "listReference":"/emulators/orientations",
   "listType":"checkmark"
}

contexthub.tagcloud UI 모듈 유형

contexthub.tagcloud UI 모듈에는 태그에 대한 정보가 표시됩니다. 도구 모음에서 UI 모듈은 태그 수를 보여줍니다. 팝업이 태그 클라우드와 새 태그를 추가하기 위한 텍스트 상자를 표시합니다. UI 모듈은 contexthub.tagcloud 저장소 후보를 기반으로 하는 tagcloud라는 ContextHub 저장소에서 정보를 가져옵니다.

UI 모듈의 소스는 /libs/granite/contexthub/components/modules/tagcloud에 있습니다.

구성

contexthub.tagcloud UI 모듈의 인스턴스에는 세부 구성 값이 필요하지 않습니다. 다음 JSON 텍스트는 모듈의 기본 구성을 나타냅니다.

{
   "icon":"coral-Icon--tag",
   "title":"TagCloud",
   "clickable":true,
   "storeMapping":{"t":"tagcloud"},
   "maxTags":20,
   "template":"<p class=\"contexthub-module-line1\">{{i18n \"TagCloud\"}}</p><p class=\"contexthub-module-line2\">{{stats.total}} {{i18n \"Tags\"}}</p>",
   "popoverTemplate":"<div class=\"contexthub-popover-content center\"><p class=\"stats\">{{stats.total}} {{i18n \"Tags\"}} | {{stats.hits}} {{i18n \"Hits\"}} | {{i18n \"Last tag\"}}: {{#if stats.recent}}{{stats.recent}}{{else}}{{i18n \"Unknown\"}}{{/if}}</p><p class=\"tagcloud\">{{#each tags}}<span class=\"tag{{this.weight}}\">{{this.name}}</span> {{/each}}</p><div class=\"coral-InputGroup\"><input type=\"text\" class=\"coral-InputGroup-input coral-Textfield tag-name\" placeholder=\"{{i18n \"Add a namespace:my/tag\"}}\" pattern=\"^[A-Za-z0-9_\\-]+(:[A-Za-z0-9_\\-\\/]+)?$\" title=\"{{i18n \"namespace:my/tag\"}}\"><span class=\"coral-InputGroup-button\"><button class=\"coral-Button coral-Button--secondary coral-Button--square contexthub-new-tag\" type=\"button\" title=\"{{i18n \"increment\"}}\"><i class=\"coral-Icon coral-Icon--sizeS coral-Icon--add\"></i></button></span></div></div>"
}

granite.profile UI 모듈 유형

granite.profile ContextHub UI 모듈은 현재 사용자의 표시 이름을 표시합니다. 팝업에서는 사용자의 로그인 이름을 표시하고 표시 이름의 값을 변경할 수 있습니다. UI 모듈은 granite.profile 저장소 후보를 기반으로 하는 프로필이라는 ContextHub 저장소에서 정보를 가져옵니다.

UI 모듈의 소스는 /libs/granite/contexthub/components/modules/profile에 있습니다.

구성

granite.profile UI 모듈의 인스턴스에는 세부 구성 값이 필요하지 않습니다. 다음 JSON 텍스트는 모듈의 기본 구성을 나타냅니다.

{
   "icon":"coral-Icon--user",
   "title":"Profile",
   "clickable":true,
   "editable":{
      "key":"/profile",
      "disabled":["/profile/authorizableId"],
      "hidden":["/profile/avatar","/profile/path"]},
   "storeMapping":{"p":"profile"},
   "template":"<p class=\"contexthub-module-line1\">{{i18n \"Persona\"}}</p><p class=\"contexthub-module-line2\">{{p.displayName}}</p>",
   "listType":"checkmark"
}