NAME

Reaction::UI::Widget::Field::Mutable - Mutable fields

DESCRIPTION

An extension of Reaction::UI::Widget::Field representing fields whose values can be mutated.

FRAGMENTS

widget

The following additional arguments are provided:

field_id: Contains the viewport's event id for value_string.
field_name: Defaults to the field_id argument unless already defined
field_type: Defaults to text.
field_class: A string containing the joined class attribute. Defaults to action-field and the current viewport's name.
exists_event: Contains the event id for exists.
exists_value: Defaults to 1.

message_fragment

Renders nothing if the viewport doesn't have a message.

Otherwise, the message argument will be set to the localised string contained in the viewport's message attribute and the message fragment will be rendered.

field_is_required

Will render either field_is_required_yes or field_is_required_no depending on if value_is_required on the viewport returns true and the viewports value_string is empty.

LAYOUT SETS

base

  share/skin/base/layout/field/mutable.tt

The following layouts are provided:

widget: Builds a span element with a class attribute set to the field_class argument. The element contents will be the label_fragment, field and message_fragment fragments.
label: Builds a label element with the for attribute set to the value of field_id and the other attributes used from the field_is_required argument. The content will be the label argument.
field_is_required_yes: Sets the class attribute to required_field.
field_is_required_no: Empty.
message: Renders a span element with the message as content.
field: Renders the input field. The field_body fragment is used to set the value.
field_body: Creates the value attribute for the input element.

default

  share/skin/default/layout/field/mutable.tt

The following layouts are provided:

message: Will render the original message fragment followed by a br element.

SUBCLASSES

Reaction::UI::Widget::Field::Mutable::Boolean: A widget allowing the manipulation of boolean values.
Reaction::UI::Widget::Field::Mutable::ChooseMany: Allows the user to choose many items from a list of available values.
Reaction::UI::Widget::Field::Mutable::ChooseOne: Allows the user to choose a single item from a list of available values.
Reaction::UI::Widget::Field::Mutable::DateTime: A simple DateTime Reaction::UI::Widget::Field::Mutable subclass.
Reaction::UI::Widget::Field::Mutable::File: A simple file input field.
Reaction::UI::Widget::Field::Mutable::HiddenArray: Renders an array reference value as a series of hidden fields.
Reaction::UI::Widget::Field::Mutable::Integer: A simple integer Reaction::UI::Widget::Field::Mutable.
Reaction::UI::Widget::Field::Mutable::MatchingPasswords: Password input requiring that the password be entered twice, e.g. to input a new password.
Reaction::UI::Widget::Field::Mutable::Password: A password input Reaction::UI::Widget::Field::Mutable.
Reaction::UI::Widget::Field::Mutable::Number: A simple number Reaction::UI::Widget::Field::Mutable input field.
Reaction::UI::Widget::Field::Mutable::String: A simple string Reaction::UI::Widget::Field::Mutable input field.
Reaction::UI::Widget::Field::Mutable::Text: A multiline input Reaction::UI::Widget::Field::Mutable.

AUTHORS

See Reaction::Class for authors.

LICENSE

See Reaction::Class for the license.

CPAN RT