태그 클라우드 위젯
태그 클라우드 위젯은 태그 사용을 시각화하는 방법을 제공합니다. 태그가 많이 사용될수록 클라우드에 더 크게 표시됩니다. 태그 클라우드 위젯은 사용 계산을 수행하지 않습니다. 태그 사용은 서버에서 계산됩니다. 효율성을 높이기 위해 태그 클라우드에는 2열 데이터 집합인 ['tag label', 'tag count']가 필요합니다. 태그 수에 따라 태그 레이블이 렌더링됩니다.
태그 클라우드는 다음과 같은 옵션을 제공합니다.
• 렌더링된 태그에 고정 스타일을 적용(예: 모든 태그를 빨간색, 기울임꼴로 표시)하거나 상태 정의에 따라 스타일을 적용할 수 있습니다.
• 클릭/선택한 태그에 스타일을 적용할 수 있습니다.
• 바인딩 가능한 클릭 이벤트를 사용할 수 있습니다. 사용자가 태그를 클릭하거나 데이터 집합의 선택한 행이 업데이트되면 클릭 이벤트가 브로드캐스트됩니다.
• 사용자가 태그를 클릭하거나 데이터 집합의 선택한 행이 업데이트되면 태그 클라우드가 바인딩 가능한 SelectedTag 속성을 일치하는 태그로 채웁니다.
• 가장 많이 사용되는 태그가 렌더링되는 크기(CSS em 길이)를 지정할 수 있습니다.
• 태그 클라우드 데이터 집합의 열에 따라 각 태그에 대한 도구 설명을 표시할 수 있습니다.
• 태그 클라우드는 본질적으로 바인딩된 데이터 집합의 선택한 행 업데이트 이벤트를 수신합니다. 따라서 SelectedTag 속성은 태그 클라우드 내에서 명시적인 작업 없이 업데이트 및 다시 렌더링(SelectedTagStyle이 정의된 경우)할 수 있습니다.
자세한 내용은 다음 비디오 자습서를 참조하십시오.
속성
공통 위젯 속성에 대한 자세한 내용은
위젯을 참조하십시오. 태그 클라우드 위젯에 관련된 속성은 아래 표에 설명되어 있습니다.
속성 이름 | 설명 | 기본 유형 | 기본값 | 바인딩 가능 여부 (Y/N) | 로컬리제이션 가능 여부 (Y/N) |
---|
CustomClass | 위젯의 최상위 div에 적용할 사용자 정의 CSS 클래스입니다. 여러 클래스를 공백으로 구분하여 입력할 수 있습니다. | STRING | 해당 없음 | Y | N |
Data | 위젯에 바인딩된 태그 데이터입니다. | INFOTABLE | 해당 없음 | Y | N |
MaxFontSize | 클라우드에서 가장 큰 태그의 크기(CSS em 길이)입니다. 이 크기에서 다른 모든 태그 크기 배율이 하향 조정됩니다. | NUMBER | 4 | N | N |
DisplayToolTip | 각 태그 링크에 대해 도구 설명을 표시하도록 설정합니다. | BOOLEAN | false | N | N |
ToolTipField | DisplayToolTip이 선택되거나 true인 경우 도구 설명 값을 나타내는 인포테이블 필드입니다. 데이터 속성을 바인딩해야 합니다. | FIELDNAME | 개수 | N | N |
TagStateStyle | 서식 적용된 상태 또는 지정된 스타일을 기준으로 렌더링된 태그의 스타일을 설정합니다. 기본적으로 태그 클라우드는 개수에 따라 태그 링크에 대한 스타일을 설정합니다(개수가 높을수록 글꼴 크기가 커짐). 각 태그에 대한 서로 다른 데이터 값을 기준으로 태그 링크에 스타일을 적용(상태 서식 적용)하거나 모든 태그에 스타일을 적용할 수 있습니다. 예를 들어, 태그 클라우드 데이터에 상태 포맷터를 적용하여 40보다 큰 개수의 링크에는 빨간색 및 굵게로 서식 적용하고 40보다 적은 개수의 링크에는 검은색 및 기울임꼴로 서식 적용합니다. | STATEFORMATTING | 해당 없음 | N | N |
TagNameField | 태그 값을 나타내는 인포테이블 필드입니다. 데이터 속성을 바인딩해야 합니다. | FIELDNAME | 해당 없음 | N | N |
TagCountField | 태그 수를 나타내는 인포테이블 필드입니다. 데이터 속성을 바인딩해야 합니다. | FIELDNAME | 해당 없음 | N | N |
Title | 태그 클라우드의 제목입니다. | STRING | 해당 없음 | Y | Y |
이벤트
DoubleClicked
• 바인딩 가능
• 태그를 한 번 클릭하면 데이터 서비스 선택한 행에서 SelectedTag가 감지될 수 있습니다. 탐색 링크를 트리거하기 위해 두 번 클릭을 연결하는 등 다른 서비스를 개시하는 데 DoubleClicked 이벤트를 사용할 수 있습니다.
• SelectedTagStyle 속성이 정의되면 선택 사항에 따라 클릭한 태그의 스타일이 설정됩니다. 이전에 클릭/스타일 설정한 태그는 재설정됩니다.
• 바인딩된 데이터의 선택한 행 객체는 현재 선택/클릭한 태그 클라우드 링크의 색인으로 업데이트됩니다.
본질적으로 태그 클라우드는 바인딩된 데이터에 대한 선택한 행 객체 업데이트를 수신합니다. 다른 위젯 또는 데이터 작업에 의해 선택한 행이 업데이트될 경우
• 태그 클라우드 SelectedTag가 태그 클라우드 TagNameField에서 지정한 선택한 행 데이터 값으로 설정됩니다.
• SelectedTagStyle 속성이 정의되면 이에 따라 SelectedRow 태그의 스타일이 설정됩니다. 이전에 클릭/스타일 설정한 태그는 재설정됩니다.
• 업데이트된 선택한 행이 태그 클라우드에서 표시하지 않은 값인 경우
이전에 클릭/스타일 설정한 태그는 재설정됩니다.
SelectedTag가 지워집니다.
• 태그 클라우드는 다중 선택을 지원하지 않습니다. 선택한 행 객체에서 업데이트를 처리할 때 선택한 행 객체의 첫 번째 색인만 처리됩니다.