Options

Suppose you have multiple forms in a html file and only want to fill in one.

  $output = HTML::FillInForm->fill(\$html, $q, target => 'form1');

This will fill in only the form inside

  <FORM name="form1"> ... </FORM>

fill_password => 0

Passwords are filled in by default. To disable:

  fill_password => 0

ignore_fields => []

To disable the filling of some fields:

    ignore_fields => ['prev','next']

disable_fields => []

To disable fields from being edited:

    disable_fields => [ 'uid', 'gid' ]

invalid_fields => []

To mark fields as being invalid (CSS class set to "invalid" or whatever you set invalid_class to):

    invalid_fields => [ 'uid', 'gid' ]

invalid_class => "invalid"

The CSS class which will be used to mark fields invalid. Defaults to "invalid".

clear_absent_checkboxes => 0

Absent fields are not cleared or in any way changed. This is not what you want when you deal with checkboxes which are not sent by browser at all when cleared by user.

To remove "checked" attribute from checkboxes and radio buttons and attribute "selected" from options of select lists for which there's no data:

    clear_absent_checkboxes => 1

File Upload fields

Clearing Fields

  # this will leave the form element foo untouched
  HTML::FillInForm->fill(\$html, { foo => undef });

  # this will set clear the form element foo
  HTML::FillInForm->fill(\$html, { foo => "" });

It has been suggested to add a option to change the behavior so that undef values will clear the form elements. Patches welcome.

You can also use "clear_absent_checkboxes" option to clear checkboxes, radio buttons and selects without corresponding keys in the data:

    # this will set clear the form element foo (and all others except
    # bar)
    HTML::FillInForm->fill(\$html, { bar => 123 },
        clear_absent_checkboxes => 1);

new

  $fif = HTML::FillInForm->new;
  $fif->fill(...);

In theory, there is a slight performance benefit to calling "new()" before "fill()" if you make multiple calls to "fill()" before you destroy the object. Benchmark before optimizing.

fill ( old syntax )

HTML source options:

    arrayref  => @html
    scalarref => $html
    file      => \*HTML 
    file      => 't.html'

Fill Data options:

    fobject   => $data_obj  # with param() method
    fdat      => \%data

Additional methods are also available:

    fill_file(\*HTML,...);
    fill_file('t.html',...);
    fill_arrayref(\@html,...);
    fill_scalarref(\$html,...);

Apache::PageKit

Apache::ASP v2.09 and above

  PerlSetVar FormFill 1
  $Response->{FormFill} = 1

HTML::Mason