Виджет "Облако тегов"
Виджет "Облако тегов" позволяет визуализировать использование тегов. Чем чаще используется тег, тем крупнее он отображается в облаке. Сам виджет "Облако тегов" не подсчитывает число использований, это делается на сервере. Для эффективного использования виджета "Облако тегов" требуется набор данных минимум с двумя столбцами [метка тега и число тегов]. Рендеринг меток тегов выполняется в соответствии с числом тегов.
Облако тегов предоставляет следующие возможности.
• К тегам после рендеринга можно применить фиксированный стиль (например, отображать все теги красным цветом или курсивом) или стиль на основе определения состояния.
• Можно применить стиль для щелкнутых/выбранных тегов.
• Можно использовать привязываемое событие щелчка. Если пользователь щелкнет тег или будет обновлена выбранная строка набора данных, будет выполнена рассылка события щелчка.
• Если пользователь щелкнет тег или будет обновлена выбранная строка набора данных, облако тегов заполнит привязываемое свойство SelectedTag соответствующим тегом.
• Можно указать, до какого размера (в единицах измерения длины CSS) должен выполняться рендеринг самого используемого тега.
• Для каждого тега можно отображать всплывающую подсказку на основе любого столбца в наборе данных облака тегов.
• По существу, облако тегов прослушивает событие обновления выбранных строк набора данных, с которым оно связано. Поэтому свойство SelectedTag может выполнять обновление и повторный рендеринг (если определено свойство SelectedTagStyle) без явных действий в облаке тегов.
Свойства
Дополнительные сведения об общих свойствах виджетов см. в разделе Виджеты. Специфичные для виджета "Облако тегов" свойства описаны в таблице ниже.
|
Имя свойства
|
Описание
|
Базовый тип
|
Значение по умолчанию
|
Доступно для привязки? (Д/Н)
|
Доступно для локализации? (Д/Н)
|
|---|---|---|---|---|---|
|
CustomClass
|
Определяемый пользователем класс CSS для применения к верхнему разделу виджета. Можно ввести несколько классов, разделенных пробелами.
|
STRING
|
Н/Д
|
Д
|
N
|
|
Данные
|
Данные тегов, привязанные к виджету
|
INFOTABLE
|
Н/Д
|
Д
|
N
|
|
MaxFontSize
|
Размер самого большого тега в облаке (в единицах длины CSS). Все остальные теги масштабируются в сторону уменьшения от этого размера.
|
NUMBER
|
4
|
N
|
N
|
|
DisplayToolTip
|
Включает отображение всплывающей подсказки над каждой ссылкой тега
|
BOOLEAN
|
false
|
N
|
N
|
|
ToolTipField
|
Поле таблицы данных, которое представляет значение всплывающей подсказки, если свойство DisplayToolTip выбрано/true. Требует привязки свойства Data.
|
FIELDNAME
|
число тегов
|
N
|
N
|
|
TagStateStyle
|
Задает стиль отрисованных тегов на основе форматированного состояния или определенного стиля.
По умолчанию облако тегов задает стиль для ссылок тегов на основе соответствующего числа (чем больше число, тем крупнее шрифт). Можно применить для ссылок тегов стиль на основе другого значения данных для каждого тега (форматирование состояния) или применить какой-либо стиль для всех тегов. Например, к данным облака тегов можно применить форматтер состояния для форматирования ссылок с числом больше 40 жирным шрифтом красного цвета, а ссылок с числом меньше 40 - черным курсивом.
|
STATEFORMATTING
|
Н/Д
|
N
|
N
|
|
TagNameField
|
Поле таблицы данных, которое представляет значение тега. Требует привязки свойства Data.
|
FIELDNAME
|
Н/Д
|
N
|
N
|
|
TagCountField
|
Поле таблицы данных, которое представляет число тега. Требует привязки свойства Data.
|
FIELDNAME
|
Н/Д
|
N
|
N
|
|
Название
|
Название для облака тегов
|
STRING
|
Н/Д
|
Д
|
Д
|
События
DoubleClicked
• Является привязываемым.
• Если щелкнуть тег один раз, будет обнаружен SelectedTag в выбранной строки сервиса данных. Событие DoubleClicked можно использовать для запуска другого сервиса, например привязки двойного щелчка для инициирования навигационной ссылки.
• Если определено свойство SelectedTagStyle, к щелкнутому тегу будет применяться выбранный стиль. Любой тег, который ранее был нажат или для которого ранее был задан стиль, будет сброшен.
• Объект выбранной строки связанных данных обновляется с использованием индекса текущей выбранной/щелкнутой ссылки облака тегов.
В сущности, облако тегов прослушивает обновление объекта выбранной строки для данных, с которыми оно связано. При обновлении выбранной строки (другим виджетом или действием данных) происходит следующее.
• Для свойства SelectedTag устанавливается значение данных выбранной строки, определяемое свойством TagNameField облака тегов.
• Если определено свойство SelectedTagStyle, к тегу SelectedRow применяется соответствующий стиль. Любой тег, который ранее был нажат или для которого ранее был задан стиль, будет сброшен.
• Если обновленная выбранная строка является значением, которое не отображается облаком тегов, выполняются следующие действия.
Любой тег, который ранее был нажат или для которого ранее был задан стиль, будет сброшен.
Свойство SelectedTag будет очищено.
• Облако тегов не поддерживает множественный выбор. При обработке обновлений из объекта выбранной строки обрабатывается только первый индекс объекта выбранной строки.