Widget "Sammlung" (mit Thema versehbar)
Das Widget "Sammlung" ist ein reaktionsfähiges Widget, das es Ihnen ermöglicht, eine Reihe wiederholter Mashups als Zellen innerhalb einer Sammlung anzuzeigen. Sie können erweiterte Layouts und Gruppenzellen konfigurieren, um Benutzern die Anzeige der Sammlung auf verschiedenen Bildschirmgrößen zu erleichtern. Sie müssen eine Infotable mit Daten für die Mashup-Zellen definieren, um Daten innerhalb der Sammlungszellen anzuzeigen. Sie können auch das Datenladeverhalten konfigurieren, um die Leistung beim Laden großer Datensätze zu optimieren.
 |
Dieses Widget ist auch als Web-Komponente im Web Component SDK verfügbar.
|
Optimale Vorgehensweisen
Vermeiden Sie die Ausführung von Diensten in den einzelnen Mashup-Zellen der Sammlung. Das wiederholte Ausführen mehrerer Dienste für jede Zelle in einer Sammlung erfordert eine erhebliche Anzahl von Netzwerkanforderungen. Alle Dienste innerhalb des Sammlungs-Mashups werden beim Initialisieren des Eltern-Mashups wiederholt ausgeführt, was zu erheblichen Leistungsproblemen beim Laden der einzelnen Zellen führen kann. Führen Sie Datendienste im Eltern-Mashup aus, und übergeben Sie dann die Daten mithilfe der Mashup-Parameter und der Eigenschaft MashupPropertyBinding an die enthaltenen Mashups, um Leistungsprobleme zu vermeiden. Weitere Informationen zum Arbeiten mit Parametern finden Sie unter Mashup-Parameter konfigurieren.
Klickereignis-Verhalten innerhalb von Zellen
In den Sammlungszellen können mehrere interaktive und nicht interaktive Widgets angezeigt werden. Wenn eine Zelle ein interaktives Widget enthält, auf das geklickt wird, überprüft ein Ereignishandler, ob ein Clicked-Ereignis an das Widget gebunden ist. Wenn das Ereignis gebunden ist, wird das Widget-Klickereignis ausgelöst. Wenn das Ereignis nicht gebunden ist, wird das Widget als nicht interaktiv betrachtet, und es wird stattdessen die Zelle ausgewählt. Beispielsweise kann die Sammlung ein Widget vom Typ "KPI-Skala" enthalten, das über ein optionales Clicked-Ereignis verfügt. Wenn das Ereignis gebunden ist, registriert der Ereignishandler das Ereignis, und der gebundene Dienst oder die gebundene Funktion wird ausgeführt. Wenn das Ereignis nicht gebunden ist, wird die Sammlungszelle ausgewählt.
Eigenschaften
|
Eigenschaftsname
|
Beschreibung
|
Basistyp
|
Standardwert
|
Bindung möglich
|
Lokalisierbar (J/N)
|
||
|---|---|---|---|---|---|---|---|
|
Data
|
Die Infotable-Datenquelle für das Sammlungs-Widget.
|
INFOTABLE
|
J
|
N
|
|||
|
DragActionsData
|
Eine JSON-Eigenschaft, die Änderungen an Sammlungszellen speichert, wenn Ziehen-und-Ablegen-Aktionen verwendet werden. Sie speichert die Indexnummern hinzugefügter, entfernter und umgeordneter Zellen.
|
JSON
|
N/A
|
J
|
N
|
||
|
DragCells
|
Ermöglicht es Benutzern, Zellen in der Sammlung zur Laufzeit zu ziehen und abzulegen. Wenn diese Option aktiviert ist, werden Sortierung und Abschnitte nicht unterstützt.
|
BOOLEAN
|
Falsch
|
J
|
N
|
||
|
DragCellsBetweenWidgets
|
Ermöglicht es Benutzern, Zellen zur Laufzeit zwischen zwei verschiedenen Widgets vom Typ "Sammlung" zu ziehen und abzulegen. Zur Unterstützung dieses Verhaltens muss diese Eigenschaft für beide Widgets aktiviert sein und es muss der gleiche Data Shape verwendet werden.
|
BOOLEAN
|
Falsch
|
J
|
N
|
||
|
ItemLoadBehavior
|
Steuert das Ladeverhalten der Sammlungsdaten. Daten können ge- und entladen werden, während Benutzer einen Bildlauf durchführen, Daten können schrittweise nach Bedarf geladen werden, oder der vollständige Datensatz kann zu Beginn geladen werden.
|
STRING
|
Laden/Entladen
|
N
|
N
|
||
|
Layout
|
Gibt den Typ des für die Sammlungszellen zu verwendenden Layouts an. Optionen: Flexibel, Raster, Tabelle.
|
STRING
|
Flexibel
|
J
|
N
|
||
|
Mashup
|
Das für die Anzeige der Sammlungsdaten zu verwendende Mashup.
|
MASHUPNAME
|
J
|
N
|
|||
|
Width
|
Legt die Widget-Breite fest.
|
NUMBER
|
400
|
N
|
N
|
||
|
Height
|
Legt die Widget-Höhe fest.
|
NUMBER
|
300
|
N
|
N
|
||
|
MashupHeight
|
Legt die Höhe des Sammlungs-Mashups fest.
|
NUMBER
|
J
|
N
|
|||
|
MashupWidth
|
Legt die Breite des Sammlungs-Mashups fest.
|
NUMBER
|
J
|
N
|
|||
|
MashupWidthField
|
Gibt das Infotable-Feld an, um die Zellenbreite unter Verwendung eines Diensts zu definieren. Werte überschreiben MashupHeight.
|
Infotable-Spalte
|
N
|
N
|
|||
|
MashupHeightField
|
Gibt das Infotable-Feld an, um die Zellenhöhe unter Verwendung eines Diensts zu definieren. Werte überschreiben MashupHeight.
|
Infotable-Spalte
|
N
|
N
|
|||
|
UIDField
|
Erforderlich. Gibt das Infotable-Feld mit der eindeutigen ID für jede Zelle an.
|
Infotable-Spalte
|
N
|
N
|
|||
|
LastRowAlignment
|
Steuert die Ausrichtung von Zellen innerhalb der letzten Zeile in der Sammlung. Optionen: Standard, Gleichmäßig verteilen, Abstand zwischen, Links, Mitte, Rechts, Strecken
|
STRING
|
Standard
|
N
|
N
|
||
|
ContentAlignment
|
Steuert die vertikale Ausrichtung des Sammlungsinhalts, wenn die Anzahl der Zellen zu klein ist, um den verfügbaren Platz im Layout zu füllen.
Optionen: Oben, Mitte, Unten
|
STRING
|
Mitte
|
N
|
N
|
||
|
RowHorizontalAlignment
|
Steuert die horizontale Ausrichtung von Zellen innerhalb der Sammlungszeilen. Optionen: Gleichmäßig verteilen, Abstand zwischen, Links, Mitte, Rechts, Strecken
|
STRING
|
Gleichmäßig verteilen
|
N
|
N
|
||
|
RowVerticalAlignment
|
Steuert die vertikale Ausrichtung von Zellen innerhalb der Sammlungszeilen. Optionen: Oben, Mitte, Strecken, Unten
|
STRING
|
Mitte
|
N
|
N
|
||
|
UniformRowHeight
|
Zeigt Zeilen unter Verwendung derselben Höhe an.
|
BOOLEAN
|
Falsch
|
N
|
N
|
||
|
RowGap
|
Legt den Abstand zwischen den Sammlungszeilen fest.
|
NUMBER
|
40
|
N
|
N
|
||
|
ColumnGap
|
Legt den Abstand zwischen den Sammlungsspalten fest.
|
NUMBER
|
40
|
N
|
N
|
||
|
SectionGap
|
Legt den Abstand zwischen den Sammlungsabschnitten fest.
|
NUMBER
|
48
|
N
|
N
|
||
|
TopPadding
|
Legt den Abstand zwischen dem oberen Rand der Sammlung und der ersten Zelle fest.
|
NUMBER
|
24
|
N
|
N
|
||
|
BottomPadding
|
Legt den Abstand zwischen dem unteren Rand der Sammlung und der letzten Zelle fest.
|
NUMBER
|
24
|
N
|
N
|
||
|
RightPadding
|
Legt die Auffüllung zwischen dem rechten Rand des Widgets und der Zellensammlung fest.
|
NUMBER
|
24
|
N
|
N
|
||
|
LeftPadding
|
Legt die Auffüllung zwischen dem linken Rand des Widgets und der Zellensammlung fest.
|
NUMBER
|
0
|
N
|
N
|
||
|
MashupBackground
|
Steuert den Hintergrund des Sammlungs-Mashups und aller seiner Container. Wenn der Mashup-Hintergrund transparent ist, sind Stile, die auf den Zellenhintergrund angewendet werden, sichtbar. Optionen: Transparent, Sichtbar
|
STRING
|
Sichtbar
|
N
|
N
|
||
|
MashupNameField
|
Ermöglicht die Angabe eines Infotable-Felds, um den Mashup-Namen unter Verwendung eines Datendiensts anzugeben. Diese Eigenschaft überschreibt die Mashup-Eigenschaft.
|
Infotable-Spalte
|
N
|
N
|
|||
|
MashupPropertyBinding
|
Ein serialisiertes JSON-Objekt, das Infotable-Felder als Schlüssel und Mashup-Parameter als Werte hat. Beispiel:
{
|
JSON
|
N
|
N
|
|||
|
MashupGlobalPropertyBinding
|
Ein serialisiertes JSON-Objekt, das globale Parameternamen als Schlüssel und Datentypen als Werte hat. Sie können diese Eigenschaften an das Sammlungs-Widget binden und Werte an jedes Zellen-Mashup senden.
{
|
JSON
|
N
|
N
|
|||
|
SelectedCellMashupField
|
Ermöglicht die Angabe eines Infotable-Felds, um den ausgewählten Status für jede Zelle in der Sammlung festzulegen.
|
Infotable-Spalte
|
N
|
N
|
|||
|
UseMashupDimensions
|
Stimmt die Zellengröße mit den Mashup-Bemaßungen ab.
|
BOOLEAN
|
Falsch
|
N
|
N
|
||
|
SelectionMode
|
Ermöglicht es zu steuern, wie viele Zellen Benutzer zur Laufzeit auswählen können. Optionen: Keine, Einzelne, Mehrere
|
STRING
|
Kein
|
N
|
N
|
||
|
HasSelectedCells
|
Gibt "Wahr" zurück, wenn das Widget ausgewählte Zellen enthält.
|
BOOLEAN
|
Falsch
|
J
|
N
|
||
|
SelectedCellsCount
|
Gibt die Anzahl der ausgewählten Zellen in der Sammlung zurück.
|
NUMBER
|
0
|
N
|
N
|
||
|
ScrollToSelectedCell
|
Führt automatisch einen Bildlauf zu Zellen aus, wenn diese ausgewählt sind.
|
BOOLEAN
|
Falsch
|
N
|
N
|
||
|
AutoSelectFirstRow
|
Ermöglicht die automatische Auswahl der ersten Zeile, wenn Daten in die Sammlung geladen werden.
|
BOOLEAN
|
Falsch
|
N
|
N
|
||
|
SelectedCells
|
Gibt die Sammlungszellen an, die unter Verwendung einer Infotable ausgewählt werden sollen.
|
INFOTABLE
|
J
|
N
|
|||
|
SelectedCellMashup
|
Gibt das alternative Mashup an, das für ausgewählte Zellen in der Sammlung angezeigt werden soll. Dieses Mashup muss dieselben Eigenschaften wie das Standard-Mashup enthalten.
|
Mashup-Auswahl
|
J
|
N
|
|||
|
HandleSelectionUpdates
|
Bei Aktivierung sendet das Widget Auswahlaktualisierungen an seinen Datendienst, von dem es wiederum Aktualisierungen erhält.
|
BOOLEAN
|
Wahr
|
N
|
N
|
||
|
CellMenu
|
Gibt die Statusdefinition an, die zum Definieren des Zellenmenüs verwendet wird, welches angezeigt wird, wenn auf Touch-Geräten mit dem Finger über Zellen gezogen wird. Bei Geräten ohne Touch-Bedienoberfläche wird dieses Menü durch Rechtsklick auf die Zellen angezeigt.
|
STATEDEFINITION
|
N
|
N
|
|||
|
CellMenuIconSize
|
Gibt die Größe der Symbole innerhalb des Zellenmenüs an.
|
NUMBER
|
20
|
N
|
N
|
||
|
CellActionsPosition
|
Steuert die Position der Schaltfläche "Zellenmenü". Optionen: Oben, Unten, Rechts, Links
|
STRING
|
Unten
|
N
|
N
|
||
|
CellTabKeyScope
|
Steuert den Navigationsumfang bei der Interaktion mit dem Inhalt einer Zelle über die Tastatur. Optionen: Zelle, Sammlung, Nur Elemente. Wenn der Umfang auf "Zelle" festgelegt ist, werden durch Drücken der Tabulatortaste die Elemente in der Zelle durchlaufen. Wenn der Umfang auf "Sammlung" festgelegt ist, wird durch Drücken der Tabulatortaste der Fokus nach Auswahl des letzten Elements wieder zurück auf die Zelle gesetzt. Wählen Sie Nur Elemente aus, um sich nur auf den Zelleninhalt zu konzentrieren und die Zelle selbst beim Navigieren zwischen Zellen zu überspringen.
|
STRING
|
Zelle
|
N
|
N
|
||
|
CellUnloadDelay
|
Legt fest, nach wie vielen Sekunden Sammlungszellen aus dem DOM entladen werden sollen, wenn sie nicht sichtbar sind. Diese Eigenschaft wird nur angewendet, wenn "ItemLoadBehavior" auf Bei Bedarf laden festgelegt ist.
|
NUMBER
|
Nicht verfügbar
|
N
|
N
|
||
|
CellPointer
|
Steuert den Stil des Mauszeigers, wenn auf eine Zelle in der Sammlung gezeigt wird. Optionen: auto, pointer, default
|
STRING
|
Automatisch
|
N
|
N
|
||
|
SectionField
|
Gibt das Infotable-Feld mit ID-Werten an, die verwendet werden können, um Zellen innerhalb von Abschnitten zu gruppieren.
|
INFOTABLE
|
N
|
N
|
|||
|
SectionInsetLeft
|
Legt den linken Einsatzwert von Schnitten beim Gruppieren von Zellen fest.
|
NUMBER
|
0
|
N
|
N
|
||
|
SectionInsetTop
|
Legt den obersten Einsatzwert von Abschnitten beim Gruppieren von Zellen fest.
|
NUMBER
|
0
|
N
|
N
|
||
|
SectionInsetRight
|
Legt den rechten Einsatzwert von Abschnitten beim Gruppieren von Zellen fest.
|
NUMBER
|
0
|
N
|
N
|
||
|
SectionInsetBottom
|
Legt den unteren Einsatzwert von Abschnitten beim Gruppieren von Zellen fest.
|
NUMBER
|
0
|
N
|
N
|
||
|
SortField
|
Gibt das Infotable-Feld an, nach dem Abschnittsinhalte sortiert werden. Die Sortierung wird clientseitig durchgeführt und hat keinen Einfluss auf die Quell-Infotable oder andere Widgets, die an das Dataset gebunden sind.
|
INFOTABLE
|
J
|
N
|
|||
|
SortAscending
|
Legt den Inhalt des Abschnitts in aufsteigender Reihenfolge fest, wenn die Eigenschaft SortField verwendet wird. Standardmäßig werden Abschnitte in absteigender Reihenfolge sortiert.
|
BOOLEAN
|
Falsch
|
J
|
N
|
||
|
SectionHeaders
|
Steuert die Sichtbarkeit der Abschnittskopfzeilen, wenn Zellen in der Sammlung gruppiert werden. Optionen: Kein, Sichtbar, Angeheftet
|
STRING
|
Kein
|
N
|
N
|
||
|
HeaderMashup
|
Gibt das für die Abschnittskopfzeilen zu verwendende Mashup an, wenn Zellen in der Sammlung gruppiert werden.
|
MASHUPNAME
|
Kein
|
N
|
N
|
||
|
HeaderSectionParam
|
Der Name des Kopfzeilen-Mashup-Parameters, der die Abschnitts-ID erhält.
|
STRING
|
N
|
N
|
|||
|
HeaderHeight
|
Legt die Höhe der Abschnittskopfzeile in der Sammlung fest.
|
NUMBER
|
40
|
N
|
N
|
||
|
SectionFooters
|
Steuert die Sichtbarkeit der Abschnittsfußzeilen, wenn Zellen in der Sammlung gruppiert werden. Optionen: Kein, Sichtbar, Angeheftet
|
STRING
|
Kein
|
N
|
N
|
||
|
FooterMashup
|
Gibt das für die Abschnittsfußzeile zu verwendende Mashup an, wenn Zellen in der Sammlung gruppiert werden.
|
MASHUPNAME
|
N
|
N
|
|||
|
FooterSectionParam
|
Der Name des Fußzeilen-Mashup-Parameters, der die Abschnitts-ID erhält.
|
STRING
|
N
|
N
|
|||
|
FooterHeight
|
Legt die Höhe der Abschnittsfußzeilen fest, wenn Zellen in der Sammlung gruppiert werden.
|
NUMBER
|
40
|
N
|
N
|
||
|
EmptyMashup
|
Gibt das Mashup an, das angezeigt werden soll, wenn eine Zelle in der Sammlung keine Daten enthält.
|
MASHUPNAME
|
Kein
|
N
|
N
|
||
|
Deselect
|
Ein bindbarer Dienst, der jede Auswahl in der Sammlung löscht.
|
Dienst
|
J
|
N
|
|||
|
SelectAll
|
Ein bindbarer Dienst, der alle Zellen in der Sammlung auswählt.
|
Dienst
|
J
|
N
|
|||
|
DisableWrapping
|
Bei aktivierter Eigenschaft werden Zellen in einer Zeile mit einer horizontalen Bildlaufleiste angezeigt. Bei deaktivierter Eigenschaft werden Zellen in eine neue Zeile umbrochen, wenn der verfügbare horizontale Platz nicht ausreicht, um die gesamte Sammlung anzuzeigen. Diese Eigenschaft wird nur unterstützt, wenn für die Sammlung der Layout-Modus Flexibel konfiguriert ist.
|
BOOLEAN
|
Falsch
|
N
|
N
|
Ereignisse
|
Eigenschaftsname
|
Beschreibung
|
Basistyp
|
Bindung möglich
|
Lokalisierbar (J/N)
|
|---|---|---|---|---|
|
CellClicked
|
Ein Ereignis, das ausgelöst wird, wenn ein Benutzer auf eine Zelle in der Sammlung klickt oder tippt.
|
Ereignis
|
J
|
N
|
|
CellDoubleClicked
|
Ein Ereignis, das ausgelöst wird, wenn ein Benutzer auf eine Zelle in der Sammlung doppelklickt oder tippt.
|
Ereignis
|
J
|
N
|
|
CellLongClicked
|
Ein Ereignis, das ausgelöst wird, wenn ein Benutzer länger als 400 Millisekunden auf eine Zelle in der Sammlung klickt und hält oder tippt und hält.
|
Ereignis
|
J
|
N
|
|
CellRightClicked
|
Ein Ereignis, das ausgelöst wird, wenn ein Benutzer mit der rechten Maustaste auf eine Zelle in der Sammlung klickt.
|
Ereignis
|
J
|
N
|
|
CellAdded
|
Ein Ereignis, das ausgelöst wird, wenn der Sammlung eine Zelle mit Ziehen und Ablegen hinzugefügt wird
|
Ereignis
|
J
|
N
|
|
CellRemoved
|
Ein Ereignis, das ausgelöst wird, wenn eine Zelle aus der Sammlung entfernt wird.
|
Ereignis
|
J
|
N
|
|
CellMoved
|
Ein Ereignis, das ausgelöst wird, wenn eine Zelle innerhalb der Sammlung verschoben wird. Dieses Ereignis wird auch ausgelöst, wenn eine Zelle in einen anderen Abschnitt innerhalb der Sammlung verschoben wird.
|
Ereignis
|
J
|
N
|