Control API for Text View (textView)

A multiline region for displaying text. Text in the control is restricted to a single font, size and style unless set with HTML commands.

  • design
    Defines the appearance of the text. Design can be set to "HEADER1", "EMPHASIZED", "LABEL" etc. . The CSS controls how the different options get rendered. The following description is based on the standard CSS delivered.


    • Bold text, text size STANDARD
       

    • Bold text, text size +4 in comparison to STANDARD
       

    • Bold text, text size +2 in comparison to STANDARD
       

    • Bold text, text size STANDARD
       

    • Text size and attributes STANDARD
       

    • Text size -2 in comparison to STANDARD
       

    • Text size -2 in comparison to STANDARD
       

    • Italic text, text size STANDARD
       

    • No text attributes and standard text size
  • encode
    A boolean value that defines how the text is interpreted. HTML text formatting commands (e.g. <h1>, <i> etc.) can be used to change the display of the text. If there are no formatting commands in the text string, the encode attribute has no effect.

    Example

    text="<h1><i>Important</i></h>

    encode = "false"
    the text string is rendered by interpreting the formatting commands.

    Encode = "true"
    the formatting commands are displayed and not interpreted

  • id
    Identification name of the text.
  • layout
    Defines the alignment of the text.
    • BLOCK
      Renders the textView with a <div> HTML tag.
    • NATIVE
      Renders the textView with a <span> HTML tag.
    • PARAGRAPH
      Renders the textView with a <p> HTML tag
  • required
    Deprecated - the control 'label' should be used instead to label required input fields.
    A boolean value. If set to "true" an asterisks (*) in red color is placed at the end of the text string. This is a common method to indicate that input is required. See also inputField and label.
  • text
    Defines the string of text displayed. See 'encode' for a formatting example with embedded HTML commands.
  • tooltip
    Defines the hint of the textView which is displayed as the mouse cursor passes over the textView, or as the mouse button is pressed but not released.
  • width
    Defines the width of the textView. The width shows only effect when the 'wrapping' attribute is set to "true". Otherwise the width and layout follows the HTML commands in the text string.
  • wrapping
    A boolean value. If set to "true" the text is word wrapped at the set 'width' or - if no 'width' is set - at the form width.
attribute req. values default case sens. JSP taglib classlib
design no EMPHASIZED
HEADER1
HEADER2
HEADER3
LABEL
LABELSMALL
LEGEND
REFERENCE
STANDARD 		STANDARD yes design="HEADER1" setDesign(TextViewDesign.HEADER1)
encode no TRUE
FALSE 		TRUE yes encode="FALSE" setEncode(false)
id yes String none yes id="Intro_Text"  
layout no BLOCK
NATIVE
PARAGRAPH		 NATIVE yes layout="BLOCK" setLayout(TextViewLayout.BLOCK)
required no TRUE
FALSE 		FALSE yes required="TRUE" setRequired(true)
text no String none no text="PDK Introduction" setText("PDK Introduction")
tooltip no String none no tooltip="PDK Document" setTooltip("PDK Document")
width no Unit 100% no width="300" setWidth("300")
wrapping no TRUE
FALSE 		FALSE yes wrapping="TRUE" setWrapping(true)

 

Example
<hbj:textView
         id="Text_ZIP"
         text="ZIP Code"
         design="EMPHASIZED"
/>
Result