6.1.1 La propriété type

Description : associe un type de donnée de schéma.

Expression calculée : non.

Valeurs légales : toute valeur de type xsd:QName représentant une définition de type de donnée dans un schéma XML.

Valeur implicite : valeur de type xsd:string.

Règles d'héritage : ne s'hérite pas.

L'effet de cette propriété d'élément de modèle est le même que celui produit par un attribut xsi:type placé sur les données d'instance. Toutefois, contrairement à xsi:type, la propriété type peut s'ajouter aux éléments comme aux attributs.

<instance>
  <my:nom-personne>
    <my:prenom />
    <my:nom xsi:type="my:chaineNonVide" />
  </my:nom-personne>
</instance>
<bind type="my:chaineNonVide" nodeset="/my:nom-personne/my:prenom" />

6.1.2 La propriété readonly

Description : indique si la valeur est interdite de changement.

Expression calculée : oui.

Valeurs légales : toute expression convertible en un type XPath boolean avec la fonction boolean().

Valeur implicite : false(), à moins qu'une propriété calculate ne soit définie alors true().

Règles d'héritage : si un nœud ancêtre est évalué à true, alors cette valeur est traitée comme true. Sinon, la valeur locale est utilisée.

Lorsqu'elle est évaluée à true, cette propriété d'élément de modèle indique au processeur XForms qu'il ne devrait pas autoriser de changements au nœud de donnée d'instance lié.

Outre cette restriction sur les changements de la valeur, la propriété d'élément de modèle readonly fournit une indication à l'interface d'utilisateur XForms. Les commandes de formulaire liées aux données d'instance par la propriété d'élément de modèle readonly devraient indiquer que la saisie et la modification de la valeur ne sont pas permises. La présente spécification ne définit aucun effet en ce qui concerne la visibilité, le focus ou l'ordre de navigation.

<instance>
  <my:nom-personne>
    <my:prenom>Roland</my:prenom>
    <my:nom/>
  </my:nom-personne>
</instance>
<bind nodeset="/my:nom-personne/my:prenom" readonly="true()"/>

6.1.3 La propriété required

Description : définit si une valeur est obligatoire avant que les données d'instance ne soient soumises.

Expression calculée : oui.

Valeurs légales : toute expression convertible en un type XPath boolean avec la fonction boolean().

Valeur implicite : false().

Règles d'héritage : ne s'hérite pas.

Un formulaire peut imposer certaines valeurs, et cette obligation peut être dynamique. Lorsqu'elle est évaluée à true, cette propriété d'élément de modèle indique qu'un nœud de donnée d'instance non vide est obligatoire avant que la soumission des données d'instance puisse intervenir. On définit un nœud non vide ainsi :

1. Si le nœud de donnée d'instance est un élément, alors la valeur de son attribut xsi:nil ne doit pas être fixée à true ;

2. La valeur du nœud de donnée d'instance lié doit être convertible en un type XPath string avec une longueur supérieur à zéro.

Sauf indiqué ci-dessous, la propriété d'élément de modèle required ne fournit aucune indication à l'interface d'utilisateur XForms en ce qui concerne la visibilité, le focus ou l'ordre de navigation. Les auteurs XForms sont fortement encouragés de s'assurer que les commandes de formulaire acceptant des données required soient visibles. Un processeur XForms peut fournir une indication selon laquelle une commande de formulaire est obligatoire et peut en rendre compte immédiatement, y compris en limitant la navigation. Le chapitre 4 Le modèle de traitement contient des précisions sur les moyens dont dispose le processeur XForms pour faire respecter des valeurs obligatoires.

<instance>
  <my:nom-personne>
    <my:prenom>Roland</my:prenom>
    <my:nom />
  </my:nom-personne>
</instance>
<bind nodeset="/my:nom-personne/my:nom" required="true()"/>

6.1.4 La propriété relevant

Description : indique si l'élément de modèle est couramment pertinent. Les nœuds de donnée d'instance ayant cette propriété évaluée à "false" ne sont pas sérialisés pour la soumission.

Expression calculée : oui.

Valeurs légales : toute expression convertible en un type XPath boolean avec la fonction boolean().

Valeur implicite : true().

Règles d'héritage : si un nœud ancêtre est évalué à "false" pour XPath, alors cette valeur est traitée comme "false". Sinon, la valeur locale est utilisée.

Beaucoup de formulaires ont des sections d'entrée de donnée qui dépendent d'autres conditions. Par exemple, un formulaire pourrait demander à l'interlocuteur s'il possède une voiture : lui demander d'autres renseignements sur sa voiture n'est approprié que s'il a indiqué en posséder une.

La propriété d'élément de modèle relevant fournit à l'interface d'utilisateur XForms des indications concernant la visibilité, le focus et l'ordre de navigation. En général, lorsqu'elle a la valeur "true", les commandes de formulaires associées devraient être rendues visibles. Inversement, pour la valeur "false", les commandes de formulaire associées (et tous les sous-éléments) et les éléments group et switch (et leurs contenus) devraient être rendues indisponibles, retirées de l'ordre de navigation et ne pas pouvoir recevoir le focus.

<instance>
  <my:commande>
    <my:article>
      <my:montant />
      <my:rabais>100</my:rabais>
    </my:article>
  </my:commande>
</instance>
<bind nodeset="my:article/my:rabais" readonly="true()"
      relevant="../my:montant &gt; 1000"/>

Le tableau suivant montre l'interaction d'interface d'utilisateur entre les propriétés required et relevant.

6.1.5 La propriété calculate

Description : fournit une expression servant à calculer la valeur du nœud de donnée d'instance associé.

Expression calculée : oui.

Valeurs légales : toute expression XPath.

Valeur implicite : aucune.

Règles d'héritage : ne s'hérite pas.

Un modèle XForms peut contenir des éléments de modèle qui sont calculés à partir d'autres valeurs. Par exemple, la somme des articles sur une ligne pour la quantité fois le prix unitaire, ou le montant des taxes à payer sur une commande. On peut exprimer une telle valeur calculée comme une expression calculée en se servant des valeurs d'autres éléments de modèle. Le chapitre 4 Le modèle de traitement contient des précisions sur le moment et la manière dont le calcul s'effectue.

<instance>
  <my:commande>
    <my:article>
      <my:montant />
      <my:rabais />
    </my:article>
  </my:commande>
</instance>
<bind nodeset="my:article/my:rabais" calculate="../my:montant * 0.1"
      relevant="../my:montant &gt; 1000"/>

6.1.6 La propriété constraint

Description : définit un prédicat à satisfaire pour que le nœud de donnée d'instance associé soit considéré valide.

Expression calculée : oui.

Valeurs légales : toute expression convertible en un type XPath boolean avec la fonction boolean().

Valeur implicite : true().

Règles d'héritage : ne s'hérite pas.

Lorsque l'évaluation XPath donne "false", l'élément de modèle associé n'est pas valide ; l'inverse n'est pas nécessairement vrai. Le chapitre 4 Le modèle de traitement contient des précisions sur le moment et la manière dont la contrainte se calcule ainsi que le moment où la validation s'effectue.

<instance>
  <my:intervalle>
    <my:depuis />
    <my:jusque />
  </my:intervalle>
</instance>
<bind nodeset="my:jusque" constraint=". &gt; ../my:depuis" />

6.1.7 La propriété p3ptype

Description : joint un élément de donnée P3P à un nœud de donnée d'instance, en indiquant le type de donnée particulier collecté là-bas.

Expression calculée : non.

Valeurs légales : xsd:string.

Valeur implicite : aucune.

Règles d'héritage : ne s'hérite pas.

Cette propriété d'élément de modèle contient une description du type de donnée collecté par le nœud de donnée d'instance associé, fondée sur le système de type de donnée P3P [P3P 1.0]. Ces informations peuvent servir à améliorer la session de remplissage du formulaire en fournissant, par exemple, des données connues au préalable.

<instance>
  <my:nom-personne>
    <my:prenom />
    <my:nom />
  </my:nom-personne>
</instance>
<bind type="my:chaineNonVide" nodeset="my:prenom"
      p3ptype="user.personname.given"
      p3ptype="user.name.given"/>

6.2.1 Le type de donnée atomique

Le modèle de traitement XForms applique les facettes du schéma XML au cours du processus de validation. Au niveau le plus simple, il est nécessaire d'associer un ensemble de facettes (au travers d'un type de donnée du schéma XML) à un élément de modèle. Cela a pour effet de restreindre les valeurs admissibles du nœud de donnée d'instance associé aux représentations valides de l'espace lexical du type de donnée.

L'ensemble des facettes associé à un élément de modèle doit être déterminé par la liste suivante, comme si elle était traitée dans l'ordre donné. Lorsque plusieurs restrictions de type de donnée s'appliquent au même élément de modèle, la combinaison de toutes les restrictions en question doivent s'appliquer. Remarquez que l'on peut produire une combinaison de restrictions qui soit impossible à satisfaire ; on décourage aux auteurs cette pratique.

1. Un schéma XML associé aux données d'instance ;

2. Un attribut du schéma XML xsi:type dans les données d'instance ;

3. Une contrainte XForms type associée au nœud de donnée d'instance au moyen d'une liaison XForms ;

4. Si aucune contrainte de type n'est fournie, le nœud de donnée d'instance a implicitement type="xsd:string" (par défaut vers une règle de chaîne).

L'exemple suivant déclare un type de donnée basé sur le type xsd:string avec une contrainte de facette supplémentaire.

<xsd:simpleType name="chaineNonVide">
  <xsd:restriction base="xsd:string">
    <xsd:minLength value="1"/>
  </xsd:restriction>
</xsd:simpleType>

<my:prenom xsi:type="my:chaineNonVide"/>

<instance>
  <my:prenom />
</instance>
<bind type="my:chaineNonVide" nodeset="/my:prenom"/>