Red Hat Web Application Framework 6.1: WAF Developer Guide
Prev	Appendix A. Bebop Tag Library Reference	Next

A.2. Available Page Definition Tags

	Caution
	These tags are highly experimental.

Tag Description

<define:page name="..." title="..." [pageClass="..."]

The define:page tag is the top-level tag for Bebop-JSP integration, and it is responsible for several processing actions:

— Declaring a Bebop Page object.

— Generating an XML document from Bebop.

— Putting this XML document into the request attributes for the show:page tags.

name is the name of the pageContext attribute that refers to the Bebop page. The optional pageClass attribute is the name of the Page class that will be used as the base class for the created page.

<define:image [name=...] src=... [height=...] [width=...] [alt=...] [border=...]/> Creates an Image object at this point in the page.

<define:link [name=...] url=.../> Creates an Link object at this point in the page.

<define:form name=... [method=...] [action=...] [encType=...]> The define:form tag indicates that a Bebop form should be created at this particular location in the page.

<define:text name=... [size=...] [maxLength=...] [type=...]/> Creates a TextField at this particular location in the page.

<define:textArea name=... [rows=...] [cols=...] [wrap="nowrap|soft|hard"]/> Creates a TextArea at this particular location in the page.

<define:submit name=... [label=...] [bundle=...]/> Creates a form submit button at this particular location in the page, with an optional specified label. If a resource bundle is specified the label is used as a key.

<define:radioGroup name=...> Creates a radio group. Must be enclosed within a form.

<define:checkboxGroup name=... [vertical="true"]> Creates a checkbox group. Must be enclosed within a form. Checkboxes are arranged horizontally by default, but can be arranged vertically with the vertical attribute.

<define:select name=...> Creates a selection widget. Must be enclosed within a form.

<define:multipleSelect name=...> Creates a multi-selection widget. Must be enclosed within a form.

<define:option name=... [value=...] [selected=...] [bundle=...] /> defines an option within a select widget or checkbox/radio group.

<define:component classname=...> Creates a component of the given class and adds it at the current location in the page. Requires that the component class have a no-argument constructor.

Table A-2. Tags available for defining Bebop components

Note that if a JSP tag does not exist for adding a particular component to a page, it is trivial to create. As a last resort, you can use the generic define:component tag if the class has a no-argument constructor. It is also trivial to escape into Java from a JSP and create a component object explicitly in a Java scriptlet:

<define:page name="p" title="page title">
  <% 
    MyComponent c = new MyComponent();
    p.add(c);
  %>
</define:page>