/ 
HTML-HTML5-DOM-0.002
River stage zero No dependents
/ HTML::HTML5::DOM::HTMLFormElement

NAME

HTML::HTML5::DOM::HTMLFormElement - implementation of the HTMLFormElement interface of the HTML DOM

DESCRIPTION

HTML::HTML5::DOM::HTMLFormElement is an implementation of the HTMLFormElement interface of the HTML DOM. See HTML::HTML5::DOM for a list of the conventions that have been used when translating the DOM to Perl.

HTML Elements

This class applies to the following HTML elements.

  • {http://www.w3.org/1999/xhtml}form

Inheritance

HTML::HTML5::DOM::HTMLFormElement inherits methods from the following Perl classes.

Additional Methods

As well as its inherited methods, this class provides the following methods.

  • acceptCharset

    Called with no arguments, is a shortcut for $elem->getAttribute("accept-charset"). Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

  • action

    Called with no arguments, is a shortcut for $elem->getAttribute("action") but as a blessed URI object. Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

  • autocomplete

    Called with no arguments, is a shortcut for $elem->getAttribute("autocomplete"). Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

  • elements

    Returns a list of form-related elements which this form owns. In list context this is a normal Perl list. In scalar context it is a HTML::HTML5::DOM::HTMLFormControlsCollection.

  • encoding

    Called with no arguments, is a shortcut for $elem->getAttribute("encoding"). Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

  • enctype

    Called with no arguments, is a shortcut for $elem->getAttribute("enctype"). Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

  • length

    The length of the elements list.

  • method

    Called with no arguments, is a shortcut for $elem->getAttribute("method"). Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

  • name

    Called with no arguments, is a shortcut for $elem->getAttribute("name"). Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

  • noValidate

    Called with no arguments, is a shortcut for $elem->getAttribute("novalidate"). Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

  • p5_submittableElements

    Returns a list of form-related elements which this form owns that can potentially cause name=value pairs to be added to the form submission. (e.g. not <fieldset>.) In list context this is a normal Perl list. In scalar context it is a HTML::HTML5::DOM::HTMLFormControlsCollection.

  • submit

    Submits the form based on the current values of its submittable elements. May be passed an optional hashref of name=>value pairs to override those values, but this is not always enough to do what you want, as HTML allows for multiple form elements of the same name to exist in a form.

  • target

    Called with no arguments, is a shortcut for $elem->getAttribute("target"). Called with a defined argument, acts as setAttribute. Called with undef as an argument, acts as removeAttribute.

BUGS

http://rt.cpan.org/Dist/Display.html?Queue=HTML-HTML5-DOM.

SEE ALSO

HTML::HTML5::DOM.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

This software is copyright (c) 2012, 2014 by Toby Inkster.

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

DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.