NAME

HTML::FormHandler::Field::Display - display only field

VERSION

version 0.40010

SYNOPSIS

This class can be used for fields that are display only. It will render the value returned by a form's 'html_<field_name>' method, or the field's 'html' attribute.

has_field 'explanation' => ( type => 'Display',
   html => '<p>This is an explanation...</p>' );

or in a form:

has_field 'explanation' => ( type => 'Display' );
sub html_explanation {
   my ( $self, $field ) = @_;
   if( $self->something ) {
      return '<p>This type of explanation...</p>';
   }
   else {
      return '<p>Another type of explanation...</p>';
   }
}
#----
has_field 'username' => ( type => 'Display' );
sub html_username {
    my ( $self, $field ) = @_;
    return '<div><b>User:&nbsp;</b>' . $field->value . '</div>';
}

or set the name of the rendering method:

has_field 'explanation' => ( type => 'Display', set_html => 'my_explanation' );
sub my_explanation {
  ....
}

You can also supply an 'html' method with a trait or a custom field. See examples in t/field_traits.t and t/xt/display.t of the distribution.

AUTHOR

FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Gerda Shank.

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