NAME¶
HTML::FormFu::Role::Element::Input - Role for input fields
DESCRIPTION¶
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.
METHODS¶
datalist_options¶
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.
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).
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 }".
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".
datalist_values¶
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)".
datalist_id¶
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.
auto_datalist_id¶
See "auto_datalist_id" in HTML::FormFu for details.
ATTRIBUTE ACCESSORS¶
Get / set input attributes directly with these methods.
Arguments: [$string]
Return Value: $string
alt¶
autocomplete¶
checked¶
maxlength¶
pattern¶
placeholder¶
size¶
BOOLEAN ATTRIBUTE ACCESSORS¶
Arguments: [$bool]
Return Value: $self Return Value: $string Return Value: undef
Get / set boolean XHTML attributes such as
"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"".
If given a false argument, the attribute key will be deleted.
When used as a setter, the return value is $self to allow chaining.
autofocus¶
multiple¶
required¶
SEE ALSO¶
Is a sub-class of, and inherits methods from HTML::FormFu::Role::Element::Field,
HTML::FormFu::Element
HTML::FormFu
AUTHOR¶
Carl Franks, "cfranks@cpan.org"
LICENSE¶
This library is free software, you can redistribute it and/or modify it under
the same terms as Perl itself.