NAME

       HTMLDocument::addRemoteForm - Add a form to call another application

SYNOPSIS

       ElementTree addRemoteForm( ElementTree parent, String action, FormType method )

ARGUMENTS

       parent The parent element

       action The URL of the other application

       method The method to use to send the form data

DESCRIPTION

       This adds a form that points to a specified URL. Unless the other URL is a (byte for byte)
       identical copy of the current application, you will not be  able  to  use  Kaya's  special
       state handling, and must construct another way of passing the information. If the security
       of the information is not critical, and the other application is also a Kaya  application,
       then the Pickle(3kaya) module may be of use.

    form = addRemoteForm(doc.body,
                         "http://www.example.com/email.cgi",
                         FormPost);

       Note  that in HTML form input controls may not be placed directly inside a form - you must
       add block-level elements to the form and add controls  to  those  elements.  The  fieldset
       element  is  especially  suited  to this and the HTMLDocument.addFieldset (3kaya) function
       handles this.

AUTHORS

       Kaya standard library by Edwin Brady, Chris Morris  and  others  (kaya@kayalang.org).  For
       further information see http://kayalang.org/

LICENSE

       The Kaya standard library is free software; you can redistribute it and/or modify it under
       the terms of the GNU Lesser General Public License (version 2.1 or any later  version)  as
       published by the Free Software Foundation.

RELATED

       HTMLDocument.FormType (3kaya)
       HTMLDocument.addFieldset (3kaya)
       HTMLDocument.addLocalForm (3kaya)