NAME
Form::Processor::Field::Select
SYNOPSIS
See Form::Processor
DESCRIPTION
This is a field that includes a list of possible valid options. This can be used for select and mulitple-select fields.
Widget
Fields can be given a widget type that is used as a hint for the code that renders the field.
This field's widget type is: "select".
Subclass
Fields may inherit from other fields. This field inherits from: "Field"
METHODS
options
This is an array of hashes for this field. Each has must have a label and value keys.
multiple
If true allows multiple input values
auto_widget_size
This is a way to provide a hint as to when to automatically select the widget to display for fields with a small number of options. For example, this can be used to decided to display a radio select for select lists smaller than the size specified.
See select_widget below.
select_widget
If the widget is 'select' for the field then will look if the field also has a auto_widget_size. If the options list is less than or equal to the auto_widget_size then will return radio if multiple is false, otherwise will return checkbox.
size
This can be used to store how many items should be offered in the UI at a given time.
Defaults to 0.
label_column
Sets or returns the name of the method to call on the foreign class to fetch the text to use for the select list.
Refers to the method (or column) name to use in a related object class for the label for select lists.
Defaults to "name"
active_column
Sets or returns the name of a boolean column that is used as a flag to indicate that a row is active or not. Rows that are not active are ignored.
The default is "active".
If this column exists on the class then the list of options will included only rows that are marked "active".
The exception is any columns that are marked inactive, but are also part of the input data will be included with brackets around the label. This allows updating records that might have data that is now considered inactive.
sort_order
Sets or returns the column used in the foreign class for sorting the options labels. Default is undefined.
If this column exists in the foreign table then labels returned will be sorted by this column.
If not defined or the column is not found as a method on the foreign class then the label_column is used as the sort condition.
as_label
Returns the option label for the option value that matches the field's current value. Can be helpful for displaying information about the field in a more friendly format.
This does a string compare, although probably al
AUTHORS
Bill Moseley
COPYRIGHT
See Form::Processor for copyright.
This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.
SUPPORT / WARRANTY
Form::Processor is free software and is provided WITHOUT WARRANTY OF ANY KIND. Users are expected to review software for fitness and usability.