Widget "Tag Cloud"
Das Widget "Tag Cloud" bietet eine Möglichkeit, die Schlagwortverwendung zu visualisieren. Je öfter ein Schlagwort verwendet wird, desto größer wird es in der Wolke angezeigt. Das Widget "Tag Cloud" führt die Verwendungsberechnung nicht durch; die Schlagwortverwendung wird auf dem Server berechnet. Um gültig zu sein, erfordert die Schlagwortwolke einen Datensatz mit zwei Spalten ['tag label', 'tag count']. Auf Grundlage der Schlagwortanzahl werden Schlagwortbeschriftungen entsprechend gerendert.
Die Schlagwortwolke bietet die folgenden Optionen:
• Sie können einen festen Stil in den gerenderten Schlagwörtern anwenden (beispielsweise alle Schlagwörter in Rot und kursiv anzeigen) oder ihren Stil basierend auf einer Statusdefinition definieren.
• Sie können einen Stil auf das angeklickte/ausgewählte Schlagwort anwenden.
• Sie können ein Mausklickereignis verwenden, das gebunden werden kann. Wenn ein Benutzer auf ein Schlagwort klickt oder wenn die ausgewählte Zeile des Datensatzes aktualisiert wird, wird ein Mausklickereignis gesendet.
• Wenn ein Benutzer auf ein Schlagwort klickt oder wenn die ausgewählte Zeile des Datensatzes aktualisiert wird, füllt die Schlagwortwolke die Eigenschaft "SelectedTag", die gebunden werden kann, mit dem übereinstimmenden Schlagwort.
• Sie können angeben, wie groß (in CSS-em-Länge) das am häufigsten verwendete Schlagwort gerendert wird.
• Sie können einen Tooltip für jedes Schlagwort auf Grundlage aller Spalten im Schlagwortwolken-Datensatz anzeigen.
• Die Schlagwortwolke überwacht inhärent das Aktualisierungsereignis "Selected Row(s)" des Datensatzes, an das sie gebunden ist. Daher kann die Eigenschaft "SelectedTag" ohne explizite Aktion in der Schlagwortwolke aktualisiert und erneut gerendert werden (wenn SelectedTagStyle definiert ist).
Sehen Sie sich das folgende Video-Lernprogramm an, um weitere Informationen zu erhalten:
Eigenschaften
Informationen über allgemeine Widget-Eigenschaften finden Sie unter
Widgets. Eigenschaften, die für das Widget "Tag Cloud" spezifisch sind, werden in der folgenden Tabelle beschrieben.
Eigenschaftenname | Beschreibung | Basistyp | Standardwert | Bindung möglich? (J/N) | Lokalisierbar? (J/N) |
|---|---|---|---|---|---|
CustomClass | Benutzerdefinierte CSS-Klasse für das oberste div-Element des Widgets. Mehrere Klassen können eingegeben werden, getrennt durch ein Leerzeichen. | STRING | N/A | J | N |
Data | An Widget gebundene Tag-Daten | INFOTABLE | N/A | J | N |
MaxFontSize | Größe des größten Schlagworts in der Wolke (in CSS-em-Länge). Skaliert alle anderen Schlagwörter von dieser Größe herunter. | NUMBER | 4 | N | N |
DisplayToolTip | Aktiviert die Anzeige eines Tooltips über jeden Schlagwortlink | BOOLEAN | false | N | N |
ToolTipField | Infotable-Feld, das den Tooltip-Wert darstellt, wenn DisplayToolTip ausgewählt/true ist. Erfordert, dass die Eigenschaft "Data" gebunden ist. | FIELDNAME | Anzahl | N | N |
TagStateStyle | Legt den Stil der gerenderten Schlagwörter auf Grundlage eines formatierten Status oder eines angegebenen Stils fest. Standardmäßig formatiert die Schlagwortwolke die Schlagwortwolken-Links auf Grundlage ihrer Anzahl (je höher die Anzahl, desto größer die Schriftart). Sie können einen Stil auf die Schlagwortlinks basierend auf einem anderen Datenwert für jedes Schlagwort (Statusformatierung) oder für alle Schlagwörter anwenden. Beispielsweise wird ein Statusformatierer auf die Schlagwortwolken-Daten angewendet, um Links mit einer Anzahl größer als 40 in Rot und fett zu formatieren, während Links mit einer Anzahl unter 40 Schwarz und kursiv sind. | STATEFORMATTING | N/A | N | N |
TagNameField | Infotable-Feld, das den Schlagwortwert darstellt. Erfordert, dass die Eigenschaft "Data" gebunden ist. | FIELDNAME | N/A | N | N |
TagCountField | Infotable-Feld, das die Schlagwortanzahl darstellt. Erfordert, dass die Eigenschaft "Data" gebunden ist. | FIELDNAME | N/A | N | N |
Title | Titel für die Tag Cloud | STRING | N/A | J | J |
Ereignisse
DoubleClicked
• Kann gebunden werden
• Wenn einmal auf ein Schlagwort geklickt wird, wird SelectedTag in der ausgewählten Zeile des Datendienstes erkannt. Das Ereignis DoubleClicked kann verwendet werden, um einen anderen Dienst auszulösen, wie das Verlinken eines Doppelklicks, um einen Navigationslink auszulösen.
• Wenn die Eigenschaft SelectedTagStyle definiert ist, wird das angeklickte Schlagwort entsprechend der Auswahl formatiert. Alle zuvor angeklickten/formatierten Schlagwörter werden zurückgesetzt.
• Das Objekt "Selected Row" der gebundenen Daten wird mit dem Index des aktuell ausgewählten/angeklickten Schlagwortwolken-Links aktualisiert.
Die Schlagwortwolke überwacht inhärent die Aktualisierung des Objekts "Selected Row" für die Daten, an die sie gebunden ist. Wenn "Selected Row" aktualisiert wird (von einem anderen Widget oder einer anderen Datenaktion):
• Die Schlagwortwolke SelectedTag wird auf den Datenwert "Selected Row" festgelegt, der durch die Schlagwortwolke TagNameField ausgewiesen ist.
• Wenn die Eigenschaft SelectedTagStyle definiert ist, wird das Schlagwort SelectedRow entsprechend formatiert. Alle zuvor angeklickten/formatierten Schlagwörter werden zurückgesetzt.
• Wenn die aktualisierte Selected Row ein Wert ist, der nicht von der Schlagwortwolke angezeigt wird:
Alle zuvor angeklickten/formatierten Schlagwörter werden zurückgesetzt.
SelectedTag wird gelöscht.
• Die Schlagwortwolke unterstützt keine Mehrfachauswahl. Wenn Sie Aktualisierungen vom Objekt "Selected Row" verarbeiten, wird nur der erste Index des Objekts "Selected Row" verarbeitet.