accessors

new PARAMHASH

url

Sets the page that the user will end up on after they click the button. Defaults to the current page.

label

The text on the clickable object.

tooltip

Additional information about the link target.

escape_label

If set to true, HTML escapes the content of the label and tooltip before displaying them. This is only relevant for objects that are rendered as HTML links. The default is true.

continuation

The current continuation for the link. Defaults to the current continuation now, if there is one. This may be either a Jifty::Continuation object, or the "id" of such.

call

The continuation to call when the link is clicked. This will happen after actions have run, if any. Like "continuation", this may be a Jifty::Continuation object or the "id" of such.

returns

Passing this parameter implies the creation of a continuation when the link is clicked. It takes an anonymous hash of return location to where the return value is pulled from -- that is, the same structure the "parameters" method takes.

See "query_parameters" in Jifty::Request::Mapper for details.

submit

A list of actions to run when the object is clicked. This may be an array reference or a single element; each element may either be a moniker or, a Jifty::Action or a hashref with the keys 'action' and 'arguments'. An undefined value submits all actions in the form, an empty list reference (the default) submits none.

In the most complex case, you have something like this:

    submit => [
                  {   action    => $my_action,
                      arguments => {
                          name => 'Default McName',
                          age  => '23'
                      },
                  },
                  $my_other_action,
                  'some-other-action-moniker'
              ]
    

If you specify arguments in the submit block for a button, they will override any values from form fields submitted by the user.

preserve_state

A boolean; whether state variables are preserved across the link. Defaults to true if there are any AJAX actions on the link, false otherwise.

parameters

A hash reference of query parameters that go on the link or button. These will end up being submitted exactly like normal query parameters.

as_button

By default, Jifty will attempt to make the clickable into a link rather than a button, if there are no actions to run on submit. Providing a true value for "as_button" forces generate to produce a Jifty::Web::Form::Clickable::InlineButton instead of a Jifty::Web::Form::Link.

as_link

Attempt to rework a button into displaying as a link -- note that this only works in javascript browsers. Supplying both "as_button" and "as_link" will work, and not as perverse as it might sound at first -- it allows you to make any simple GET request into a POST request, while still appearing as a link (a GET request).

target

For things that start off as links, give them an html "target" attribute.

Anything from Jifty::Web::Form::Element

Note that this includes the "onclick" parameter, which allows you to attach javascript to your Clickable object, but be careful that your Javascript looks like "return someFunction();", or you may get an unexpected error from your browser.

url [VALUE]

label [VALUE]

escape_label [VALUE]

continuation [VALUE]

call [VALUE]

returns [VALUE]

submit [VALUE]

preserve_state [VALUE]

parameter KEY VALUE

state_variable KEY VALUE

region_fragment NAME PATH

region_argument NAME ARG VALUE

parameters

post_parameters

get_parameters

complete_url

as_link

as_button

generate

register_action ACTION