Back Forward HTML Fragment form
Completing the HTML tab

About HTML Fragment rules

You can enter the HTML, JavaScript, or Cascading Style Sheet code directly into the HTML Source text area.

For extended input, click the pencil icon (pencil) to start your HTML editor. If you have not registered an HTML editor, Windows Notepad starts. (See Open authoring for details on setting up an HTML editor.)

Use the literal directive around any curly brace characters in JavaScript or Cascading Style Sheet text.

Field

Description

Omit extra Spaces?

Select to eliminate extra space characters in the processed HTML. This can make transmission or processing more efficient. Is does not alter the appearance of the HTML when displayed in a browser.

When selected, during stream processing the system:

  • Deletes control characters such as tab and newline.
  • Replaces two or more consecutive space characters with a single space, except within the curly brace characters defining directives.

Stream processing always copies space characters within the text of a property value, non-breaking spaces (such as  ), and space characters within a literal directive into the processed HTML without change.

Generate For

This field and the Convert to JSP button appear only when the rule contains HTML directives rather than JSP tags. The value that appears is HTML.

TipAs a best practice, use JSP tags rather than directives. In most cases, you can convert HTML fragments that use directives to use JSP tags automatically, using the button. See Converting from directives to JavaServer Page tags.

NoteDo not save the rule form when the source contains both JSP tags and directives.

NoteIf this rule is circumstance-qualified or time-qualified, make this Generate For value match the Generate For value of the base rule. The base rule and the qualified rules must all use JSP tags or all use directives. B-20380

HTML Source

Enter the HTML, script, or CSS text. The text may include directives or JSP tags, but not both. Update the Pages & Classes tab to include each page name referenced in the HTML code, with the corresponding class. B-16304

NoteAlthough HTML fragment rules do not have an Applies To key part, you can identify the class of a primary page on the Pages & Classes tab, leaving the Page Name field blank. After you update the Pages & Classes tab, you can reference properties on this page without identifying the page name. B-22073 BUG-2066 GENTJ 10/30/06

Tip Use of JSP tags in HTML fragment rules offers superior performance and other advantages over directives. Although both directives and JSP tags are supported, JSP tags are recommended for new development. Conversion of existing HTML fragment rules that use directives to functionally equivalent rules that use JSP tags is straightforward.

Convert to JSP

This button appears only after you save the form when the Generate For value is HTML and this rule is created by a Save As operation. See Converting from directives to JavaServer Page tags.

Up About HTML Fragment rules