Signatur
Beschreibung
UI\Controls\Separator ist ein einfaches, rein visuelles Control aus der PHP-UI-Erweiterung (ui), das eine horizontale oder vertikale Trennlinie zwischen anderen Controls zeichnet. Es dient ausschließlich zur optischen Strukturierung von Formularen, Toolbars oder Dialogen und besitzt keinerlei Interaktionsfunktion.
Der Separator wird entweder als horizontales (UI\Controls\HSeparator) oder vertikales (UI\Controls\VSeparator) Element instanziiert. Er wird typischerweise in Layout-Containern wie UI\Controls\Box eingesetzt, um Gruppen von Controls voneinander abzugrenzen und so die Benutzeroberfläche übersichtlicher zu gestalten.
Da Separator von UI\Control erbt, stehen alle grundlegenden Control-Methoden wie show(), hide() und isEnabled() zur Verfügung, obwohl der Separator selbst keine eigenen Eigenschaften oder Ereignisse definiert.
- HSeparator: Erzeugt eine horizontale Trennlinie.
- VSeparator: Erzeugt eine vertikale Trennlinie.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $type | int | UI\Controls\Separator::Horizontal | Legt die Ausrichtung des Separators fest. Mögliche Werte sind UI\Controls\Separator::Horizontal und UI\Controls\Separator::Vertical. |
Rückgabewert
Beispiele
Horizontaler Separator in einer Box
<?php
use UI\Window;
use UI\Controls\Box;
use UI\Controls\Label;
use UI\Controls\Separator;
$window = new Window('Separator-Demo', 300, 200, false);
$box = new Box(Box::Vertical);
$box->setPadded(true);
$box->append(new Label('Abschnitt 1'), false);
$box->append(new Separator(Separator::Horizontal), false);
$box->append(new Label('Abschnitt 2'), false);
$window->add($box);
$window->show();
UI\run();Vertikaler Separator zwischen zwei Bereichen
<?php
use UI\Window;
use UI\Controls\Box;
use UI\Controls\Label;
use UI\Controls\Separator;
$window = new Window('Vertikaler Separator', 400, 150, false);
$hBox = new Box(Box::Horizontal);
$hBox->setPadded(true);
$hBox->append(new Label('Links'), true);
$hBox->append(new Separator(Separator::Vertical), false);
$hBox->append(new Label('Rechts'), true);
$window->add($hBox);
$window->show();
UI\run();// Wichtig · Fallstricke
Die Klasse UI\Controls\Separator ist Teil der ui-PECL-Erweiterung, die auf der libui-Bibliothek basiert. Diese Erweiterung befindet sich im experimentellen Stadium und ist nicht standardmäßig in PHP enthalten — sie muss separat installiert werden. Die API kann sich zwischen Versionen ändern.
Kurzformen UI\Controls\HSeparator und UI\Controls\VSeparator können je nach Version der Erweiterung als Aliases verfügbar sein.