Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Perl Perl6
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib/HTML/FormHandlerX/Field
t
.gitignore
Changes
README.md
dist.ini

README.md

NAME

HTML::FormHandlerX::Field::JavaScript - a script tag with javascript code supplied via field for HTML::FormHandler.

VERSION

version 0.004

SYNOPSIS

This class can be used for fields that need to supply JavaScript code to control or modify the form. It will render the value returned by a form's js_code_<field_name> method, or the field's js_code attribute.

has_field 'user_update' => ( type => 'JavaScript',
   js_code => q`$('#fldId').on('change', myFunction);`
);

or using a method:

has_field 'user_update' => ( type => 'JavaScript' );
sub js_code_user_update {
   my ( $self, $field ) = @_;
   if( $field->value == 'foo' ) {
      return q`$('#fldId').on('change', myFunction);`;
   }
   else {
      return q`$('#otherFldId').on('change', myOtherFunction);`;
   }
}
#----
has_field 'usernames' => ( type => 'JavaScript' );
sub js_code_usernames {
    my ( $self, $field ) = @_;
    return q`$('#fldId').on('change', myFunction);`;
}

or set the name of the code generation method:

has_field 'user_update' => ( type => 'JavaScript', set_js_code => 'my_user_update' );
sub my_user_update {
  ....
}

or provide a 'render_method':

has_field 'user_update' => ( type => 'JavaScript', render_method => \&render_user_update );
sub render_user_update {
    my $self = shift;
    ....
    return q(
<script type="text/javascript">
  // code here
</script>);
}

The code generation methods should return a scalar string which will be wrapped in script tags. If you supply your own 'render_method' then you are responsible for calling $self->wrap_data yourself.

FIELD OPTIONS

We support the following additional field options, over what is inherited from HTML::FormHandler::Field

  • js_code

    String containing the JavaScript code to be rendered inside script tags.

  • set_js_code

    Name of method that gets called to generate the JavaScript code.

  • do_minify

    Boolean to indicate whether code should be minified using JavaScript::Minifier::XS

FIELD METHODS

The following methods can be called on the field.

  • wrap_js_code

    The wrap_js_code method minifies the JavaScript code and wraps it in script tags.

AUTHOR

Charlie Garrison garrison@zeta.org.au

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Charlie Garrison.

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

Something went wrong with that request. Please try again.