4.9.13 Options de représentation type int

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 entiers est basé sur un widget Kendo Numeric textbox.

4.9.13.1 setKendoNumericConfiguration

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

Dcp\Ui\IntRenderOptions setKendoNumericConfiguration(array $config )

4.9.13.1.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.13.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

Pour le mode consultation, seul le format est pris en compte.

4.9.13.1.3 Cas particuliers

4.9.13.1.4 Exemples

Ajouter des limites sur le nombre à saisir.

$options->int(My_family::my_number)
    ->setPlaceHolder("Give a number between 10 and 20")
    ->setKendoNumericConfiguration(
        ["min"=>10,
         "max"=>20]
);

4.9.13.2 setFormat

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

Dcp\Ui\IntRenderOptions setFormat(string $format)

4.9.13.2.1 Restrictions

• Utilisable uniquement pour les rendus de consultation.

4.9.13.2.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 int 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.13.2.3 Cas particuliers

Note : 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.13.2.4 Exemples

4.9.13.3 setTranslations

En plus des labels communs à tous les types d'attributs, les labels sur les flèches d'incrémentation et de décrémentation peuvent être configurés.

Dcp\Ui\CommonRenderOptions setTranslations(array $labels)

4.9.13.3.1 Restrictions

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

4.9.13.3.2 Paramètres

Les labels decreaseLabel et increaseLabel indiquent les textes surgissant sur les flèches d'incrémentation et de décrémentation.

4.9.13.3.3 Cas particuliers

4.9.13.3.4 Exemples

Incrément de 5 et pose de l'unité "kg". Modification des traductions.

$options->int(My_Family::my_mass)
    ->setKendoNumericConfiguration([
        "step" => 5, 
        "format" => "#,# kg"
    ])
    ->setTranslations([
        "decreaseLabel"=>"5 kilos de moins",
        "increaseLabel"=>"5 kilos de plus"
    ]);

4.9.13.4 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\IntRenderOptions setPlaceHolder(string $text)

4.9.13.4.1 Restrictions

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

4.9.13.4.2 Paramètres

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

4.9.13.4.3 cas particuliers

4.9.13.4.4 Exemples

$options->int(My_family::my_number)->setPlaceHolder("Number less than 10");