NAME

Jifty::Param - Parameters for Jifty actions

DESCRIPTION

Describes a parameter to a Jifty::Action object. Do not construct this by hand -- use Jifty::Param::Schema in the action package to declare parameters instead.

accessors

Although this class is not derived from Jifty::Web::Form::Field, it does share the accessors from it; see Jifty::Web::Form::Field, for the list of possible keys that each parameter can have.

In addition to the list there, you may use these additional keys:

constructor

A boolean which, if set, indicates that the argument must be present in the arguments passed to create the action, rather than being expected to be set later.

Defaults to false.

valid_values

An array reference. Each element should be either:

  • A hash reference with a display field for the string to display for the value, and a value field for the value to actually send to the server.

  • A hash reference with a collection field containing a Jifty::Collection, and display_from and value_from fields containing the names of methods to call on each record in the collection to get display and value.

  • A simple string, which is treated as both display and value.

available_values

Just like valid_values, but represents the list of suggested values, instead of the list of acceptable values.

sort_order

An integer of how the parameter sorts relative to other parameters. This is usually implicitly generated by its declaration order.

new

Creates a new Jifty::Param object. Note that unlike Jifty::Web::Form::Field, the object is never magically reblessed into a subclass. Should only be called implicitly from a Jifty::Param::Schema declaration.