NAME

Form::Sensible::Field::Trigger - A Trigger for user activity

SYNOPSIS

    use Form::Sensible::Field::Trigger;
    
    my $textfield = Form::Sensible::Field::Trigger->new(
                                                    name => 'submit',
                                                  );

DESCRIPTION

Triggers cause something to happen, most often form validation and processing. Trigger fields are most often rendered as buttons in graphical interfaces, such as Submit and Reset buttons in HTML.

NOTE We are still investigating ways to handle Triggers in a flexible and render-independant way. That means aside from simple usage, Trigger fields are likely to change.

HTML-Based Rendering of Triggers

As with all fields, trigger rendering is primarily controlled by render_hints. By default a trigger is rendered as a 'submit' button. If you provide a render_as element in the render_hints, you can control how a trigger is rendered. The options are: reset, button and link. reset renders the trigger as a reset button. button renders the trigger as a button input element. link renders it as a regular HTML link. If render_as = 'link'> is specified you must also provide a link element in the render_hints to set the destination of the link.

ATTRIBUTES

event_to_trigger

The event name to trigger.

METHODS

_default_event_name

Use internally to set the default event name to this class's name appended with '_triggered'.

get_additional_configuration

Returns the attributes' names and values as a hash ref.

AUTHOR

Jay Kuri - <jayk@cpan.org>

SPONSORED BY

Ionzero LLC. http://ionzero.com/

SEE ALSO

Form::Sensible

LICENSE

Copyright 2009 by Jay Kuri <jayk@cpan.org>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.