HTML::FormFu::Role::Element::Input - Role for input fields
version 2.07
Base-class for HTML::FormFu::Element::Button, HTML::FormFu::Element::Checkbox, HTML::FormFu::Element::File, HTML::FormFu::Element::Hidden, HTML::FormFu::Element::Password, HTML::FormFu::Element::Radio, HTML::FormFu::Element::Text.
Arguments: none
Arguments: \@options
Use either "datalist_options" or "datalist_values" to generate a HTML5-compatible datalist group of option tags. This will be associated with the input element via a list attribute on the input tag.
datalist
option
input
list
The datalist ID attribute must be set using either "datalist_id" or "auto_datalist_id".
--- elements: - type: Text name: foo options: - [ 01, January ] - [ 02, February ] - [ 03, March ] - [ 04, April ]
The syntax is similar to "options" in HTML::FormFu::Role::Element::Group, except hash-ref items only accept value and label keys (and their variants).
value
label
If passed no arguments, it returns an arrayref of the currently set datalist options.
Its arguments must be an array-ref of items. Each item may be an array ref of the form [ $value, $label ] or a hash-ref of the form { value => $value, label => $label }.
[ $value, $label ]
{ value => $value, label => $label }
When using the hash-ref construct, the label_xml and label_loc variants of label are supported, as are the value_xml and value_loc variants of value.
label_xml
label_loc
value_xml
value_loc
Arguments: \@values
--- elements: - type: Radiogroup name: foo values: - jan - feb - mar - apr
A more concise alternative to "datalist_options".
Its arguments must be an array-ref of values. The labels used are the result of ucfirst($value).
ucfirst($value)
Arguments: [$string]
Sets the datalist ID attribute, and automatically sets this input element's list ID to the same.
Either "datalist_id" or "auto_datalist_id" is required, if either "datalist_options" or "datalist_values" are set.
See "auto_datalist_id" in HTML::FormFu for details.
Get / set input attributes directly with these methods.
Return Value: $string
Arguments: [$bool]
Return Value: $self Return Value: $string Return Value: undef
Get / set boolean XHTML attributes such as required="required".
required="required"
If given any true argument, the attribute value will be set equal to the attribute key name. E.g. $element->required(1) will set the attribute required="required".
$element->required(1)
If given a false argument, the attribute key will be deleted.
When used as a setter, the return value is $self to allow chaining.
$self
Is a sub-class of, and inherits methods from HTML::FormFu::Role::Element::Field, HTML::FormFu::Element
HTML::FormFu
Carl Franks, cfranks@cpan.org
cfranks@cpan.org
This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.
Carl Franks <cpan@fireartist.com>
This software is copyright (c) 2018 by Carl Franks.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install HTML::FormFu, copy and paste the appropriate command in to your terminal.
cpanm
cpanm HTML::FormFu
CPAN shell
perl -MCPAN -e shell install HTML::FormFu
For more information on module installation, please visit the detailed CPAN module installation guide.