cvs: phpdoc-ca /features xforms.xml

eduardcapell Mon Aug 29 13:51:27 2005 EDT Added files: /phpdoc-ca/features xforms.xml Log: http://cvs.php.net/co.php/phpdoc-ca/features/xforms.xml?r=1.1&p=1 Index: phpdoc-ca/features/xforms.xml +++ phpdoc-ca/features/xforms.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: eduardcapell Status: ready --> <chapter id="features.xforms"> <title>Tractament dels XForms</title> <para> <ulink url="&url.xforms;">XForms</ulink> defineix una variació sobre els formularis web tradicionals, i permet d'utilitzar formularis en una varietat de plataformes i navegadors, i fins i tot en mitjans poc tradicionals, com ara en documents PDF. </para> <para> La primera diferència clau en els XForms és la manera en què el formulari s'envia al client. <ulink url="&url.xforms.htmlauthors;">XForms per Autors HTML</ulink> contè una descripció detallada sobre la creació d'XForms, i per aquest document només ens basarem en un exemple molt simple. </para> <example> <title>Un formulari de cerca senzil amb XForm</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>Cerca</h:title> <model> <submission action="http://exemple.com/cerca" method="post" id="s"/> </model> </h:head> <h:body> <h:p> <input ref="q"><label>Trobar</label></input> <submit submission="s"><label>Anar-hi</label></submit> </h:p> </h:body> </h:html> ]]> </programlisting> </example> <para> El formulari superior mostra un quadre d'entrada de text (que es diu <parameter>q</parameter>), i un botó d'enviament. Quan es fa click sobre el botó d'enviament, el formulari s'envia a la pàgina indicada per l'<literal>action</literal>. </para> <para> Ara comencen les diferències des del punt de vista de la vostra aplicació web. En un formulari HTML normal, les dades s'enviarien com a <literal>application/x-www-form-urlencoded</literal>, i, en canvi, en el món dels XForms aquesta informació s'envia com dades formatejades en XML. </para> <para> Si trieu de treballar amb XForms probablement voleu dades en format XML. En aquest cas, busqueu en <varname>$HTTP_RAW_POST_DATA</varname>, i hi trobareu el document XML generat pel navegador, que podeu passar-li al vostre motor XSLT favorit o a l'analitzador de documents que preferiu. </para> <para> Si no us interessa el format i voleu que les dades es carreguin en la variable tradicional <varname>$_POST</varname>, podeu indicar-li al navegador que enviï les dades com a <literal>application/x-www-form-urlencoded</literal>, canviant l'atribut <parameter>method</parameter> a <emphasis>urlencoded-post</emphasis>. </para> <example> <title>Ús d'un XForm per a omplir <varname>$_POST</varname></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>Cerca</h:title> <model> <submission action="http://exemple.com/cerca" method="urlencoded-post" id="s"/> </model> </h:head> <h:body> <h:p> <input ref="q"><label>Trobar</label></input> <submit submission="s"><label>Anar-hi</label></submit> </h:p> </h:body> </h:html> ]]> </programlisting> </example> <note> <simpara> En el moment de la redacció d'aquest document, molts navegadors no suporten XForms. Comproveu la versió del navegador si els exemples anteriors no us funcionen. </simpara> </note> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->