APPLICATION DESIGN

Controlling the HTML generated for a form
With Release 8, IBM® Lotus® Domino(TM) adds the ability to change the HTML generated at both the form and individual field level. Note that these options are not included in the HTML (see "Importing HTML into a page or form" for form header or HTML body attributes), but control how the Domino server translates the field into HTML and how input in that field is processed.

HTML options are indicated by a list of name=value pairs. The name consists of alphanumeric characters (letters, numbers, underscore, dash), and indicates the option that is being set. The value is a number, and indicates the setting of that option.

The HTML options for an entire form are stored in a Computed for Display text field, named $$HTMLOptions. If more than one HTML option is to be set for the form, the field must be set to allow multiple values.

Field-level HTML options will override form-level HTML options.

These are the options that are available.
Option nameOption action
DisablePassThruHTMLDisables passthru HTML, treating the HTML as plain text.
ForceSectionExpand Forces all sections to be expanded, regardless of their expansion in the Notes rich text fields.
ForceOutlineExpandForces all outlines to be expanded, regardless of their expansion in the Notes rich text.
RowAtATimeTableAlt Forces alternate formatting of tables with tabbed sections. All of the tabs are displayed at the same time, one below the other, with the tab labels included as headers.
TextExactSpacingPreserves Notes intraline whitespace (spaces between characters).

Controlling the HTML tag attributes generated for a form

The HTML tag attributes are the optional attributes that are included in the <html> statement of a document displayed on the Web. With Release 8, Domino adds the ability to control these attributes.

HTML tag attributes for a form are stored in a Computed for Display text field that is hidden from Web browsers, named $$HTMLTagAttributes.

Specify the value of this field inside quotation marks. For example, specifying a value of "lang=en" would produce the following statement in the resulting HTML.

<html lang=en>

Controlling the HTML front matter generated for a form

The HTML front matter consists of an optional <!DOCTYPE> statement that can occur before the <html> statement of a document displayed on the Web. With Release 8, Domino adds the ability to control these attributes.

HTML front matter information for a form is stored in a Computed for Display text field that is hidden from Web browsers, named $$HTMLFrontMatter.

Specify the value of this field inside quotation marks, and include the entire statement. For example, this code specifies if an HTML document should be viewed with strict or transitional encoding, depending on the value of a field on the form named Mode.

@If(Mode="Strict";
    "<!DOCTYPE HTML PUBLIC" + @NewLine +
    "    \"-//W3C//DTD HTML 4.01\"" + @NewLine +
    "    \"http://www.w3.org/TR/REC-html40.strict.dtd\">" + @NewLine;
    "")

See Also