Chaque contrôle doit avoir un identifiant (= un nom). Vous devez en indiquer un avec l'attribut ref. Cet identifiant correspond en fait à ce qu'on appelle une variable de formulaire et qui contiendra la valeur saisie.

Exemple:

  <input ref="nom">
  </input>

Note : quand vous voulez utiliser un formulaire avec un ou plusieurs DAO, il est judicieux d'utiliser les mêmes noms que les propriétés des DAO, afin de pouvoir utiliser les mécanismes de chargement et sauvegarde automatique de jForms avec les DAO.

Tout champ de saisie doit contenir un libellé indiqué au moyen de la balise <label> :

  <input ref="nom">
    <label>Votre nom</label>
  </input>

On peut indiquer une locale plutôt qu'une chaine "en dur" :

  <input ref="nom">
    <label locale="mymodule~forms.input.name"/>
  </input>

Pour rendre la saisie obligatoire sur un champ de saisie, il faut mettre l'attribut required avec la valeur true. Cet attribut n'est pas valable sur les éléments <submit>, <checkbox>, <group>, <choice>, <hidden> et <output>.

Il est possible d'empêcher la modification d'un champ de saisie. Pour cela, il faut mettre l'attribut readonly avec la valeur true. Cet attribut n'est pas valable sur l'élément <submit> et <output>. Vous pouvez modifier cette propriété en PHP.

Un message d'aide (optionnel) peut être affiché en même temps que le contrôle de saisie, grâce à la balise <help> : vous y inscrivez soit le message d'aide, soit la locale (via l'attribut locale).

  <input ref="datenaissance" type="date">
    <label locale="mymodule~forms.input.naissance"/>
    <help>Indiquez votre date de naissance, en respectant le format aaaa-mm-jj</help>
  </input>

ou

  <input ref="datenaissance" type="date">
    <label locale="mymodule~forms.input.naissance"/>
    <help locale="mymodule~forms.input.naissance.help"/>
  </input>

Dans les formulaires en HTML, un point d'interrogation s'affichera à côté du champ de saisie et le message d'aide s'affichera lors d'un clic sur ce point d'interrogation. (Ce comportement peut être modifié en fournissant votre propre générateur).

Un autre type de message informatif peut être affiché sous forme de tooltip. Il faut pour cela utiliser la balise <hint>, qui s'utilise comme la balise <help>.

Quand le contenu du champ de saisie est invalide (il n'est pas du type attendu par exemple), ou que la saisie est manquante lorsqu'elle est requise (attribut required), jForms affiche des messages d'erreurs prédéfinis. Cependant vous pouvez fournir vous-mêmes ces messages au moyen de la balise <alert>. Un attribut type permet de définir soit le message pour l'erreur d'invalidité, soit le message pour la saisie obligatoire. Et comme les balises précédentes, vous pouvez indiquer le message complet, ou indiquer une locale au moyen de l'attribut locale.

  <input ref="datenaissance" type="date">
    <label locale="mymodule~forms.input.naissance"/>
    <alert type="required" locale="mymodule~forms.input.naissance.error.required"/>
    <alert type="invalid">Le format de la date à respecter pour la saisie est aaaa-mm-jj</alert>
  </input>

Pour afficher un simple champ de saisie, il faut utiliser la balise <input>. Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que les attributs readonly et required. Vous pouvez indiquer aussi ces attributs supplémentaires : type, defaultvalue, size, minlength, maxlength et pattern.

defaultvalue permet d'indiquer une valeur par défaut qui sera affichée quand le formulaire est vide. Vous pouvez mettre la valeur "now" pour les champs de saisie de dates. La valeur par défaut sera alors la date de maintenant.

size permet d'indiquer la largeur de la boîte de saisie en nombre de caractères.

maxlength et minlength permet d'ajouter une contrainte sur la valeur saisie : la longueur minimale et maximale de la chaine de caractère saisie. Ces deux attributs ne sont utilisables que pour le type="string".

pattern: Il doit contenir une expression rationnelle compatible avec PHP et JS. Il n'est utilisatble que pour type="string".

type permet d'indiquer le format de données que l'utilisateur doit respecter. Au moment de l'envoi du formulaire, il y aura une vérification en javascript du contenu saisi, mais aussi une vérification côté serveur (au cas où le javascript est désactivé notamment) lors de l'appel à la méthode check() sur l'objet formulaire.

Voici les valeurs possibles pour l'attribut type et ce que doit taper l'utilisateur :

• "string" : chaîne contenant n'importe quel caractère. (c'est le type par défaut)
• "boolean" : la valeur du champ doit être obligatoirement "true" ou "false"
• "decimal" : un nombre avec ou sans virgule
• "integer" : un nombre entier
• "hexadecimal" : un nombre hexadecimal (chiffres de 0 à 9 et lettres de a à f)
• "datetime", "date", "time" : une date et heure, une date ou une heure. Le format précis est respectivement "aaaa-mm-jj hh:mm:ss", "aaaa-mm-jj", "hh:mm:ss".
• "localedatetime", "localedate", "localetime" : une date et heure, une date ou une heure, mais dans le format de la langue de l'utilisateur. Par exemple, pour un site en français, le format de la date devra être "jj/mm/aaaa", et pour un site en anglais "mm/jj/aaaa".
• "url" : la chaîne doit être une URL valide
• "email" : un email
• "ipv4" : une adresse IP v4
• "ipv6" : une adresse IP v6
• "html" : du code HTML. Le contenu HTML sera "purifié" coté serveur, pour éviter les problèmes de sécurité comme CSS, XSS...

Un exemple de champ de saisie simple :

  <input ref="email" type="email">
     <label locale="monmodule~monform.email.label" />
     <hint>L'email doit être valide</hint>
  </input>

Un exemple de champ de saisie ave un pattern :

  <input ref="url" type="string" pattern="/^[a-z0-9\-]+$/">
      <label>Url</label>
  </input>

Pour permettre la saisie d'un texte de plusieurs lignes, il faut utiliser la balise <textarea>. Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que les attributs readonly, required et type="html". Il y a plusieurs attributs spécifiques à cette balise : defaultvalue, rows, cols, minlength et maxlength.

defaultvalue permet d'indiquer une valeur à afficher automatiquement pour un nouveau formulaire, tandis que rows et cols permettent de fixer la taille du champs de saisie en hauteur et largeur (comme le textarea en HTML).

Un exemple :

  <textarea ref="message">
     <label locale="monmodule~monform.message.label" />
     <hint>Saisissez ici le message</hint>
  </textarea>

maxlength et minlength permettent d'ajouter une contrainte sur la valeur saisie : la longueur minimale et maximale de la chaine de caractères saisie.

Si vous voulez que l'utilisateur puisse saisir du HTML et qu'il y ait une vérification du contenu coté serveur pour éviter les problèmes de sécurité, mettez l'attribut type="html".

Pour utiliser un éditeur HTML wysiwyg dans votre formulaire, il faut utiliser la balise <htmleditor>.

  <htmleditor ref="description">
	<label>Description du produit</label>
  </htmleditor>

Par défaut, l'éditeur utilisé est wymeditor (pour le générateur "html" et "htmllight"). On peut spécifier une configuration spécifique pour l'éditeur ainsi que l'editeur, via l'attribut config, mais aussi une feuille de style pour la décoration de l'éditeur, via l'attribut skin.

Vous pouvez changer d'éditeur (fckeditor, tinymce...), en l'indiquant dans la configuration de l'editeur.

Pour savoir utiliser ces attributs et configurer un éditeur comme vous le souhaitez, voir la page sur htmleditor.

Vous pouvez utiliser un textarea pour éditer du contenu wiki. Cependant il y a l'element <wikieditor> qui permet de specifier que c'est du contenu wiki, et les générateurs peuvent afficher une barre d'outils pour faciliter l'édition. Il utiliseront automatiquement WikiRenderer (jWiki) pour transformer le contenu en HTML et l'afficher.

  <wikieditor ref="description">
	<label>Description du produit</label>
  </wikieditor>

Vous pouvez indiquer une configuration pour la barre d'outil, avec l'attribut config. Pour en savoir plus, voir la page sur wikieditor.

La balise <date> et <datetime> facilitent la saisie d'une date par rapport à un simple <input>.

  <date ref="naissance">
	<label>Date de naissance</label>
  </date>

L'attribut ref est obligatoire, et vous pouvez utiliser les attributs defaultvalue, readonly, et required, ainsi que les balises <label>, <hint>, <alert>, et <help>.

Il y aussi les attributs spécifiques mindate, maxdate et datepicker. Pour savoir comment utiliser datepicker, voir la page dediée.

Pour les attributs mindate et maxdate, vous pouvez utiliser soit une date absolue au format DB comme '2009-01-01', soit une chaine qui contient une valeur qui sera analysée par la fonction PHP strtotime. Cette dernière solution reste la plus pratique. Par exemple pour une date de naissance si l'on veut que des dates de naissance des personnes de 18 à 70 ans :

  <date ref="naissance" mindate="-70 years" maxdate="-18 years">
	<label>Date de naissance</label>
  </date>

On peut aussi faire la même chose si l'on veut une date de début au minimum égale à aujourd'hui et une date maximum à 2 mois 1 jour

  <date ref="date_debut" mindate="now" maxdate="+2 months 1 day">
	<label>Début de l'évènement</label>
  </date>

Pour la saisie d'un mot de passe ou tout autre renseignement qui doit être caché lors de la saisie, vous utiliserez la balise <secret>. Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que les attributs readonly et required.

  <secret ref="password">
     <label>Votre mot de passe</label>
     <hint>Indiquez le mot de passe que l'on vous a donné à l'inscription</hint>
  </secret>

Vous pouvez utiliser l'attribut size pour indiquer la largeur du champ de saisie.

Il est souvent utile de demander à l'utilisateur de saisir une deuxième fois un nouveau mot de passe, lors d'une inscription par exemple. jForms gère cela automatiquement. Il suffit d'indiquer la balise <confirm> dans la balise <secret>, et le formulaire HTML généré contiendra deux champs de saisie. La balise <confirm> doit contenir soit l'intitulé du libellé pour la confirmation, soit un attribut locale contenant le sélecteur de la locale pour le libellé de la confirmation.

  <secret ref="newpassword">
     <label>Mot de passe</label>
     <hint>Indiquez un nouveau mot de passe</hint>
     <confirm>Retapez ce mot de passe</confirm>
  </secret>

Cela génèrera en gros, pour un formulaire html :

   <label for="newpassword">Mot de passe</label>
        <input type="password" id="newpassword" name="newpassword" title="Indiquez un nouveau mot de passe"/>

   <label for="newpassword_confirm">Retapez ce mot de passe</label>
        <input type="password" id="newpassword_confirm" name="newpassword_confirm"/>

Pour afficher une case à cocher, utiliser la balise <checkbox>. Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que l'attribut readonly et required.

  <checkbox ref="souvenir">
     <label>Se souvenir de moi</label>
     <help>Cochez cette case si vous voulez être identifié automatiquement la prochaine fois</help>
  </checkbox>

Par défaut, la valeur de la case à cocher, que vous récupèrerez une fois le contenu du formulaire reçu, vaudra 0 si la case n'a pas été cochée, ou 1 si elle l'a été.

Vous pouvez décider d'autres valeurs pour chacun de ces deux états. Il suffit d'indiquer les attributs valueoncheck et valueonuncheck (qui valent donc par défaut, respectivement 1 et 0). Exemple :

  <checkbox ref="souvenir" valueoncheck="O" valueonuncheck="N">
     <label>Se souvenir de moi</label>
     <help>Cochez cette case si vous voulez être identifier automatiquement la prochaine fois</help>
  </checkbox>

Notez que lorsque vous afficherez un formulaire pré-rempli, la case sera cochée ou non en fonction de la valeur initiale, selon que celle-ci corresponde à la valeur de valueoncheck ou de valueonuncheck.

On peut avoir à afficher une série de cases à cocher qui correspondent à des choix multiples, par exemple afficher une liste de choses à acheter, et l'utilisateur coche les articles qu'il veut acheter. Pour cela on utilisera la balise <checkboxes> (avec un S à la fin).

Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que les attributs readonly et required.

Il vous faut aussi indiquer la liste des valeurs possibles et leurs libellés. Voir la section "sources de données" plus bas.

Exemple :

   <checkboxes ref="articles">
      <label>Sélectionnez les articles que vous voulez acheter :</label>
      <item value="54">sucre</item>
      <item value="27">steack</item>
      <item value="32">jus d'orange</item>
  </checkboxes>

Ceci affichera une série de trois cases à cocher, ayant pour intitulé "sucre", "steack" et "jus d'orange". Quand le formulaire sera envoyé au serveur, la valeur que vous recevrez pour la variable de formulaire "articles", sera un tableau PHP contenant les valeurs des cases qui ont été cochées. Par exemple, si l'utilisateur a coché "steack", coté serveur vous recevrez array(27). Si en plus "sucre" est coché, vous recevrez array(54, 27).

(voir la page sur la gestion du contenu d'un formulaire coté serveur).

Les boutons radios vont toujours par groupe, d'au moins 2. Pour déclarer un groupe de boutons radio, vous utiliserez la balise <radiobuttons>.

Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que les attributs readonly et required. Comme pour les autres contrôles de type liste, vous devez indiquer la liste des valeurs possibles et leurs libellés. Voir la section "sources de données" plus bas.

Exemple :

   <radiobuttons ref="couleur">
      <label>Couleur de votre voiture:</label>
      <item value="r">Rouge</item>
      <item value="b">Bleue</item>
      <item value="v">Verte</item>
      <item value="j">Jaune</item>
  </radiobuttons>

Ceci affichera une série de 4 boutons radio, et la valeur choisie sera stockée dans la variable de formulaire "couleur".

La balise <menulist> affiche une liste déroulante (<select size="1"> en HTML), et de par sa nature, un seul choix est possible. Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que les attributs readonly et required. Comme pour les autres contrôles de type liste, vous devez indiquer la liste des valeurs possibles et leurs libellés. Voir la section "sources de données" plus bas.

Exemple :

   <menulist ref="ville">
      <label>votre ville :</label>
      <item value="75000">Paris</item>
      <item value="37000">Tours</item>
      <item value="44000">Nantes</item>
      <item value="69000">Lyon</item>
  </menulist>

La variable de formulaire contiendra la valeur de l'item sélectionné.

Par défaut, si il n'y a pas l'attribut required="true", il n'est pas obligatoire de faire un choix dans la liste. Vous avez donc automatiquement un premier choix "vide" qui est pré-selectionné. Si vous voulez indiquer le libellé de ce choix vide, vous devez utiliser l'élement <emptyitem>.

   <menulist ref="ville">
      <label>votre ville :</label>
      <emptyitem>faites votre choix</emptyitem>
      <item value="75000">Paris</item>
      <item value="37000">Tours</item>
      <item value="44000">Nantes</item>
      <item value="69000">Lyon</item>
  </menulist>

Vous pouvez bien sûr utiliser une locale :

      <emptyitem locale="module~foo.bar"/>

Les listes déroulantes, ou encore listbox (Équivalent de la balise <select> en HTML), sont déclarées au moyen de balise <listbox>. Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que les attributs readonly et required. Comme pour les autres contrôles de type liste, vous devez indiquer la liste des valeurs possibles et leurs libellés. Voir la section "sources de données" plus bas.

   <listbox ref="rubrique">
      <label>Rubrique préférée :</label>
      <item value="1">Tutoriels</item>
      <item value="2">Manuels</item>
      <item value="3">Forums</item>
  </listbox>

Vous pouvez indiquer un attribut size qui permet d'indiquer le nombre d'items affichables en même temps (donc la hauteur de la liste). Par défaut, elle vaut 4.

Par défaut, un seul choix est possible. Cependant en ajoutant l'attribut multiple="true", l'utilisateur pourra sélectionner plusieurs éléments de la liste (dans une page HTML, il faut que l'utilisateur appuie sur la touche CTRL en même temps qu'il clique sur un item). Dans ce cas, dans la variable de formulaire "rubrique", au lieu d'avoir une simple valeur correspondant à l'item sélectionné, vous aurez un tableau PHP avec toutes les valeurs des items choisis.

Pour permettre à l'utilisateur de télécharger un fichier vers le serveur, vous pouvez utiliser la balise <upload> (équivalent de <input type="file"> en HTML). Comme pour les autres contrôles, vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> ainsi que les attributs readonly et required.

Deux attributs supplémentaires sont à votre disposition, pour contrôler la nature et la taille des fichiers, qui sont respectivement mimetype (devant contenir un ou plusieurs type mime) et maxsize (taille en octets).

Attention : sous IE, le type-mime des images .jpg et .jpeg sont considéré comme du Progressive JPEG, soit image/pjpeg. Assurez vous de rajouter ce type-mime en plus du image/jpeg si vous voulez autoriser le format JPEG.

  <upload ref="photo" mimetype="image/jpeg;image/pjpeg;image/png" maxsize="20000">
    <label>Votre photo</label>
  </upload>

À la réception du fichier, jForms vérifie s'il correspond au type et à la taille indiqués, et l'on peut ensuite lui indiquer où stocker le fichier téléchargé. La variable de formulaire contiendra le nom du fichier.

Il peut être utile de regrouper plusieurs contrôles dans un groupe, que ce soit pour l'aspect visuel, ou pour les manipuler ensemble. Pour ce faire, il faut placer les contrôles dans une balise <group>. Cette balise doit avoir un attribut ref, mais peut avoir aussi un attribut readonly, ce qui met en lecture seule tous les contrôles qui s'y trouvent. D'ailleurs, certaines opérations faites sur l'objet PHP correspondant à <group>, impactent sur les contrôles.

Un groupe doit aussi posséder un label.

Exemple de groupe :

  <group ref="un_groupe">
     <label>identité</label>
     <input ref="nom"><label>nom</label></input>
     <input ref="prenom"><label>prénom</label></input>
  </group>

Il arrive que l'on veuille proposer à l'utilisateur de faire un choix entre plusieurs cas, et que pour certains choix, on doive donner des renseignements complémentaires. jForms propose pour cela la balise <choice>. Elle contient des balises <item> pour chacun des choix, et dans chacune de ces balises <item>, on indique un <label>, et 0,1 ou plusieurs champs de saisie.

   <choice ref="status">
     <label>Status du bug</label>
     <item value="new"> <label>Nouveau</label> </item>
     <item value="res"> 
         <label>resolu</label>
         <menulist ref="resolution">
            <label>Résolution du bug</label>
            <item value="0">Corrigé</item>
            <item value="1">invalide</item>
            <item value="2">Ne sera pas corrigé</item>
         </menulist>
     </item>
     <item value="dup">
         <label>duplicata</label>
         <input ref="dup_bug"><label>Numéro du bug</label></input>
     </item>
   </choice>

Quand l'utilisateur choisit un des items, les champs des autres items sont désactivés.

La balise <choice> accepte les balises <help>, <hint>, <alert> ainsi que les attributs readonly, required et selectedvalue. Cet attribut peut comporter la valeur de l'item sélectionné par défaut. Une autre façon de sélectionner par défaut un item est de mettre un attribut selected="true" sur la balise <item> correspondant.

Dans certain contexte, il est nécessaire d'empêcher la saisie automatique des formulaire (par des robots spammeurs par exemple).

JForms fourni la balise <captcha> pour inclure automatiquement un champs de saisie qui permettra de vérifier que le formulaire est bien saisie par un humain. Pour le moment, ce champs de saisie n'est pas une image à déchiffrer comme on le voit sur certain site, mais une simple champs texte dans lequel il faut indiquer la réponse à une question posée, affichée automatiquement par jForms.

 <captcha ref="antispam">
    <label>Vérification anti-spam</label>
 </captcha>

La balise accepte les attributs communs et les balises d'aide.

Les questions posées sont stockées dans un fichier de locales, dans le module jelix. Exemple pour le français : lib/jelix/core-modules/jelix/locales/fr_FR/captcha.UTF-8.properties. Ce fichier contient une première locale, number, qui indique le nombre de question, et ensuite les questions et réponses numérotées. Vous pouvez redéfinir ce fichier pour ajouter ou modifier les questions et réponses. Voir le chapitre sur la redéfinition des fichiers.

Dans un formulaire, il faut bien sûr au moins un bouton qui permette à l'utilisateur de valider la saisie et envoyer les données au serveur. Vous déclarez un bouton de ce type avec la balise <submit>. Comme pour les autres contrôles, vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> (mais pas les attributs readonly ni required).

  <submit ref="submit">
    <label>Ok</label>
  </submit>

La variable de formulaire correspondante ne contiendra rien d'intéressant. À moins que vous ayez besoin de plusieurs boutons de soumission, représentant par exemple l'action à effectuer après l'envoi du formulaire comme un bouton "prévisualiser" et un autre "sauvegarder". Dans ce cas, vous utiliserez comme pour les autres contrôles de type liste, un dao ou les balises <item> :

  <submit ref="valider">
    <label>Veuillez valider</label>
    <item value="preview">Prévisualiser</item>
    <item value="svg">Sauvegarder</item>
  </submit>

Dans la variable de formulaire "valider", vous aurez alors la valeur "preview" ou "svg", et vous pourrez agir en fonction de ces valeurs dans le contrôleur. Au niveau du formulaire HTML, cela affichera deux boutons avec leurs libellés respectifs "Prévisualiser" et "Sauvegarder".

A noter : le code généré n'est pas compatible avec IE (voir http://jelix.org/forums/forum/5-jelix-ut(..)).

Pour afficher un bouton reset avec jForms, il faut utiliser la balise <reset> :

  <reset ref="reinit">
    <label>Réinitialiser</label>
  </reset>

La balise <output> ne sert qu'à afficher une valeur. Cette dernière ne sera donc pas éditable. Cela peut être utile pour afficher un formulaire de tout un enregistrement sans pour autant éditer tous les champs. Vous devez y mettre l'attribut ref, et vous pouvez utiliser les balises <label>, <hint>, <alert>, <help> (mais pas les attributs readonly ni required).

  <output ref="categorie">
    <label>Catégorie</label>
  </output>

Si vous voulez inclure des champs cachés dans votre formulaire, utilisez la balise <hidden>. Vous devez y mettre l'attribut ref, et vous pouvez utiliser l'attribut defaultvalue. Tout autre balise ou attribut ne sera pas pris en compte.

   <hidden ref="product_id" />

Elles doivent être indiquées au moyen d'une ou plusieurs balises <item>. La valeur du choix doit être mis dans un attribut value. Le libellé du choix doit être mis en tant que contenu de la balise <item>, ou dans un fichier de locale et alors vous indiquez la locale au moyen de l'attribut locale. Si aucun label est indiqué, le label sera la valeur. Exemple :

   <checkboxes ref="objets">
      <label>Vous avez </label>
      <item value="maison">Une maison</item>
      <item value="voiture" locale="mymodule~myform.item.car.label" />
      <item value="bateau"/>
  </checkboxes>

Le contenu d'une liste peut être rempli grâce à un DAO. Vous devez alors mettre une balise <datasource> qui doit avoir au moins 3 attributs :

1. dao, indiquant le sélecteur de la DAO à utiliser
2. method, indiquant la méthode de la DAO qui génère la liste des choix
3. labelproperty, indiquant quelle est la propriété de la DAO qui contient le libellé du choix.

Vous pouvez indiquer un profil jDb (optionnel) à travers l'attribut profile.

La valeur de chaque choix sera la valeur de la clé primaire de la DAO. Cependant, si vous voulez indiquer une autre propriété de la DAO, vous pouvez l'indiquer dans l'attribut valueproperty.

Exemple :

  <menulist ref="conf">
      <label>Sélectionnez l'élément de configuration à éditer</label>
      <datasource dao="testapp~config" method="findAll"
                  labelproperty="cvalue" valueproperty="ckey"/>
  </menulist>

Indiquer une méthode dao qui attend un argument ¶

      <datasource dao="testapp~config" method="findByCat" criteria="admin"
                  labelproperty="cvalue" valueproperty="ckey"/>

  <menulist ref="catlist">
     ...
  </menulist>

  <menulist ref="conf">
      <datasource dao="testapp~config" method="findByCat" criteriafrom="catlist"
                  labelproperty="cvalue" valueproperty="ckey"/>
  </menulist>