Datumsauswahl in Formularen
Mit Hilfe des TUCAL-Datepickers lässt sich eine Datumsauswahl leicht realisieren.
Um ein Eingabefeld, welches die Datumsauswahl entsprechend anzeigt muss dafür zunächst
die Datei php/datepicker.inc am Seitenanfang geladen werden:
<?php
…
# Nutzung des Datepicker-Moduls
require_once('php/datepicker.inc');
seite(__FILE__);
?>Sicherheit
Es sollte beachtet werden, dass die Datumsauswahl lediglich eine alternative Eingabe zur Verfügung stellt. Der Nutzer kann weiterhin jeden beliebigen Inhalt in das Formular einfügen. Nutzereingaben sollten immer serverseitig überprüft werden.
Nutzung
Ausgabe kann mit echo datepicker($settings) erfolgen. Folgende Parameter können
im $settings-Array definiert werden:
value |
Initialer Wert des Inputs (value) als String. Muss im selben Format angegeben werden wie eingestellt.
|
date_format |
Datumsformat als String, es können Kombinationen aus folgenden
Zeichen übergeben werden:
dd.mm.yy
|
input_class |
CSS-Klasse des eingefügten <input>-Elements als String;
Standardmäßig form-control
|
input_id |
ID des eingefügten <input>-Elements als String
|
input_name |
name-Attribut des eingefügten <input>-Elements als String
|
required |
Ob das eingefügte <input>-Element ausgefüllt werden muss (Boolean); Standard true
|
Beispiele
generelle Verwendung
<?php
echo datepicker(
array(
"date_format" => "DD, 'dem' d.m.yy",
"value" => "Mittwoch, dem 3.7.2019",
"required" => false
)
);
?>barrierefreie Verwendung
Um eine Beschreibung für das Eingabefeld bereitzustellen kann ein
<label>-Element verwendet werden. Dieses wird über
die festgelegte ID dem Eingabefeld zugewiesen. Die Beschreibung sollte
den Zweck und das gewünschte Format des Eingabefelds enthalten.
<label for="dpExample">Gewünschtes Datum (im Format dd/mm/yyyy):</label>
<?php
echo datepicker(
array(
"date_format" => "dd/mm/yy",
"input_id" => "dpExample"
)
);
?>
