webuijsf
Tag markup


Use the webuijsf:markup tag to insert any type of XML markup in the rendered HTML page. The webuijsf:markup tag allows you to insert HTML elements into the JSP page where HTML is not permitted inside a JSF tag. 

Configuring the markup tag

Use the tag attribute to specify the type of HTML element to insert.  For instance, to insert a <p> tag, set the attribute to tag="p" in the webuijsf:markup tag.  Note that you do not include the angle brackets.

If the HTML element you are inserting is a singleton element, you must specify the singleton attribute.  The singleton attribute causes the trailing /> to be generated in the rendered HTML. For example, the  <br> element is a singleton element, which must be rendered as <br /> to be XHTML compliant.

If you want to specify additional HTML attributes for the element you are inserting, use the extraAttributes attribute.

HTML Elements and Layout

The rendered HTML page includes the HTML element that was specified in the webuijsf:markup tag's tag attribute, along with any HTML attributes that were included in the extraAttributes attribute.

Theme Identifiers

None.

Client Side Javascript Functions 

None.

Examples

Example 1:  Insert a singleton element

<webuijsf:markup tag="br" singleton="true" />

This generates <br />.

Example 2: Insert a <div> element with a style attribute

   <webuijsf:markup tag="div" style="color:blue" />

This generates <div style="color:blue" >

Example 3: Insert a <h3> with HTML attributes

    <webuijsf:markup tag="h3" extraAttributes="onclick='alert(&quot;foobar&quot;);'" >
        <webuijsf:staticText text="Example" />
    </webuijsf:markup>
This generates a level 3 head titled Example that will display the alert with "foobar" in it when clicked.


Tag Information
Tag Classcom.sun.webui.jsf.component.MarkupTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
bindingfalsefalsejava.lang.String A ValueExpression that resolves to the UIComponent that corresponds to this tag. This binding allows the Java bean that contains the UIComponent to manipulate the UIComponent, its properties, and its children.
styleClassfalsefalsejava.lang.String

CSS style class(es) to be applied to the outermost HTML element when this component is rendered.

singletonfalsefalsejava.lang.String

Flag indicating that tag is a singleton tag and that it should end with a trailing /

extraAttributesfalsefalsejava.lang.String

Add the rest of the attribute name="value" type pairs inside this attribute. The inserted attributes will need to be escaped.

tagfalsefalsejava.lang.String

Name of the HTML element to render.

stylefalsefalsejava.lang.String

CSS style(s) to be applied to the outermost HTML element when this component is rendered.

renderedfalsefalsejava.lang.String Use the rendered attribute to indicate whether the HTML code for the component should be included in the rendered HTML page. If set to false, the rendered HTML page does not include the HTML for the component. If the component is not rendered, it is also not processed on any subsequent form submission.
idfalsetruejava.lang.StringNo Description

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.