GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Form::Sensible::Field::Select(3) User Contributed Perl Documentation Form::Sensible::Field::Select(3)

Form::Sensible::Field::Select - A multiple-choice option field

    use Form::Sensible::Field::Select;
    
    my $select_field = Form::Sensible::Field::Select->new(
                                                         name => 'bread_type'
                                                         accepts_multiple => 1
                                                    );

    $select_field->add_option('wheat', 'Wheat Bread');
    $select_field->add_option('white', 'White Bread');
    $select_field->add_option('sour', 'Sourdough Bread');
    
    $select_field->set_selection('sour', 'white');

This Field type allows a user to select one or more options from a provided set of options. This could be rendered as a select box, a radio group or even a series of checkboxes, depending on the renderer and the render hints provided.

"accepts_multiple"
Flag for if this field allows multiple options to be selected. Defaults to false. Note that the value returned by a select field where 'accepts_multiple' is true will always be an arrayref, even if only a single option was selected.
"options"
The options for the Select field as an array ref. See get_options().

"get_options()"
Returns an array ref containing the allowed options. Each option is represented as a hash containing a "name" element and a "value" element for the given option.
"add_selection($selected_option,...)"
Adds the provided option values as selected. If "accepts_multiple" is true, the provided options will be set IN ADDITION to any existing selections.
"set_selection($selected_option,...)"
Sets the provided option values as selected. If "accepts_multiple" is false, only the first item will be set as selected.
"add_option($option_value, $option_display_name)"
If an "options_delegate" IS provided, has no effect whatsoever. Otherwise it adds the provided value and display name to the set of options that can be selected for this field.
"get_additional_configuration"
Returns the additional configuration attributes for this Field class as a hashref.

"<options_delegate-"($self)>>
The "options_delegate" is called to obtain the valid options for this field. It is expected to return an array ref of options. Each option should be a hash entry with a "name" key and a "value" key. If no "options_delegate" is provided, defaults to delegating to itself, using internal storage of options (using the "add_option" mechanism outlined above)
"<values_ok_delegate-"($self, $values_arrayref)>>
The "values_ok_delegate" is called to validate the values selected for the field. It is passed an arrayref containing the selected values and should return an array of error messages if any of the values are invalid, or undef otherwise. If no "values_ok_delegate" is provided, the default delegate simply loops over the options returned by the "options_delegate" and checks each value provided in turn. If retrieving options is an expensive operation (say pulling from a DB table) it is often less expensive to check the specific values provided rather than pulling back all options and then comparing them. This delegate action provides for that possibility.

Jay Kuri - <jayk@cpan.org>

Ionzero LLC. <http://ionzero.com/>

Form::Sensible

Copyright 2009 by Jay Kuri <jayk@cpan.org>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

2012-02-02 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.