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>

LICENSE

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