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
-->