<?xml version="1.0"?>
<record><wiki id="wiki?page_id=51">
	<page_name>fieldgroup_template</page_name>
	<page_id>51</page_id>
	<page_title>fieldgroup_template</page_title>
	<content>==Using a custom template for a field group on the edit form==

[[toc]]

Xataface allows you to partition your fields into &apos;&apos;groups&apos;&apos; so that similar fields are grouped together on the edit form.  The default layout of the fields remains simply vertical, but you can customize this layout (on a per-group basis) by creating a custom template and then assigning this template to the field group with the &apos;&apos;template&apos;&apos; directive.


===Example===

For example, in your [[fields.ini file]] if you wanted to group your address fields together you might have:
&lt;code&gt;
[fieldgroup:address]
    label=&quot;Address Information&quot;
    template=&quot;AddressInformationGroup.html&quot;

[address_1]
    group=address

[city]
    group=address

[state]
    group=address
&lt;/code&gt;

Then you would add the a template named &apos;&apos;AddressInformationGroup.html&apos;&apos; to your application&apos;s &apos;&apos;templates&apos;&apos; directory to display how the fields are laid out:
&lt;code&gt;
&lt;table width=&quot;100%&quot;&gt;
    &lt;tr&gt;&lt;th&gt;Address 1:&lt;/th&gt;
    &lt;td&gt;{$elements.address_1.html}&lt;/td&gt;

    &lt;th&gt;City:&lt;/th&gt;
    &lt;td&gt;{$elements.city.html}&lt;/td&gt;

    &lt;th&gt;State:&lt;/th&gt;
    &lt;td&gt;{$elements.state.html}&lt;/td&gt;
    &lt;/tr&gt;
&lt;/table&gt;
&lt;/code&gt;
This would display all of the fields in this group in a single row (horizontally) instead of vertically.

Note that this is an over-simplified example that doesn&apos;t take account for display error messages, required notices, grouped fields, and other information that you can obtain from the {$elements} array.</content>
	<keywords></keywords>
	<language>en</language>
	<original_page>0</original_page>
</wiki></record>