cvs: phpdoc-fr /chapters tutorial.xml
| From: | Damien Seguy | 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>