<forms:address />

A form control for capturing location / address information.

This control will offer address suggestions powered by Google, and show / hide fields appropriately for the selected country.

This control includes a number of separate fields for collecting the parts of an address. Each field maps to an Oncord datacolumn, but can be overridden if needed (via the corresponding attribute) to a different datacolumn.

Attributes

datacolumnAddress

string

Datacolumn Address

The datacolumn to which the address field will be mapped.

Default = 'contact_address'

datacolumnCountry

string

Datacolumn Country

The datacolumn to which the country field will be mapped.

Default = 'country_id'

datacolumnPostCode

string

Datacolumn Post Code

The datacolumn to which the post code field will be mapped.

Default = 'contact_postcode'

datacolumnState

string

Datacolumn Zone

The datacolumn to which the zone field will be mapped.

Default = 'contact_state'

datacolumnSuburbCity

string

Datacolumn City

The datacolumn to which the city field will be mapped.

Default = 'contact_suburb_city'

string

(Required) Give this control a unique id. Can be accessed in the client DOM (eg, document.getElementById('myid') or in the server DOM using [? $myid ?] or [? $('myid') ?]).

rowtype

string

Row Type

Set a type for rendered Form Rows.

Default = 'two_column'

useplaceholders

bool

Use Placeholders

Whether to render placeholder text for field inputs or not.

Default = 'false'

userowlabels

bool

Use Row Labels

Whether to render labels for field rows or not.

Note that if useplaceholders is false, labels will always be rendered for usability.

Default = 'true'

Examples

Basic Address Collection

The forms:address tag can be added to a form to collect address data. Note that the tag is not wrapped in an forms:row. This is because the address tag outputs each part of the address in its own row.

HTML:

<forms:form id="store_contact_address_example" onsuccesstoastmessage="Your details have been stored successfully." contactmode="store" > <forms:row label="First Name" type="one_column"> <forms:editbox id="contact_first_name" validations="mandatory" /> </forms:row> <forms:row label="Last Name" type="one_column"> <forms:editbox id="contact_last_name" validations="mandatory" /> </forms:row> <forms:row label="Email Address" type="one_column"> <forms:editbox id="contact_email" validations="mandatory,email" transformations="tolower" /> </forms:row> <forms:address id="contact_address" /> <forms:row type="one_column"> <forms:submitbutton>Send</forms:submitbutton> </forms:row> </forms:form>