Reaction::UI::Widget::Field::Mutable(3)

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.

SEE ALSO

•   Reaction::UI::Widget::Field

AUTHORS
See Reaction::Class for authors.

LICENSE
See Reaction::Class for the license.