Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

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.

Codeblock
languagephp
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.

Drawio
bordertrue
diagramNameDatensatzlistenkomponente (Eventübersicht)
simpleViewerfalse
width
linksauto
tbstyletop
lboxtrue
revision1
diagramWidth521