Wiki - 1 output

Redirected from @multiline

	/**
	 * @multiline
	 * @var string
	 */
	public $property_name;

Associée à @var string, cette annotation déclare un texte voué à être saisi et affiché sur une ou plusieurs lignes. Par défaut, les propriétés de type string ne sont pas prévues pour supporter les retours chariots.

- Annotation de type booléen : @multiline sans valeur équivaut à déclarer @multiline true@
- Sans déclaration, la valeur stockée pour cette annotation est false
- Pour annuler dans une classe fille le multi-line déclaré dans une propriété de classe parente ou un trait, déclarez @override property_name @multiline false en entête de classe (voir @override)

Exemples

Représentation d’un champ mono-line : pas de retour à la ligne possible :

Représentation d’un champ @multiline : on peut saisir et visualiser les retours à la ligne :

Effets

L’activation du multi-lines a ces effets sur le comportement de vos applications utilisant les composants standard it.rocks :

- Dans un formulaire, le champs de saisie multi-lines sera un <textarea> et non pas un <input type="text"> dans le cas d’une propriété à saisir sur une ligne.
- Par défaut, les champs de saisie @multiline sont à hauteur automatique, en plus de la largeur automatique activée par défaut en lignes simples et multiples.
- Dans les formulaires de recherche en entête de liste, l’annotation @multiline est sans effet : le champs de saisie est un <input>.
- La méthode Reflection_Property::isMultiline est un raccourcis pour permettre de tester l’activation ou non d’une propriété multi-lignes dans votre code ou dans un template.
- En affichage, le conteneur de la valeur multi-lignes a une classe css multiline. Les skins l’utilisent pour forcer l’affichage des retours à la lignes issus de la valeur de la propriété avec white-space: pre-line.

Nombre de caractères autorisés

La taille de la chaîne de caractères stockée dans la propriété de type texte par défaut est de 0 à 255 caractères, que @multiline soit activé ou non.

Si vous souhaitez activer les lignes multiples pour permettre la saisie d’un texte de taille potentiellement importante, veillez à augmenter le nombre de caractères autorisés avec @max_length.