Carl Franks > HTML-FormFu-2.01 > HTML::FormFu::Role::Element::Input

Download:
HTML-FormFu-2.01.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  12
Open  4
Stalled  1
View/Report Bugs
Module Version: 2.01   Source  

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.

syntax highlighting: