...
Die Speicherfunktion geht von einem bereits existierenden Formular aus, welches bspw. über die Formularkomponente erstellt werden kann. Desweiteren muss über eines oder mehrere versteckte Eingabefelder die betreffenden Datensätze definiert werden. Die Speicherfunktion wird in den Events mit der Kontextklasse ContextPersist identifiziert.
Datensatzdefinition im HTML
| Codeblock | ||||||
|---|---|---|---|---|---|---|
| ||||||
<form id="entities"> <input type="hidden" name="selection[shopArticle][]" value="123"> <input type="hidden" name="selection[shopArticle][]" value="456"> </form> |
...
Allen zuvor genannten Funktionen können beliebig viele Aktionen zugeordnet werden. Diese werden je nach Konfiguration dem Anwender in einem Modal angeboten, damit dieser Aktionen für die Funktion aus- bzw. abwählen kann. Das Event OnPopulateActions wird ausgelöst um die verfügbaren Aktionen einzusammeln.
Erstellen einer Funktionsaktion
| Codeblock | ||||||
|---|---|---|---|---|---|---|
| ||||||
/**
* Das nachfolgende Codebeispiel fügt eine Kopieroption hinzu.
* Dieser Code muss in einem Listener für das OnPopulateActions-Event ausgeführt werden.
*/
use Brandbox\Framework\Component\Pwa;
use Brandbox\Framework\Component\I18n;
use Brandbox\Framework\Component\Crud;
/** @var Crud\Lib\Event\OnPopulateActions $event */
$action = new Pwa\Lib\Struct\ActionElement();
$action->headline = I18n\TranslationManager::__('Example/Package.ActionHeadline');
$action->content = I18n\TranslationManager::__('Example/Package.ActionContent');
$action->identifier = 'ActionIdentifier'; // Dieser Identifikator wird dem OnExecuteOperation-Event mitgegeben,
// sofern der Anwender dieser Option gewählt hat
$action->checked = true; // Diese Option ist standardmäßig ausgewählt
$action->required = false; // Diese Option muss nicht immer gewählt sein
$action->disabled = false; // Diese Option kann nicht verändert werden
$event->actions[] = $action; |
Eine Funktionsaktion wird dem Anwender immer als Checkbox präsentiert. Es ist zusätzlich möglich Unteroptionen in Form von Radiobuttons hinzuzufügen. Das nachfolgende Codebeispiel baut auf dem vorherigen auf.
Erstellen von Aktionsoptionen
| Codeblock | ||||||
|---|---|---|---|---|---|---|
| ||||||
use Brandbox\Framework\Component\Pwa;
use Brandbox\Framework\Component\I18n;
/** @var Pwa\Lib\Struct\ActionElement $action */
$action = new Pwa\Lib\Struct\ActionElement();
$option1 = new Pwa\Lib\Struct\ActionElementOption();
$option2 = new Pwa\Lib\Struct\ActionElementOption();
// Der aus den Option ausgewählte Identifikator wird ebenfalls OnExecuteCopy mitgegeben
$option1->identifier = 'ActionIdentifierOption1';
$option2->identifier = 'ActionIdentifierOption2';
$option1->content = I18n\TranslationManager::__('Example/Package.ActionOption1');
$option2->content = I18n\TranslationManager::__('Example/Package.ActionOption2');
// Da Unteroptionen als Radiobuttons angeboten werden, kann nur eine Option gewählt werden
$option1->checked = false;
$option2->checked = true;
$action->options[] = $option1;
$action->options[] = $option2; |
Eventübersicht
Klassenname | Beschreibung |
|---|---|
| Wird ausgelöst, sobald eine der CRUD-Funktionen ausgelöst wird. |
| Wird zum einsammeln der Funktionsaktionen ausgelöst. |
| Wird zum einsammeln von Spaltenidentifikatoren genutzt, welche bspw. bei einer Validierung ignoriert werden sollen. |