cvs: phpdoc-fr /chapters tutorial.xml

From: Date: Thu, 15 Apr 2004 21:09:35 +0000
Subject: cvs: phpdoc-fr /chapters tutorial.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-2156@lists.php.net to get a copy of this message
dams Thu Apr 15 17:09:35 2004 EDT Modified files: /phpdoc-fr/chapters tutorial.xml Log: adding the xform section http://cvs.php.net/diff.php/phpdoc-fr/chapters/tutorial.xml?r1=1.15&r2=1.16&ty=u Index: phpdoc-fr/chapters/tutorial.xml diff -u phpdoc-fr/chapters/tutorial.xml:1.15 phpdoc-fr/chapters/tutorial.xml:1.16 --- phpdoc-fr/chapters/tutorial.xml:1.15 Wed Feb 25 09:10:17 2004 +++ phpdoc-fr/chapters/tutorial.xml Thu Apr 15 17:09:34 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> +<!-- $Revision: 1.16 $ --> <!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> <chapter id="tutorial"> <title>Une introduction à PHP</title> @@ -437,7 +437,103 @@ <function>import_request_variables</function>. </para> </sect1> - + + <sect1 id="tutorial.xforms"> + <title>Traiter les XForms</title> + <para> + <ulink url="&url.xforms;">XForms</ulink> est une variation + des formulaires web traditionnels, qui permet leur utilisation + sur diverses plate-formes et navigateurs, et même sur des + médias moins traditionnels comme les documents PDF. + </para> + <para> + La première différence des XForms est leur présentation au client. + <ulink url="&url.xforms.htmlauthors;">XForms for HTML Authors</ulink> + contient une description détaillée de la création des XForms, + complémtentaire de notre article : nous allons nous + consacrer à un exemple simple. + </para> + <example> + <title>Un simple formulaire XForms de recherche</title> + <programlisting role="html"> +<![CDATA[ +<h:html xmlns:h="http://www.w3.org/1999/xhtml" + xmlns="http://www.w3.org/2002/xforms"> +<h:head> + <h:title>Search</h:title> + <model> + <submission action="http://example.com/search" + method="post" id="s"/> + </model> +</h:head> +<h:body> + <h:p> + <input ref="q"><label>Find</label></input> + <submit submission="s"><label>Go</label></submit> + </h:p> +</h:body> +</h:html> +]]> + </programlisting> + </example> + <para> + Le formulaire ci-dessus affiche une boîte de texte (appelée <parameter>q</parameter>), + et un bouton de soumission. Lorsque ce bouton est utilisé, le formulaire + est envoyé à la page d'action. + </para> + <para> + C'est là que la différence se fait sentir, du point de vue de l'application + web. Dans un formulaire HTML, les données sont envoyées au format + <literal>application/x-www-form-urlencoded</literal>. Pour un XForm, + c'est en fait un format XML qui est utilisé. + </para> + <para> + SI vous avez décidé d'utiliser des XForms, vous attendez peut être des + données au formatXML, et dans ce cas, regardez dans la variable + <variable>$HTTP_RAW_POST_DATA</variable>, où vous trouverez le document + XML généré par le navigateur, que vous pourrez passer à votre moteur + XSLT favori. + </para> + <para> + Si vous n'êtes pas interessé par ce format, et que vous voulez simplement + exploiter vos données avec la variable <variable>$_POST</variable>, vous pouvez + demander au navigateur de les envoyer au format + <literal>application/x-www-form-urlencoded</literal>, en modifiant + l'attribut de méthode <parameter>method</parameter> et en lui + donnant la valeur de <emphasis>urlencoded-post</emphasis>. + </para> + <example> + <title>Utiliser des XForm pour remplir $_POST</title> + <programlisting role="html"> +<![CDATA[ +<h:html xmlns:h="http://www.w3.org/1999/xhtml" + xmlns="http://www.w3.org/2002/xforms"> +<h:head> + <h:title>Search</h:title> + <model> + <submission action="http://example.com/search" + method="urlencoded-post" id="s"/> + </model> +</h:head> +<h:body> + <h:p> + <input ref="q"><label>Find</label></input> + <submit submission="s"><label>Go</label></submit> + </h:p> +</h:body> +</h:html> +]]> + </programlisting> + </example> + <note> + <simpara> + Au moment de la rédaction de cet article, de nombreux navigateurs + ne supportent pas les XForms. Voyez la documentation de votre navigateur + pour savoir s'il est compatible. + </simpara> + </note> + </sect1> + <sect1 id="tutorial.oldcode"> <title>Utiliser des codes anciens avec les nouvelles versions de PHP</title> <para>

« previous php.doc.fr (#2156) next »