A form system, jForms, is under development and will be available in Jelix 1.0 beta2. jForms deals with received data from forms server side and client side at the same time (HTML, XUL, or web services) : creation, save, data check, etc. This part is more or less operational in Jelix 1.0 beta1 but remains however experimental. jForms will be also handle the generation of HTML, XUL or other forms in the templates (starting from jelix 1.0 beta2).

While waiting, you will have to use a more “traditional” method

The goal of this chapter, will be to create a form in order to record some new news.

Initially, we will make the template, very simplified, that we store in the newsform file :

<h1>Creation of a news</h1>
 
<form action="{jurl 'news~default_createsave'}" method="POST"/>
<table>
<tr>
    <th><label for="subject">Subject</label></th>
    <td><input type="text" id="subject" name="subject" /></td>
</tr>
<tr>
    <th><label for="text">Text</label></th>
    <td><textarea id="text" name="text"></textarea></td>
</tr>
<tr>
    <th><label for="date">Date</label> (AAAA-MM-JJ)</th>
    <td><input type="text" id="date" name="date" /></td>
</tr>
</table>
<p><input type="submit" value="Save"/></p>
</form>

Very classical, put aside the template tag {jurl}. In Jelix, you will avoid putting urls directly in the templates or the actions, for ease of maintenance and evolution reasons. The URL system of Jelix enables you to centralize all the urls in the jelix config or a urls.xml file (all depends on the URL engine used). The jUrl object and the tag {jurl} enable you to obtain a URL by giving only the name of the action and eventually the parameters.

Here then, we state that the form will be submitted to URL of the default_createsave action.

Note: by default, {jurl} correctly escapes the reserved characters in HTML/XML.