Die Datensatzlistenkomponente wird in brandbox genutzt um mehrere Datensätze in einer beliebigen Struktur (bspw. Tabelle, Karten oder Baum) darzustellen. Zusammen mit den Ansichtseinstellungen und einer benutzerdefinierten Kontextklasse wird der Aufbau der erzeugten Containers geregelt.
use Brandbox\Framework\Base\Container;
use Brandbox\Framework\Base\Settings;
class CustomContext extends Container\Lib\Struct\ContainerContextAbstract
{
public string $something = 'strange';
}
$entities = []; // Ein Array von \Brandbox\Framework\Brandbox\Dbal\Definition\EntityInterface
$settings = $this
->staticController(Settings\Manager::class)
->getProvider('shopArticle') // Ansichtseinstellung des aktuellen Anwenders für die Artikeltabelle
;
$context = new CustomContext();
$context->something = 'other'; // Benutzerdefinierte Eigenschaft
$context->identification = uniqid('CustomContainer'); // Eindeutige Identifikationsvariable für den Container
$element = $this
->staticController(Container\Manager::class)
->getContainerElement($context, $settings, ...$entities)
;
// $element ist ein \Brandbox\FrameworkStyleguide\Entity\FrameworkElementAbstract
Informationen
Die Datensatzlistenkomponente bezeichnet Teile eines Datensatzes als Information. Eine solche Information ist bspw. der Besitzer, das Änderungsdatum oder ein Eingabefeld des Datensatzes. Diese Informationen werden durch die verschiedenen Darstellungen der Datensatzliste angeordnet und sind damit unabhängig von der Darstellung selbst.
Eventübersicht
| Klassenname | Beschreibung |
|---|---|
OnPopulateContainer | Wir beim Aufruf von Container\Manager::getContainerElement() ausgelöst um das Styleguidelement aufzubauen. |
OnPopulateElement | Wird für jeden darzustellenden Datensatz ausgelöst um die darzustellenden Informationen einzusammeln. |
OnPopulateInformation | Wird für jede Information pro Datensatz ausgelöst um den Inhalt (bspw. Text) für diese Information aufzubauen. |
OnPopulateInformationAvailable | Wird ausgelöst um die verfügbaren Informationen einzusammeln und diese in den Ansichtseinstellungen zu Auswahl anzubieten. |
OnPopulateInformationDefault | Wird ausgelöst um die Standardinformationen für eine Datensatzliste festzulegen. |