Faces components reference

Faces components reference

After you open the Faces Components drawer on the Palette, you can add any of the following components to a Faces JSP page.

Some components may be hidden on the palette. To show a hidden component in the palette, right-click within the Palette view and choose Customize. Remove the check next to Hide for each component that you want to display on the palette.

Each component has a number of attributes that you can set on the Properties view for the component. If the Properties view for a Faces component does not open when you select the component, select Windows > Show View > Properties. For an alphabetical listing and description of all the attributes that appear in the Properties views, refer to Attributes for Faces components or Attributes for Faces media components.

Note that some sub-components are not added from the palette. Instead, they are added from the Properties view of the parent component. For example, after you add a data table component to a page, you can then add a row edit component from the Properties view of the data table.

The following table lists the Faces components, in alphabetic order, that you can add from the palette.

Faces Component Description Tag
Check Box Display a single check box. selectBooleanCheckbox
Check Box Group Display multiple check boxes. The user can check more than one. selectManyCheckbox
Combo Box Display a drop-down combo box from which the user chooses one item. selectOneMenu
Command - Button Create a push button that can have text or an image. The button may run an action. commandExButton
Command - Hyperlink Create a hyperlink but is also capable of performing actions such as updating records. commandLink
Data Table Create a table of data in which the rows correspond to data records and the columns correspond to fields or categories. Features include paging controls, headers and footers, and support for row selection and actions. dataTable
Display Error Insert error text that is conditionally displayed. Errors are associated with a specific component. message
Display Errors Insert error messages that are conditionally displayed when an error has occurred on the page. Display errors for entire page. messages
File Upload Display an input field and associated Browse button for uploading a file. fileupload
Form Create a main container for other components. Added automatically when needed. form
Horizontal Rule Create a horizontal line to visually separate information on the page. outputSeparator
Image Display an image on the page. Can display an image from a data source as well. graphicImageEx
Input Lets you create an input field for the following types of data. When you add an input component to a page, choose one of the following formats on the Properties view for the Input component. inputText

String- a simple text field of one line. This is the default.

inputText

Number - a number field for which you can set the style and format

convertNumber

Date/Time - a date and time field for which you can set the format.

convertDateTime

Mask - a filter that selectively includes or excludes certain values.

convertMask
Input - Hidden Insert a hidden input component. This component is often used by developers to pass data between pages or controls on the page. inputHidden
Input - Password Insert an input field in which the user enters a password. inputSecret
Input Text Area Insert an input component that displays text with multiple lines. inputTextarea
Label Insert an accessibility output label. outputLabel
Link Create a hyperlink to the URL you specify. outputLinkEx
List Box - Multiple Select Insert a list box in which the user can select multiple items. selectManyListbox
List Box - Single Select Insert a list box in which the user selects one item. selectOneListbox
Media Player Lets you create a media component on the page. Select from the following media components:

Generic A/V Player

playerGenericPlayer

Macromedia Flash Player

playerFlash

Microsoft Windows Media Player

playerMediaPlayer

Macromedia Shockwave Player

playerShockwave

Real Network RealOne Player

playerRealPlayer
Output Create output text that cannot be modified by the user. The text can be static or bound to a data source. Output components can display data from a data source as well as to display static text within most other Faces components (for example, as a label for an input field).
When you add an output component, choose one of the following formats on the Properties view for the Output component:
outputText

String - a simple text field. This is the default format.

outputText

Number - a number field for which you can set the style and format

convertNumber

Date/Time - a date and time field for which you can set the format.

convertDateTime

Mask - a filter that selectively includes or excludes certain values.

convertMask
Output - Formatted Text Output a formatted message to the page. The message can be a combination of static text and dynamic data that comes from a data storage. outputFormat
Panel - Group Box Create a container in which you can group other components. One use of panels is in the columns of a data table. When you drag a panel to a column, you can control how multiple components in the column are organized. You have the following options for this component:

List - organizes components as a vertical or horizontal list.

panelBox

Grid - organizes components in a grid. You can specify the number of columns in the grid.

panelGrid

Snap to border - organizes components along the sides of the panel.

panelLayout

HTML - inserts a panel that can contain any other HTML, JSP, or Faces components within it. Most Faces components can contain other Faces tags but not HTML tags. However, this jspPanel component can contain both Faces and HTML tags. For example, you cannot usually create an HTML table within a column of a Faces data table. However, if you drag this component to the column, you can create an HTML table within it. In addition, the HTML table can also contain Faces tags.

jspPanel
Panels - Menu Bar Insert a panel that places commands into a menu bar. You can drag and drop buttons, hyperlinks, and horizontal rules to the panel or add them from within the Properties views of the components. You can also add a sub-menu bar within a menu bar. panelActionbar
Panels - Tabbed Create a set of overlapping, tabbed pages. Each page can contain a set of components. The user clicks a tab to show the contents of that page. tabbedPanel
Radio Button Group Display a group of radio buttons. The user can click only one. selectOneRadio
Rich Text Area Insert a rich text editor component. Like the Input - Text Area component, this component can have text on multiple lines. Unlike the Input Text Area, this component can contain different fonts and sizes, tables, links, and numbered and bulleted lists. inputRichText
Verbatim Insert a verbatim tag that lets you add HTML directly onto a Faces JSP page. verbatim

Related concepts
JavaServer Faces
Faces components

Related tasks
Using Faces components

Related reference
Attributes for Faces components
Attributes for Faces media components

Faces Component	Description	Tag
Check Box	Display a single check box.	selectBooleanCheckbox
Check Box Group	Display multiple check boxes. The user can check more than one.	selectManyCheckbox
Combo Box	Display a drop-down combo box from which the user chooses one item.	selectOneMenu
Command - Button	Create a push button that can have text or an image. The button may run an action.	commandExButton
Command - Hyperlink	Create a hyperlink but is also capable of performing actions such as updating records.	commandLink
Data Table	Create a table of data in which the rows correspond to data records and the columns correspond to fields or categories. Features include paging controls, headers and footers, and support for row selection and actions.	dataTable
Display Error	Insert error text that is conditionally displayed. Errors are associated with a specific component.	message
Display Errors	Insert error messages that are conditionally displayed when an error has occurred on the page. Display errors for entire page.	messages
File Upload	Display an input field and associated Browse button for uploading a file.	fileupload
Form	Create a main container for other components. Added automatically when needed.	form
Horizontal Rule	Create a horizontal line to visually separate information on the page.	outputSeparator
Image	Display an image on the page. Can display an image from a data source as well.	graphicImageEx
Input	Lets you create an input field for the following types of data. When you add an input component to a page, choose one of the following formats on the Properties view for the Input component.	inputText
	String- a simple text field of one line. This is the default.	inputText
	Number - a number field for which you can set the style and format	convertNumber
	Date/Time - a date and time field for which you can set the format.	convertDateTime
	Mask - a filter that selectively includes or excludes certain values.	convertMask
Input - Hidden	Insert a hidden input component. This component is often used by developers to pass data between pages or controls on the page.	inputHidden
Input - Password	Insert an input field in which the user enters a password.	inputSecret
Input Text Area	Insert an input component that displays text with multiple lines.	inputTextarea
Label	Insert an accessibility output label.	outputLabel
Link	Create a hyperlink to the URL you specify.	outputLinkEx
List Box - Multiple Select	Insert a list box in which the user can select multiple items.	selectManyListbox
List Box - Single Select	Insert a list box in which the user selects one item.	selectOneListbox
Media Player	Lets you create a media component on the page. Select from the following media components:
	Generic A/V Player	playerGenericPlayer
	Macromedia Flash Player	playerFlash
	Microsoft Windows Media Player	playerMediaPlayer
	Macromedia Shockwave Player	playerShockwave
	Real Network RealOne Player	playerRealPlayer
Output	Create output text that cannot be modified by the user. The text can be static or bound to a data source. Output components can display data from a data source as well as to display static text within most other Faces components (for example, as a label for an input field). When you add an output component, choose one of the following formats on the Properties view for the Output component:	outputText
	String - a simple text field. This is the default format.	outputText
	Number - a number field for which you can set the style and format	convertNumber
	Date/Time - a date and time field for which you can set the format.	convertDateTime
	Mask - a filter that selectively includes or excludes certain values.	convertMask
Output - Formatted Text	Output a formatted message to the page. The message can be a combination of static text and dynamic data that comes from a data storage.	outputFormat
Panel - Group Box	Create a container in which you can group other components. One use of panels is in the columns of a data table. When you drag a panel to a column, you can control how multiple components in the column are organized. You have the following options for this component:
	List - organizes components as a vertical or horizontal list.	panelBox
	Grid - organizes components in a grid. You can specify the number of columns in the grid.	panelGrid
	Snap to border - organizes components along the sides of the panel.	panelLayout
	HTML - inserts a panel that can contain any other HTML, JSP, or Faces components within it. Most Faces components can contain other Faces tags but not HTML tags. However, this jspPanel component can contain both Faces and HTML tags. For example, you cannot usually create an HTML table within a column of a Faces data table. However, if you drag this component to the column, you can create an HTML table within it. In addition, the HTML table can also contain Faces tags.	jspPanel
Panels - Menu Bar	Insert a panel that places commands into a menu bar. You can drag and drop buttons, hyperlinks, and horizontal rules to the panel or add them from within the Properties views of the components. You can also add a sub-menu bar within a menu bar.	panelActionbar
Panels - Tabbed	Create a set of overlapping, tabbed pages. Each page can contain a set of components. The user clicks a tab to show the contents of that page.	tabbedPanel
Radio Button Group	Display a group of radio buttons. The user can click only one.	selectOneRadio
Rich Text Area	Insert a rich text editor component. Like the Input - Text Area component, this component can have text on multiple lines. Unlike the Input Text Area, this component can contain different fonts and sizes, tables, links, and numbered and bulleted lists.	inputRichText
Verbatim	Insert a verbatim tag that lets you add HTML directly onto a Faces JSP page.	verbatim