Lisez-moi !

XForms 1.0

Recommandation du W3C du 14 octobre 2003

Cette version :: http://www.w3.org/TR/2003/REC-xforms-20031014/
Dernière version :: http://www.w3.org/TR/xforms/
Version précédente :: http://www.w3.org/TR/2003/PR-xforms-20030801/
Rédacteurs :: Micah Dubinko, Cardiff Software <mdubinko@Cardiff.com>; Leigh L. Klotz, Jr., Xerox Corporation <Leigh.Klotz@pahv.xerox.com>; Roland Merrick, IBM <Roland_Merrick@uk.ibm.com>; T. V. Raman, IBM <tvraman@almaden.ibm.com>

Veuillez consulter l'errata de ce document, lequel peut contenir des corrections normatives.

Ce document est également disponible dans ces formats non normatifs : un seul fichier HTML, diff-marked HTML, archive zip.

La version en anglais de cette spécification est la seule normative. D'éventuelles traductions non normatives sont éventuellement disponibles.

Copyright © 2003 W3C^® (MIT, ERCIM, Keio), tous droits réservés. Les règles de responsabilité, de marque commerciale, d'utilisation des documents et d'octroi de licences logicielles du W3C s'appliquent.

Résumé

Le langage XForms est une application XML qui représente la prochaine génération de formulaires pour le Web. En découpant les formulaires traditionnels XHTML en trois parties — le modèle XForms, les données d'instance et l'interface d'utilisateur — XForms sépare la présentation du contenu, permet la réutilisation, apporte un typage fort, tout en réduisant les allers-retours au serveur comme en offrant une indépendance par rapport au matériel et en limitant les recours à des scripts.

Le langage XForms n'est pas un type de document isolé, mais s'intègre à d'autres langages de balisage comme XHTML ou SVG.

Statut de ce document

Ce chapitre décrit le statut de ce document au moment de sa publication. D'autres documents peuvent venir le remplacer. On peut trouver une liste des publications courantes du W3C et la dernière révision de ce rapport technique dans l'index des rapports techniques du W3C à http://www.w3.org/TR/.

Ce document est une recommandation du W3C. Il a été produit par le groupe de travail XForms du W3C, issu de l'activité XForms du domaine Interaction du W3C. Les auteurs du document sont les participants du groupe de travail XForms.

Ce document, qui a été passé en revue par les membres du W3C et les tiers intéressés, a été approuvé par le Directeur comme recommandation du W3C. C'est un document stable qui peut servir de matériel de référence ou être cité comme référence normative par un autre document. Le rôle du W3C en produisant la recommandation consiste à attirer l'attention sur la spécification et d'en promouvoir le large déploiement. Cela participe à la fonctionnalité et l'interopérabilité du Web.

Le profil Basic de XForms, apparu dans la recommandation candidat XForms 1.0, est désormais une spécification autonome. Veuillez consulter le profil Basic XForms [XForms Basic] pour ce qui touche au traitement XForms adapté aux besoins des appareils et environnements contraints.

Les remarques concernant ce document sont les bienvenues. Veuillez les adresser à la liste de diffusion publique www-forms-editor@w3.org. (archives). Les discussions par courrier électronique n'ont pas vocation à se tenir sur cette adresse.

Le groupe de travail XForms du W3C a rendu public une batterie de tests pour XForms 1.0 accompagnant un rapport de mise en œuvre. Une liste des implémentations XForms connues actuelles est disponible.

On peut trouver les divulgations de licences concernant cette spécification sur la page publique des divulgations de licences du groupe de travail XForms, conformément à la politique du W3C.

Table des matières

1 À propos de la spécification XForms 1.0
- 1.1 Historique
- 1.2 La lecture de la spécification
- 1.3 Le plan de la spécification
- 1.4 Les conventions de la documentation
2 Introduction au langage XForms
- 2.1 Un exemple
- 2.2 La fourniture des données d'instance XML
- 2.3 La contrainte des valeurs
- 2.4 Des documents avec plusieurs formulaires
3 La structure du document
- 3.1 L'espace de nommage XForms
- 3.2 Les collections d'attributs de base de XForms
  - 3.2.1 Les attributs communs
  - 3.2.2 Les attributs de liaison
  - 3.2.3 Les attributs de liaison de nœud simple
  - 3.2.4 Les attributs de liaison d'ensemble de nœuds
  - 3.2.5 Les attributs des propriétés d'élément de modèle
- 3.3 Le module Noyau de XForms
  - 3.3.1 L'élément model
  - 3.3.2 L'élément instance
  - 3.3.3 L'élément submission
  - 3.3.4 L'élément bind
- 3.4 Le module MustUnderstand de XForms
- 3.5 Le module Extension de XForms
  - 3.5.1 L'élément extension
4 Le modèle de traitement
- 4.1 Vue d'ensemble des événements
- 4.2 Les événements d'initialisation
  - 4.2.1 L'événement xforms-model-construct
  - 4.2.2 L'événement xforms-model-construct-done
  - 4.2.3 L'événement xforms-ready
  - 4.2.4 L'événement xforms-model-destruct
- 4.3 Les événements d'interaction
  - 4.3.1 Les événements xforms-next et xforms-previous
  - 4.3.2 L'événement xforms-focus
  - 4.3.3 Les événements xforms-help et xforms-hint
  - 4.3.4 L'événement xforms-refresh
  - 4.3.5 L'événement xforms-revalidate
  - 4.3.6 L'événement xforms-recalculate
  - 4.3.7 L'événement xforms-rebuild
  - 4.3.8 L'événement xforms-reset
  - 4.3.9 L'événement xforms-submit
- 4.4 Les événements de notification
  - 4.4.1 L'événement DOMActivate
  - 4.4.2 L'événement xforms-value-changed
  - 4.4.3 Les événements xforms-select et xforms-deselect
  - 4.4.4 Les événements xforms-scroll-first et xforms-scroll-last
  - 4.4.5 Les événements xforms-insert et xforms-delete
  - 4.4.6 L'événement xforms-valid
  - 4.4.7 L'événement xforms-invalid
  - 4.4.8 L'événement DOMFocusIn
  - 4.4.9 L'événement DOMFocusOut
  - 4.4.10 L'événement xforms-readonly
  - 4.4.11 L'événement xforms-readwrite
  - 4.4.12 L'événement xforms-required
  - 4.4.13 L'événement xforms-optional
  - 4.4.14 L'événement xforms-enabled
  - 4.4.15 L'événement xforms-disabled
  - 4.4.16 L'événement xforms-in-range
  - 4.4.17 L'événement xforms-out-of-range
  - 4.4.18 L'événement xforms-submit-done
  - 4.4.19 L'événement xforms-submit-error
- 4.5 Les indications d'erreur
  - 4.5.1 L'événement xforms-binding-exception
  - 4.5.2 L'événement xforms-link-exception
  - 4.5.3 L'événement xforms-link-error
  - 4.5.4 L'événement xforms-compute-exception
- 4.6 Le séquencement des événements
  - 4.6.1 Pour les commandes input, secret, textarea, range ou upload
  - 4.6.2 Pour les commandes output
  - 4.6.3 Pour les commandes select ou select1
  - 4.6.4 Pour les commandes trigger
  - 4.6.5 Pour les commandes submit
  - 4.6.6 Séquence : la sélection sans changement de valeur
  - 4.6.7 Séquence : le changement de valeur avec changement de focus
  - 4.6.8 Séquence : l'activation d'une commande trigger
  - 4.6.9 Séquence : la soumission
5 Les types de données
- 5.1 Les types de données intégrés du schéma XML
- 5.2 Les types de données XForms
  - 5.2.1 xforms:listItem
  - 5.2.2 xforms:listItems
  - 5.2.3 xforms:dayTimeDuration
  - 5.2.4 xforms:yearMonthDuration
6 Les propriétés des éléments de modèle
- 6.1 Les définitions des propriétés d'élément de modèle
  - 6.1.1 La propriété type
  - 6.1.2 La propriété readonly
  - 6.1.3 La propriété required
  - 6.1.4 La propriété relevant
  - 6.1.5 La propriété calculate
  - 6.1.6 La propriété constraint
  - 6.1.7 La propriété p3ptype
- 6.2 Les contraintes du schéma
  - 6.2.1 Le type de donnée atomique
7 Les expressions XPath dans XForms
- 7.1 Les types de données XPath
- 7.2 La chaîne de fonctionnalité de l'appel de méthode hasFeature
- 7.3 Les données d'instance
  - 7.3.1 La méthode getInstanceDocument()
  - 7.3.2 La méthode rebuild()
  - 7.3.3 La méthode recalculate()
  - 7.3.4 La méthode revalidate()
  - 7.3.5 La méthode refresh()
- 7.4 Le contexte d'évaluation
- 7.5 Les expressions de liaison
  - 7.5.1 Les dépendances dynamiques
  - 7.5.2 Les expressions de liaison du modèle
  - 7.5.3 Les expressions de liaison de l'interface d'utilisateur
  - 7.5.4 Les liaisons de l'interface d'utilisateur dans d'autres vocabulaires XML
  - 7.5.5 Exemples de liaisons
- 7.6 La bibliothèque de fonctions fondamentales de XForms
- 7.7 Les fonctions booléennes
  - 7.7.1 La fonction boolean-from-string()
  - 7.7.2 La fonction if()
- 7.8 Les fonctions numériques
  - 7.8.1 La fonction avg()
  - 7.8.2 La fonction min()
  - 7.8.3 La fonction max()
  - 7.8.4 La fonction count-non-empty()
  - 7.8.5 La fonction index()
- 7.9 Les fonctions de chaîne
  - 7.9.1 La fonction property()
- 7.10 Les fonctions de date et d'heure
  - 7.10.1 La fonction now()
  - 7.10.2 La fonction days-from-date()
  - 7.10.3 La fonction seconds-from-dateTime()
  - 7.10.4 La fonction seconds()
  - 7.10.5 La fonction months()
- 7.11 Les fonctions d'ensemble de nœuds
  - 7.11.1 La fonction instance()
- 7.12 Les fonctions d'extension
8 Les commandes de formulaire
- 8.1 Le module Commandes de formulaire de XForms
  - 8.1.1 Les obligations d'implémentation communes à toutes les commandes de formulaire
  - 8.1.2 L'élément input
  - 8.1.3 L'élément secret
  - 8.1.4 L'élément textarea
  - 8.1.5 L'élément output
  - 8.1.6 L'élément upload
  - 8.1.7 L'élément range
  - 8.1.8 L'élément trigger
  - 8.1.9 L'élément submit
  - 8.1.10 L'élément select
  - 8.1.11 L'élément select1
- 8.2 Le balisage courant des commandes de sélection
  - 8.2.1 L'élément choices
  - 8.2.2 L'élément item
  - 8.2.3 L'élément value
- 8.3 Les autres éléments
  - 8.3.1 L'élément filename
  - 8.3.2 L'élément mediatype
  - 8.3.3 L'élément label
  - 8.3.4 L'élément help
  - 8.3.5 L'élément hint
  - 8.3.6 L'élément alert
9 L'interface d'utilisateur XForms
- 9.1 Le module Groupe de XForms
  - 9.1.1 L'élément group
- 9.2 Le module Commutation de XForms
  - 9.2.1 L'élément switch
  - 9.2.2 L'élément case
  - 9.2.3 L'élément toggle
- 9.3 Le module Répétition de XForms
  - 9.3.1 L'élément repeat
  - 9.3.2 La création des structures de répétition via des attributs
  - 9.3.3 L'élément itemset
  - 9.3.4 L'élément copy
  - 9.3.5 L'élément insert
  - 9.3.6 L'élément delete
  - 9.3.7 L'élément setindex
  - 9.3.8 Le traitement des répétitions
  - 9.3.9 Les répétitions imbriquées
  - 9.3.10 L'interaction avec l'interface d'utilisateur
10 Les actions XForms
- 10.1 Le module Action de XForms
  - 10.1.1 L'élément action
  - 10.1.2 L'élément dispatch
  - 10.1.3 L'élément rebuild
  - 10.1.4 L'élément recalculate
  - 10.1.5 L'élément revalidate
  - 10.1.6 L'élément refresh
  - 10.1.7 L'élément setfocus
  - 10.1.8 L'élément load
  - 10.1.9 L'élément setvalue
  - 10.1.10 L'élément send
  - 10.1.11 L'élément reset
  - 10.1.12 L'élément message
  - 10.1.13 Les actions et les éléments insert, delete et setindex
11 La soumission
12 La conformité
- 12.1 Les niveaux de conformité
  - 12.1.1 La conformité XForms Full
- 12.2 La description de la conformité
  - 12.2.1 Les processeurs XForms conformes
  - 12.2.2 Les documents XForms conformes
  - 12.2.3 Les générateurs XForms conformes
13 Le glossaire des termes

Annexes

A Le schéma de XForms
- A.1 Le schéma des événements XML
B Références
- B.1 Les références normatives
- B.2 Les références informatives
C Les considérations concernant la confidentialité
- C.1 L'utilisation de P3P avec XForms
D L'algorithme de séquence de recalcul
E Les modes d'entrée
- E.1 La syntaxe de la valeur de l'attribut inputmode
- E.2 Le comportement de l'agent utilisateur
- E.3 La liste des atomes
  - E.3.1 Les atomes d'écriture
  - E.3.2 Les atomes modificateurs
- E.4 Les relations avec les facettes de modèle du schéma XML
- E.5 Exemples
F XForms et le style (non normatif)
- F.1 Les pseudo-classes
- F.2 Les pseudo-éléments
- F.3 Exemples
G Exemples XForms complets (non normatif)
H Le journal des changements (non normatif)
I Remerciements (non normatif)
J Notes de production (non normatif)