Kapitel 37. Mit XForms umgehen

XForms definieren eine Variation traditioneller Webformulare, welche den Einsatz auf einer größeren Anzahl von Platformen und Browsern oder sogar in untraditionellen Medien wie PDF Dokumenten erlauben.

Der erste große Unterschied von XForms besteht darin, wie das Formular zum Client gesendet wird. XForms for HTML Authors enthält eine detaillierte Beschreibung davon, wie man XForms erzeugt. Für den Zweck dieser Einführung beschränken wir uns auf ein einfaches Beispiel.

<h:html xmlns:h="http://www.w3.org/1999/xhtml"
        xmlns="http://www.w3.org/2002/xforms">
<h:head>
 <h:title>Suche</h:title>
 <model>
  <submission action="http://example.com/search"
              method="post" id="s"/>
 </model>
</h:head>
<h:body>
 <h:p>
  <input ref="q"><label>Finde</label></input>
  <submit submission="s"><label>Suche</label></submit>
 </h:p>
</h:body>
</h:html>

Das oben angegebene Formular zeigt ein Texteingabefeld (genannt q), sowie einen Absendeknopf. Wenn der Absendeknopf geklickt wird, wird das Formular an die unter action angegebene Seite gesendet.

Hier beginnt es aus der Sicht der Webapplikation anders auszusehen. In einem normalen HTML Formular würden die Daten application/x-www-form-urlencoded gesendet, in der Welt von XForms werden diese Informationen als XML formatierte Daten gesendet.

Wenn Sie sich für die Arbeit mit XForms entscheiden, dann wollen Sie die Daten wahrscheinlich als XML; in diesem Fall schauen Sie in $HTTP_RAW_POST_DATA, wo Sie das vom Browser erzeugte XML Dokument finden werden, das Sie an Ihre bevorzugte XSLT-Engine oder Dokumentenparser weiterreichen können.

Wenn Sie nicht an der Formatierung interessiert sind und Ihre Daten in die traditionelle $_POST Variable geladen haben möchten, können Sie den Browser anweisen, die Daten als application/x-www-form-urlencoded zu senden, indem Sie das method Attribut auf urlencoded-post abändern.

<h:html xmlns:h="http://www.w3.org/1999/xhtml"
        xmlns="http://www.w3.org/2002/xforms">
<h:head>
 <h:title>Suche</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>Finde</label></input>
  <submit submission="s"><label>Suche</label></submit>
 </h:p>
</h:body>
</h:html>