WebSphere

 

Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

 

Text, rich text and HTML elements

You use text, rich text and HTML elements to store blocks of text, but each has slightly different properties.

 

Text elements

You use a text element to store text or HTML as an element. No special processing occurs for this element. This is useful if you have a piece of text or HTML that is used in more than one area of your site. You can store a text element in an authoring template, site, site area, content item or text component.

 

Rich text elements

A rich text element is the same as a text element except that it includes a rich text editor that can be used to format text stored within a rich text element. The main purpose of the rich text element is provide base-level content creators with an easy-to-use text editor. Advanced users who are required to produce more advanced code, including IBM® Workplace Web Content Management™ tags, should use an HTML element instead.

You access the accessibility features of the rich text editor by typing control-shift-m. This launches the detached accessible toolbar. You then use the following keystrokes:

Control-shift-t

This launches the table insertion dialog. Users should first select the point at which to create the table in the edit window, and then launch the table insertion dialog. You use the tab button to navigate through the data entry fields that are used to define the table. Users may click the OK button to insert the table or click the Cancel button to cancel the action.

Control-shift-g

This launches the color picker dialog. Users should first select some text in the edit window, and then launch the color picker. Users can use the tab key to navigate through the color swatches. The selected color name and value are displayed in the top text area. Users may press the Enter key to apply the color to the selected text or press the Cancel button to cancel the action.
The detached accessible toolbar can be closed by using the alt-F4 keystroke.

You can customize the detached accessible toolbar keystrokes by editing the KeySequence.properties file located under the ..\PortalServer\shared\app\com\ibm\wps\odc\editors folder.

 

HTML elements

An HTML element is similar to the rich text element but does not include a rich text editor. You can enter HTML directly into the element or upload HTML from a previously created HTML file. An HTML element is stored in an authoring template, site, site area, content item or HTML component.

 

Uploading HTML into rich text and HTML elements

You can upload HTML from HTML files created in other programs to rich text and HTML elements. See Importing and exporting HTML later in this section. HTML elements should be used by advanced users who are required to use advanced code such as Web Content Management tags.

 

Inserting links and images into rich text and HTML elements

See Inserting a link in an element for information on inserting links to other items.

See Inserting an image in an element for information on how to insert an image into a rich text or HTML element.

 

Use Web Content Management tags in rich text and HTML elements

Text elements

Web Content Management tags cannot be used in text elements.

HTML elements

Any combination of Web Content Management tags can be used in HTML elements with the following exceptions:

  1. You cannot use single quotes around attribute values.

    • <Component name='example'/>

    • <Component name='example' start='<a href="' end=' ">link</a>'/>

    • <Component name='example' start='<img src="' end=' "/>'/>

  2. You cannot use double quotes inside attribute values.

    • <Component name="example" start="<a href="" end="">link</a>"/>

    • <Component name="example" start="<img src="" end=""/>"/>

Rich text elements Basic Web Content Management tags can be used in rich text elements. For example, the following tags can be used in Rich Text elements:

  • <component name="test"/>

  • <element type="content" context="current" key="body"/>

Highlighting of rich text elements is not enabled by default. To enable this support, ensure that your server administrator adds the following line to the WCMConfigService.properties file:

wcm.enableWCMTagHighlighting=true
The following tag formats are invalid:

  1. The use of single quotes around attribute values.

    • <Component name='example'/>

    • <Component name='example' start='<a href="' end=' ">link</a>'/>

    • <Component name='example' start='<img src="' end=' "/>'/>

  2. The use of double quotes inside attribute values.

    • <Component name="example" start="<a href="" end="">link</a>"/>

    • <Component name="example" start="<img src="" end=""/>"/>

  3. Embedding tags inside other HTML tags.

    • <a href='<Component name="example"/>'>link</a>

    • <img src='<Component name="example"/>'/>

 

Parent topic:

Storing text and HTML