Class FormElement

  • All Implemented Interfaces:
    java.lang.Cloneable

    public class FormElement
    extends Element
    A HTML Form Element provides ready access to the form fields/controls that are associated with it. It also allows a form to easily be submitted.
    • Field Detail

      • elements

        private final Elements elements
    • Constructor Detail

      • FormElement

        public FormElement​(Tag tag,
                           java.lang.String baseUri,
                           Attributes attributes)
        Create a new, standalone form element.
        Parameters:
        tag - tag of this element
        baseUri - the base URI
        attributes - initial attributes
    • Method Detail

      • elements

        public Elements elements()
        Get the list of form control elements associated with this form.
        Returns:
        form controls associated with this element.
      • addElement

        public FormElement addElement​(Element element)
        Add a form control element to this form.
        Parameters:
        element - form control to add
        Returns:
        this form element, for chaining
      • removeChild

        protected void removeChild​(Node out)
        Overrides:
        removeChild in class Node
      • submit

        public Connection submit()
        Prepare to submit this form. A Connection object is created with the request set up from the form values. You can then set up other options (like user-agent, timeout, cookies), then execute it.
        Returns:
        a connection prepared from the values of this form.
        Throws:
        java.lang.IllegalArgumentException - if the form's absolute action URL cannot be determined. Make sure you pass the document's base URI when parsing.
      • formData

        public java.util.List<Connection.KeyVal> formData()
        Get the data that this form submits. The returned list is a copy of the data, and changes to the contents of the list will not be reflected in the DOM.
        Returns:
        a list of key vals