4.9.5 Options de représentation type date
Les options de représentation indiquées dans la structure de la famille ne sont pas prises en compte dans les interfaces HTML5.
Le widget d'édition des date est basé sur un widget kendo UI Date Picker
.
4.9.5.1 setKendoDateConfiguration
4.9.5.1.1 Restrictions
Attention : Les options propres à Kendo ne sont pas maintenues par Anakeen et leur bon fonctionnement n'est pas garanti par Anakeen.
4.9.5.1.2 Paramètres
L'argument config
est un tableau de valeurs indexées qui servent à modifier la configuration du widget.
En modification, les valeurs possibles sont les propriétés de configuration du widget kendo ui
.
4.9.5.1.3 Cas particuliers
- En consultation, seule la clé
format
est prise en compte. - La clé format est un format de date Kendo
4.9.5.1.4 Exemples
Affichage de la date avec le jour de la semaine suivant la locale. Imposer une date inférieure à la date du jour
$options->date("MyFamily::my_birthday")->setKendoDateConfiguration( array( "format"=>"D", "footer"=>"La date de naissance" "max" => date("Y-m-d") ) );
4.9.5.2 setFormat
Cette option permet de modifier l'aspect de la valeur de l'attribut.
Dcp\Ui\DateRenderOptions setFormat(string $format)
4.9.5.2.1 Restrictions
- Utilisable uniquement pour les rendus de consultation.
4.9.5.2.2 Paramètres
L'argument format
est un template Mustache.
Les variables qu'il peut utiliser sont :
-
value
: Valeur brute, -
displayValue
: Valeur formatée par le serveur.
Ce format doit être un fragment HTML valide.
Par défaut, le format est {{displayValue}}
.
Ce format est différent de celui
indiqué par le widget kendo ui
. La valeur de la variable {{displayValue}}
contient la valeur formatée par le widget si un format widget est précisé.
4.9.5.2.3 Cas particuliers
Aucun
4.9.5.2.4 Exemples
4.9.5.3 setPlaceHolder
Cette option indique un texte qui est placé dans le champ de saisie lorsque la valeur est vide pour préciser le rôle de ce champ.
Dcp\Ui\DateRenderOptions setPlaceHolder(string $text)
4.9.5.3.1 Restrictions
- Utilisable uniquement pour les rendus de modification ou de création.
4.9.5.3.2 Paramètres
L'argument $text
est un texte simple (pas de html) qui sera utilisé comme
placeholder du champ.
4.9.5.3.3 Cas particuliers
Aucun
4.9.5.3.4 Exemples
$options->date(My_family::my_date) ->setPlaceHolder("Select a future date");