The parse() class method will parse an HTML document and build up
HTML::Form objects for each <form> found. If called in scalar
context only returns the first <form>. Returns an empty list if there
are no forms to be found.
The $base_uri is (usually) the URI used to access the $html_document.
It is needed to resolve relative action URIs. For LWP this parameter
is obtained from the $response->base() method.
This method is used to locate some specific input within the form. At
least one of the arguments must be defined. If no matching input is
found, undef is returned.
If $name is specified, then the input must have the indicated name.
If $type is specified then the input must have the specified type. In
addition to the types possible for <input> HTML tags, we also have
``textarea'' and ``option''. The $no is the sequence number of the input
with the indicated $name and/or $type (where 1 is the first).
Will click on the first clickable input (input/submit or
input/image), with the indicated $name, if specified. You can
optinally specify a coordinate clicked, which only makes a difference
if you clicked on an image. The default coordinate is (1,1).
An HTML::Form contains a sequence of inputs. References to the
inputs can be obtained with the $form->inputs or $form->find_input
methods. Once you have such a reference, then one of the following
methods can be used on it:
These methods can be used to set/get the current name or value of an
input. If the input only can take an enumerated list of values, then
it is an error to try to set it to something else and the method will
croak if you try.