Interchange Input Tag

Download

This tag generates different types of HTML form elements that remember the value previously entered into them (or in same-named elements elsewhere on the site), thanks to Interchange’s “values” functionality. This means users don’t need to enter the same values into the form over and over, and the programmer won’t need to build the same “remember the previous value” code into every HTML element in the form.

Examples & Sample Code

[input
name="field_name"
type="text|select|date|checkbox|password|textarea|radio|display_only"
default="default value"
value="radio/checkbox value"]
[/input]

Standard Text Elements

[input type="text" name="FieldName" /]

Select Elements

[input type="select" name="FieldName"]
OptionValue=OptionText
[/input]

Date Input

The date input provides select boxes for Month/Day/Year input. On submit, the select boxes get assembled into a SQL-compatible date. Any unspecified portions of the date/time will be set to zero. The date is not checked for validity; that is the job of the application.

Various options are available, as detailed below.

[input type="date" name="FieldName" /]

Parameters

name
Required. The name of the field. Doesn’t need to be unique.
type
Optional (defaults to “text”). The type of form element to show.
default
Optional. The value of the field if the corresponding [value] is not set yet.
value
Required if type is “radio” or “checkbox”. The label for the element, as well as the value passed back on submit. If it matches the current value or the default, the element is marked as checked/selected.
format
Optional (defaults to “%m%d%Y” for date elements). For date elements, a format string similar to that accepted by the POSIX strftime function. Conversion specifiers include %[YmdIHMPp], and specify that select boxes for the corresponding part of the date/time should be generated.
reset
Optional. If true, any previously entered value is ignored. The default value will always be used instead.

For all input types other than ‘date’ and ‘display_only’, additional tag attributes (other than “interpolate” and “reparse”) will be passed through to the HTML element generated.