NAME

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

DESCRIPTION

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

FRAGMENTS

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.