<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->

<meta>
<topic id="textsharedguidexformsxml" indexer="include" status="PUBLISH">
<title xml-lang="en-US" id="tit">XML Form Documents (XForms)</title>
<filename>/text/shared/guide/xforms.xhp</filename>
</topic>
</meta>
<body>
  
  
  <section id="xforms">
   
   
<bookmark xml-lang="en-US" branch="index" id="bm_id5215613"><bookmark_value>web documents;XForms</bookmark_value>
<bookmark_value>forms;XForms</bookmark_value>
<bookmark_value>XML Forms, see XForms</bookmark_value>
<bookmark_value>XForms;opening/editing</bookmark_value>
<bookmark_value>editing;XForms</bookmark_value>
<bookmark_value>opening;XForms</bookmark_value>
</bookmark>
   <comment>MW made a cross-reference of "XML Forms" and made a two level entry of "XForms"</comment>
   <h1 id="par_idN106E5"><link href="text/shared/guide/xforms.xhp">XML Form Documents (XForms)</link></h1>
   <paragraph xml-lang="en-US" id="par_idN106F5" role="paragraph">XForms are a new type of web form that was developed by the World Wide Web Consortium. The XForm model is defined in Extensible Markup Language (XML). The model uses separate sections to describe what a form does and what a form looks like. You can view the specification for XForms at: <link href="https://www.w3.org/MarkUp/Forms/"><emph>https://www.w3.org/MarkUp/Forms/</emph></link>.</paragraph>
   
  </section>
  <h2 id="par_idN10746">Working with XForms</h2>
  <paragraph xml-lang="en-US" id="par_idN1074A" role="paragraph">In %PRODUCTNAME, an XForms document is a special type of Writer document. The <emph>Design Mode</emph> for an XForm document has additional toolbars and panes. </paragraph>
  <paragraph xml-lang="en-US" id="par_idN1074D" role="paragraph">After you create and save an XForms document, you can open the document, fill out the form, and submit the changes to a server.</paragraph>
  <paragraph xml-lang="en-US" id="par_idN10774" role="paragraph" localize="false"><comment>What's the role of UBL?</comment><comment>We do not officially support exporting to XHTML - but should be possible using XSLT</comment></paragraph>
  <h2 id="par_idN10706">To Create a New XForms Document</h2>
  <list type="ordered">
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN1070D" role="paragraph">Choose <emph>File - New - XML Form Document</emph>.</paragraph>
    <paragraph xml-lang="en-US" id="par_idN10714" role="paragraph">The XForms design window opens in an empty Writer document.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN10718" role="paragraph">Design your form.</paragraph>
   </listitem>
  </list>
  <list type="unordered">
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN1071E" role="paragraph">Insert a control, select the default model in the property browser, and enter a binding statement.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN10722" role="paragraph">In the <emph>Data Navigator</emph>, add an element to the instance.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN10726" role="paragraph">Load a new instance from an XML file and add controls to the relevant XML elements or attributes.</paragraph>
   </listitem>
  </list>
  <h2 id="par_idN10729">To Open an XForms Document</h2>
  <list type="unordered">
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN10730" role="paragraph">Choose <emph>File - Open</emph> and select the XForms document. An XForm document has the same extension as a Writer text document (*.odt).</paragraph>
   </listitem>
  </list>
  <h2 id="par_idN10737">To Edit an XForms Document</h2>
  <paragraph xml-lang="en-US" id="par_idN1073B" role="paragraph">Open the XForms document and use the following toolbars and windows:</paragraph>
  <list type="unordered">
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN10741" role="paragraph"><link href="text/shared/main0226.xhp">Form Design toolbar</link></paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN10757" role="paragraph"><link href="text/shared/02/01170000.xhp">Form Controls toolbar</link></paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN1075F" role="paragraph"><link href="text/shared/01/xformsdata.xhp">Data Navigator</link></paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN1075B" role="paragraph"><link href="text/shared/02/01170600.xhp">Form Navigator</link></paragraph>
   </listitem>
  </list>
  <paragraph xml-lang="en-US" id="par_idN10848" role="paragraph" localize="false"><comment>UFI: currently only StarOffice can render and evaluate our XForms docs. Mozilla has announced a planned support recently. There may be plugins for other browsers. Should we tell the user?</comment></paragraph>
 </body>
</helpdocument>
