Form Properties

The following properties of NativeForm control how the form is submitted:

• Method (GET or POST). 
• Multipart
• Action
• Target
• Target IFrame

The Method property must be POST and Multipart must be true if your form includes a file upload field.

The Action property is the URL of the service to which to submit the form. This can be an absolute or a relative URL. If it is relative, then the URL is resolved relative to the application directory (jsx3.app.Server.resolveURI()).

Do not ignore cross domain issues. You can submit to another domain/schema/port, however, you will only be able to read the response from the submission if the URL scheme, domain, and port are exactly the same as the URL of the page hosting the General Interface application.

The Target and Target IFrame properties control where the response from the submission is displayed. In most cases it is best to submit the form invisibly and process the response programatically. In this case, set Target to Invisible IFRAME. You can also have the response render in a native pop-up window (Target = New Window) or have it replace the page hosting the GI application (Target = Current Window). Using the Target IFrame property you can have the response render in an instance of jsx3.gui.IFrame.

The following components can aid in creating accessible HTML forms.

• jsx3.gui.Label - renders a native <label> element. In HTML forms a label is associated with a form field. Set the For Control property of the label to the name of a GI form field to associate it with that field. Using labels helps screen readers and other accessibility software make better sense of the form.
• <fieldset>, <legend> and <h1> through <h6> (all instances of jsx3.gui.Block) - add semantic meaning to form layout and elements that can improve accessibility.

The following figure shows a form being built in General Interface Builder. 

Here is the source code for the form displayed above: form.xml