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
Standard Text Elements
[input type="text" name="FieldName" /]
[input type="select" name="FieldName"]
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" /]
- Required. The name of the field. Doesn’t need to be unique.
- Optional (defaults to “text”). The type of form element to show.
- Optional. The value of the field if the corresponding [value] is not set yet.
- 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.
- 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.
- 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.