Les éléments standards fournis avec Zend FrameworkZend Framework est fournis avec des classes d'éléments couvrant la plupart des éléments de formulaire HTML. La plupart spécifie un helper de vue en particulier à utiliser pour décorer un élément, mais plusieurs d'entre elles offrent des fonctionnalités supplémentaires. Ce qui suit est une liste de toutes ces classes, ainsi que des descriptions des fonctionnalités offertes. Zend_Form_Element_ButtonUtilisé pour créer des éléments boutons, Zend_Form_Element_Button étend Zend_Form_Element_Submit, spécifie quelques fonctionnalités personnalisées. Il spécifie le helper de vue 'formButton' pour la décoration. Comme l'élément submit, il utilise le label de l'élément en tant que valeur de l'élément lors de l'affichage ; autrement dit, pour définir le text du bouton, définissez la valeur de l'élément. Le label sera traduit si l'adapteur de traduction est présent. Comme le label est utilisé comme faisant partie de l'élément, l'élément bouton utilise seulement ViewHelper et les décorateurs DtDdWrapper. Après avoir rempli ou validé un formulaire, vous pouvez vérifier si le bouton donné a été cliqué en utilisant la méthode isChecked(). Zend_Form_Element_CaptchaLes CAPTCHAs sont utilisé pour empêcher la soumission automatique des formulaires par des bots et autre processus automatisés. L'élément de formulaire Captcha permet de spécifier quel Adapteur Zend_Captcha vous désirez utiliser. Il définit ensuite cet adapteur comme validateur à l'objet, et utilise le décorateur du Captcha pour l'affichage (ce qui fait office de proxy vers l'adapteur CAPTCHA). Les adapteurs peuvent être n'importe quel adapteur de Zend_Captcha, ou n'importe quel adapteur que vous avez défini par ailleurs. Pour permettre ceci, vous devrez passer une clé supplémentaire de plugin loader, 'CAPTCHA' ou 'captcha', lorsque vous spécifiez un prefixe de chemin de plugin loader :
Le Captcha peut ensuite être enregistré en utilisant la méthode setCaptcha(), qui prend en paramètre soit une instance concrête de CAPTCHA soit le nom court d'un adapteur CAPTCHA :
Si vous souhaitez charger votre élément via la configuration, spécifiez soit la clé 'captcha' avec un tableau contenant la clé 'captcha', soit les clés 'captcha' et 'captchaOptions' :
Le décorateur utilisé est déterminé lors de la récupération de l'adapteur du captcha. Par défaut, le décorateur du captcha est utilisé, mais un adapteur peut spécifier un décorateur différent via sa méthode getDecorator(). Comme noté, l'adapteur de captcha lui même agit comme un validateur pour l'élément. De plus, le validateur NotEmpty n'est pas utilisé, et l'élément est marqué comme requis. Dans la plupart des cas, vous n'aurez besoin de rien d'autre pour que le captcha soit présent dans votre formulaire. Zend_Form_Element_CheckboxLes cases à cocher HTML vous permettent de retourner une valeur spécifique, mais elles fonctionnent essentiellement comme des booléens. Lorsque elle est cochée, la valeur de la case à cocher est soumise. Lorsque la case à cocher n'est pas cochée, rien n'est soumis. En interne, Zend_Form_Element_Checkbox applique cet état. Par défaut, la valeur cochée est '1', et la valeur non cochée est '0'. Vous pouvez spécifier les valeurs en utilisant respectivement les accesseurs setCheckedValue() et setUncheckedValue(). En interne, à chaque fois que vous définissez une valeur, si la valeur fournie correspond à la valeur cochée, alors elle sera définie, mais toutes autres valeurs aura pour effet que la valeur non cochée sera sélectionnée.
En sus, définir la valeur définit la propriété Zend_Form_Element_Checkbox utilise le helper de vue 'formCheckbox'. La valeur cochée est toujours utilisé pour le remplir. Zend_Form_Element_File
L'élément de formulaire File fournit un mécanisme pour fournir des champs
d'upload de fichier à votre formulaire. Il utilise Zend_File_Transfer
en interne pour fournir cette fonctionnalité et le helper de vue
Par défaut, il utilise l'adapteur de transfert Example #1 Utilisation de l'élément de formulaire File L'explication d'utilisation de l'élément de formulaire File ci-dessous peut sembler ésotérique, mais l'usage est en fait relativement trivial :
Vous devez aussi vous assurer que le type d'encodage correct est fourni au formulaire ; vous devez utiliser 'multipart/form-data'. Vous pouvez faire cela en définissant l'attribut 'enctype' du formulaire:
Après que le formulaire soit validé avec succès, vous devriez recevoir le fichier afin de le stocker dans sa destination finale en utilisant receive(). De plus, vous pouvez déterminer son emplacement finale en utilisant getFileName():
Par défaut, le fichier sera automatiquement reçu quand vous appellerez getValues() sur le formulaire. La raison derrière ce comportement est que le fichier lui même est la valeur de l'élément fichier.
Cela dit, parfois vous aurez besoin d'appeller getValues() sans recevoir le fichier. Vous pouvez l'archiver en appellant setValueDisabled(true). Afin de recevoir la véritable valeur de ce flag vous pouvez appeller isValueDisabled(). Example #2 Récupération explicite de fichier Tout d'abord appellez setValueDisabled(true).
Désormais le fichier sera reçu lorsque vous appellerez getValues(). Donc vous devez appeller vous même receive() sur l'élément fichier, ou une instance de Zend_File_Transfer .
Il ya plusieurs étapes du fichier uploadés qui peuvent être vérifiées avec les méthodes suivantes :
Example #3 Vérifier si un fichier optionnel a été uploadé
Zend_Form_Element_File supporte aussi les fichiers multiples. En appellant la méthode setMultiFile($count) vous pouvez définir, le nombre d'éléments fichier à créer. Ceci vous évite de définir les mêmes réglages plusieurs fois. Example #4 Définir plusieurs fichiers Créer un élément multifichier est identique à la création d'un élément unique. Appellez simplement setMultiFile() après que l'élément soit créé:
Vous avez maintenant 3 éléments d'upload de fichier identiques avec les mêmes paramètres. Pour obtenir le nombre de fichiers multiples défini, appellez simplement getMultiFile().
Afin de limiter, vous pouvez spécifier la taille maximum d'un fichier en définissant l'option MAX_FILE_SIZE sur le formulaire. Quand vous définissez cette valeur en utilisant la méthode setMaxFileSize($size), elle sera affiché avec l'élément fichier.
Zend_Form_Element_HashCette élément fournit une proctection contre les attaques CSRF sur les formulaires, en s'assurant que les données sont soumises par la session utilisateur qui a générée le formulaire et non par un script malveillant. La protection est réalisée en ajouté un élément de hachage au formulaire et en le vérifiant lors de la soumission du formulaire. Le nom de l'élément de hachage doit être unique. Nous recommandons d'utiliser l'option salt pour l'élément - deux hachages ayant le même nom mais des salt différent ne causeront pas de collision : Vous pouvez définir le salt ultérieurement en utilisant la méthode setSalt($salt). En interne, l'élément stocke un identifiant unique en utilisant Zend_Session_Namespace, et le vérifie lors de la soumission (en vérifiant que le TTL n'a pas expiré). Le validateur 'Identical' est ensuite utilisé pour s'assurer que le hachage soumis correspond au hachage stocké. Le helper de vue 'formHidden' est utilisé pour rendre l'élément dans le formulaire. Zend_Form_Element_ImageDes images peuvent être utilisées comme éléments de formulaires, et vous pouvez utiliser ces images en tant qu'éléments graphiques sur les boutons de formulaires.
Les images ont besoin d'une image source. Zend_Form_Element_Image
permet de la spécifier en utilisant l'accesseur setImage()
(ou la clé de configuration 'imageValue'). Quant la valeur définie pour l'élément
corresponde à
Les éléments image utilise le
décorateur Image
pour le rendu, en plus des décorateur standard Errors,
HtmlTag et Label. Vous pouvez spécifier une balise en option au décorateur
Zend_Form_Element_MultiCheckboxSouvent, vous pouvez avoir un ensemble de case à cocher apparenté, et vous souhaitez grouper ces résultat. Cela ressemble beaucoup à Multiselect, mais au lieu que ce soit une liste déroulant, vous avez besoin d'afficher des paires case à cocher/valeur. Zend_Form_Element_MultiCheckbox rend cela simple comme bonjour. Comme tous les éléments qui étendent l'élément de base Multi, vous pouvez spécifier une liste d'options et les valider simplement à l'aide de cette même liste. Le helper de vue 'formMultiCheckbox' s'assure qu'elles seront retournées dans un tableau lors la soumission du formulaire.
Par défaut, cet élément enregistre un validateur Vous pouvez manipuler les diverses options de case à cocher en utilisant les méthodes suivantes :
Pour marquer les éléments cochés, vous devez passer un tableau de valeur à setValue(). Ce qui suit cochera les valeur "bar" et "bat": Notez que même en définissant une valeur unique vous devrez passer un tableau. Zend_Form_Element_Multiselect
Les éléments
Si un adapteur de traduction est enregistré au niveau du formulaire et/ou de l'élément, les valeurs des options seront traduites dans le cadre de l'affichage.
Par défaut, cette élément utilise un validateur Zend_Form_Element_PasswordLes éléments mot de passe sont fondamentalement des éléments texte normaux -- à l'exception du fait que vous ne voulez pas que le mot de passe soumis soit affiché dans les messages d'erreurs ou lorsque le formulaire est affiché à nouveau. Zend_Form_Element_Password effectue cela en appellant setObscureValue(true) sur chaque validateur (s'assurant ainsi que le mot de passe est dissimulé dans les messages d'erreur de validation), et utilise le helper de vue 'formPassword' qui n'affiche pas la valeur qui lui est passé). Zend_Form_Element_Radio
Les éléments radio vous permettend de spécifier plusieurs options, parmi
lesquelles vous n'avez besoin que d'une seule. Zend_Form_Element_Radio
étend la classe de base Zend_Form_Element_Multi,
vous permettant ainsi de spécifier un nombre indéfini d'options, et utilise
ensuite le helper de vue
Par défaut, cette élément utilise un validateur Comme tous les éléments étendant la classe de base Multi element, les méthodes suivantes peuvent être utilisé pour manipuler les options radio affichées :
Zend_Form_Element_ResetLes boutons de mise à zéro sont typiquement utilisé pour vider un formulaire, et ne font pas partie des données soumises. Cela dit, comme ils remplissent un rôle dans l'affichage, ils sont inclus dans les éléments standards. Zend_Form_Element_Reset étend Zend_Form_Element_Submit. Ainsi, le label est utilisé pour l'affichage du bouton et sera traduit, si un adapteur de traduction est présent. Il utilise seulement les décorateurs 'ViewHelper' et 'DtDdWrapper', puisqu'il ne devrait jamais y avoir de messages d'erreur pour ces éléments, le label ne sera pas non plus nécessaire. Zend_Form_Element_SelectLes listes d'options sont une manière habituelle de limiter des choix spécifiques. Zend_Form_Element_Select vous permet de les générer rapidement et facilement.
Par défaut, cette élément utilise un validateur Comme il étend l'élément de base Multi, les méthodes suivantes peuvent être utilisées pour manipuler les options du select :
Zend_Form_Element_Select utilise le helper de vue 'formSelect pour la décoration. Zend_Form_Element_SubmitLes boutons Submit sont utilisé pour soumettre un formulaire. Vous pouvez utiliser plusieurs boutons submit ; vous pouvez utiliser le bouton utilisé pour soumettre le formulaire afin de décider quelle action effectuer avec les données soumises. Zend_Form_Element_Submit rend cette décisions simple, en ajoutant une méthode isChecked() method ; puisqu'un seul élément bouton sera soumis par le formulaire, après avoir rempli ou validé le formulaire, vous pourrez appeller cette méthode sur chacun des boutons submit afin de déterminer lequel a été utilisé. Zend_Form_Element_Submit utilise le label comme "value" du bouton submit, il sera traduit si un adapeur de traduction est présent. isChecked() vérifie la valeur soumises avec le label pour déterminer si le bouton a été utilisé. Les décorateurs ViewHelper et DtDdWrapper sont utilisé pour rendre cet élément. Aucun décorateur de label n'est utilisé, puisque le label du bouton est utilisé lors du rendu de l'élément ; de plus, vous n'associerez aucune erreurs avec l'élément submit. Zend_Form_Element_TextDe loin le type d'élément de formulaire le plus répandu est l'élément text, celui ci autorise des saisies de texte limité ; c'est un élément idéal pour la plupart des saisies de données. Zend_Form_Element_Text utilise simplement le helper de vue 'formText' pour afficher l'élément. Zend_Form_Element_TextareaLes Textareas sont utilisé lorsque de grandes quantités de texte sont attendues, et ne limite pas la quantité de texte soumise (si ce n'est la taille limite fixée par votre serveur ou PHP). Zend_Form_Element_Textarea utilise le helper de vue 'textArea' pour afficher ces éléments, et place la valeur comme contenu de l'élément.
|
|