Why not adopt me?
NAME
HTML::FormFu::Role::Element::Input - Role for input fields
VERSION
version 2.03
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
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.