The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Reaction::UI::ViewPort::Object - Display an InterfaceModel::Object

SYNOPSIS

  use aliased 'Reaction::UI::ViewPort::Object';

  ...
  $controller->push_viewport(Object,
    model           => $person_interface_model_object,
    fields_order    => [qw( firstname lastname )],
    excluded_fields => [qw( password )],
  );

DESCRIPTION

Takes a Reaction::InterfaceModel::Object class and displays the configured fields.

ATTRIBUTES

model

Required Reaction::InterfaceModel::Object.

fields

Initialised via "_build_fields"

field_args

Hash reference keyed by field names. Values are hash references containing arguments to the field builder method of the attribute.

field_order

Array reference of strings defining the order of all fields (including the ones that might be excluded).

builder_cache

Hash reference containing resolved builder method names per field. Utilised by "_build_fields"

excluded_fields

Array reference of strings naming fields to exclude from the interface.

included_fields

List of field names to include. If both included_fields and excluded_fields are specified the result is those fields which are in included_fields and not in excluded_fields.

computed_field_order

Array reference of strings Initialised by the "_computed_field_order" method. Contains the fields to show in the correct order.

containers

Array reference populated by "_build_containers".

container_layouts

Array reference containing container layout specifications.

INTERNAL METHODS

These methods, although stable, are subject to change without notice. These are meant to be used only by developers. End users should refrain from using these methods to avoid potential breakages.

BUILD

Takes the value of the Field constructor argument, if true, and sets it as the new "field_args" hash reference.

get_builder_for

Takes an attribute object as argument and returns a string containing the name of the method that builds the fields for this attribute.

If the viewport implements it, _build_fields_for_name_${attr_name} will be used.

If that is not available, it will take the isa information of the type constraint and see if it is a loaded class implementing meta. If it is, every class in its class_precedence_list will be taken and used to try to find a _build_fields_for_type_${mangled_class_name} method on the viewport.

"mangled" means here that every :* will be replaced with _. For example: Foo::Bar would become Foo_Bar.

If the isa information was not obtainable or no fitting method was found, it will try the type name in a method named _build_fields_for_type_${mangled_type_name}.

If could be found on this constraint, it will make the same attempts to find a method on its parent type constraint.

This method will die if it can't locate a method to build a field for this attribute.

_build_containers

Uses "container_layouts" to build a list of Reaction::UI::ViewPort::Field::Container objects.

_build_fields

Takes the "model"s parameter_attributes to build fields via "get_builder_for". They will be ordered as specified in "computed_field_order".

_build_computed_field_order

Takes the names of the "model"s parameter_attributes' reader methods and assumes them as field names. Then it uses "field_order" and "excluded_fields" to calculate the order of all included fields and returns those names.

_build_simple_field

  $self->_build_simple_field(
    attribute => $attribute_object,
    class     => $field_class,
    %field_attrs,
  );

Takes an attribute meta object, a field class (a Reaction::UI::ViewPort::Field subclass) and an additional set of arguments to pass to the field constructor and returns the new field. Field classes themselves are Reaction::UI::ViewPort subclasses.

_build_fields_for_type_Num

_build_fields_for_type_Int

_build_fields_for_type_Bool

_build_fields_for_type_Password

_build_fields_for_type_Str

_build_fields_for_type_SimpleStr

_build_fields_for_type_DateTime

_build_fields_for_type_Enum

_build_fields_for_type_ArrayRef

_build_fields_for_type_Reaction_InterfaceModel_Object

_build_fields_for_type_Reaction_InterfaceModel_Collection

FIELD TYPES

Text, Number, Integer, Boolean, String, DateTime, RelatedObject, Array, Collection, File, Container

AUTHORS

See Reaction::Class for authors.

LICENSE

See Reaction::Class for the license.