4.9.17 Options de représentation type text

Les options de représentation indiquées dans la structure de la famille ne sont pas prises en compte dans les interfaces HTML5.

4.9.17.1 setMaxLength

Cette option permet de limiter le nombre de caractères saisis par l'utilisateur. Cela n'est pas une contrainte et le champ saisie peut excéder cette limite par programmation.

Dcp\Ui\TextRenderOptions setMaxLength(int $max)

4.9.17.1.1 Restrictions

• Utilisable uniquement pour les rendus de modification ou de création.

4.9.17.1.2 Paramètres

L'argument $max est un nombre positif. Si ce nombre est égal à 0, aucune limite n'est appliquée.

4.9.17.1.3 Cas particuliers

Aucun

4.9.17.1.4 Exemples

Limiter la saisie d'un numéro de téléphone à 10 caractères.

$options->text(My_family::my_phone)->setMaxLength(10);

4.9.17.2 setKendoAutoCompleteConfiguration

Cette option permet de configurer le widget d'édition des relations.

Dcp\Ui\DocidRenderOptions setKendoMultiSelectConfiguration(array $config )

4.9.17.2.1 Restrictions

• Utilisable uniquement pour les rendus de modification ou de création.
• Attention : Les options propres à Kendo ne sont pas maintenues par Anakeen et leur bon fonctionnement n'est pas garanti par Anakeen.

4.9.17.2.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.17.2.3 Cas particuliers

• Les propriétés suivantes ne sont pas modifiables :
  • filtering,
  • dataTextField,
  • dataSource,
  • select.

Leur modification est ignorée par le widget.

4.9.17.2.4 Exemples

Modification des paramètres :

$options->docid()->setKendoAutoCompleteConfiguration([
    // Attendre 3 caractères avant de lancer l'aide à la saisie
    "minLength"      => 3,
    // Entête de la recherche
    "headerTemplate" => '<div><h2>Résultat de la recherche</h2></div>'
]);

4.9.17.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\DocidRenderOptions setPlaceHolder(string $text)

4.9.17.3.1 Restrictions

• Utilisable uniquement pour les rendus de modification ou de création.

4.9.17.3.2 Paramètres

L'argument $text est un texte simple (pas de html) qui sera utilisé comme placeholder du champ.

4.9.17.3.3 Cas particuliers

Aucun

4.9.17.3.4 Exemples

$options->text(My_family::my_phone)->setPlaceHolder("Write work phone number");

4.9.17.4 setFormat

Cette option permet de modifier l'aspect de la valeur de l'attribut.

Dcp\Ui\TextRenderOptions setFormat(string $format)

4.9.17.4.1 Restrictions

• Utilisable uniquement pour les rendus de consultation.

4.9.17.4.2 Paramètres

L'argument format est un format Mustache qui a comme variables les informations sur la valeur de l'attribut.

Ces informations pour le type text 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}}.

4.9.17.4.3 Cas particuliers

Aucun

4.9.17.4.4 Exemples

$options->text(My_family::my_title)
    ->setFormat('<h1 class="my-red">{{displayValue}}</h1>');