agorum.cards.list 

Dieses Widget verwendet eine agorum.cards.view, um Objektlisten anzuzeigen.

• Das System erzeugt für jedes darzustellende Objekt ein cardlet des Typs agorum.object und setzt dessen Eigenschaft id auf die UUID des Objekts.
• Die Suche verwendet dieses Widget etwa für die Anzeige von Suchergebnissen.
• Das System lädt bei umfangreichen Listen zunächst nur die ersten Einträge und blendet erst nach dem Scrollen weitere Einträge ein.

Verwendung

---

let aguila = require('common/aguila');

let widget = aguila.create({
  type: 'agorum.cards.list',
  query: 'inpath:${ID:/agorum/roi/Files}'
});

widget;

Parameter

---

Das Widget reicht alle Parameter an die erzeugten agorum.object-cardlets weiter.

id

Stellt den Inhalt eines Ordners in einer Liste dar, indem Sie diesen Parameter auf die ID des Ordners setzen.

ids

Stellt die zugehörigen Objekte in einer Liste dar, indem Sie diesen Parameter auf ein Array aus IDs setzen.

query

Stellt das Suchergebnis in einer Liste dar, indem Sie diesen Parameter auf eine Suchanfrage setzen.

sort

Legt die Sortierung der Objekte in der Liste fest.

Das Widget erwartet ein Array in diesem Format:

[
  {
    property: 'property',
    descending: true/false
  }
]

Werte für Parameter „descending“

Wert	Beschreibung
true	Sortiert die Objekte des Parameters property in absteigender Reihenfolge.
false (Standard)	Sortiert die Objekte des Parameters property in aufsteigender Reihenfolge.

Geben Sie mehrere Sortierungen an, sortiert das System diese nach ihrer Reihenfolge absteigend.

readOnly

Wert	Beschreibung
true	Verbietet eine Ablage per Drag-and-drop und bei statischen Listen die Aktionen Einfügen und Entfernen (letzteres nur möglich, sofern Sie den Parameter id gesetzt haben).
false (Standard)	Erlaubt eine Ablage per Drag-and-drop.

selection

Enthält ein Array mit den UUIDs aller aktuell selektierten Objekte.

Ändert sich dieser Parameter, ändert sich auch die dargestellte Selektion.

loading

Ist automatisch true, während die Liste erstmalig oder nachträglich lädt.

lastSeen

Stellt eine Trennlinie zwischen Objekten dar, die zeitlich vor oder nach einem gegebenen Zeitpunkt liegen.

• Sie können diesen Parameter in Kombination mit dem Parameter sort verwenden.
• Das System sortiert nach einer Datums-/Uhrzeit-Eigenschaft (etwa lastModifyDate).
• Das System setzt einen Zeitstempel im UNIX-Format (wie es von Date.getTime() zurückgeliefert wird) für diesen Parameter.

Beispiel für eine Suchliste mit einer Trennlinie am 04.12.2022 um 00:00

let aguila = require('common/aguila');

let widget = aguila.create({
  type: 'agorum.cards.list',
  query: 'inpath:${ID:/agorum/roi/Files}',
  lastSeen: new Date(2022, 11, 4).getTime(),
  sort: [
    {
      property: 'lastModifyDate',
      descending: true
    }
  ]
});

widget;