RCFaces CORE components


Standard Syntax:
     <%@ taglib prefix="v" uri="http://rcfaces.org/core" %>

XML Syntax:
     <anyxmlelement xmlns:v="http://rcfaces.org/core" />

A set of Components that are not dependant on a specific render-kit.

Tag Library Information
Display NameRCFaces CORE components
Version1.0
Short Namev
URIhttp://rcfaces.org/core
 

Tag Summary
accelerator

The accelerator Component is a non-visual component.

It allows to associate an accelerator key to an action or another component.

The accelerator Component has the following capabilities :

  • Key pressed
  • Association to another component

box

The Box Component is a container.

It can have a graphical representation or not; But it is mainly used to apply a collective treatment to a set of component, for example show or hide a group of component.

The Box Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Margin
  • Help
  • Visibility
  • Background Image
  • Border
  • Events Handling
  • Contextual Menu
  • Async Render (AJAX)

button

The button Component is equivalent to the standard HTML tag <BUTTON>.

The button Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

checkButton

The checkButton Component is equivalent to the <INPUT TYPE="checkbox"> HTML tag.

The checkButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

checkButton3States

The checkButton3States Component is a CheckButton with 3 states : Check, unchecked and undefined. It is often used to show the state of a group of checkButtons

This component is experimental.

The checkButton3States Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

combo

The combo Component is equivalent to the standard HTML tag <SELECT SIZE=1>.

The combo Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

customButton A button Component highly customizable through its API.
dataColumn Specify a column.
pager

The pager Component is linked to the dataGrid Component. It shows informations about the result set (ex: number of available pages) and can give direct access to a specific page ("a la Google").

The pager Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Association with another component

dataGrid

The dataGrid Component is a grid component. It can be compared to the grid found in the list part of the modern file explorer. It allows sorts, resizing, contextual menus ...

The dataGrid Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & images
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Contextual actions in cell, row or table scope
  • ...

componentsGrid Reserved for future use
componentsList Shows the components for each data with pagination.
dateItem An item specialized for date values.
calendar

The calendar Component shows a calendar. It can be customized in differents ways (days off, holidays, tool tips ...).

The calendar Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Calendar functions

dateEntry

The dateEntry Component is a specialized textEntry Component. it sports auto-completion related to the validity of the numbers entered as a date.

The dateEntry Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & separators
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Calendar functions

dateChooser

The dateChooser Component is a button that shows a calendar and help the user to choose a date. It can be associated to a entry field, the choosen date is then automatically entered in the field. It works like an Image Button Component. The dateChooser Component does not provide an Entry field.

The dateChooser Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Association with another component

expandBar

The expandBar Component is a container that can be collapsed to show only a title bar. Expand Bars can be managed by group : only one element of the group is expanded.

The expandBar Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility
  • Background Image
  • Events Handling
  • Contextual Menu
  • Async Render (AJAX)

selectImageItem A select item (member of a selectable list) that shows an image.
uiImageItem A select item (member of a selectable list) that shows an image. Ricer than a selectImageItem.
fieldSet

The fieldSet Component is a container with a title (text and/or picture).

The fieldSet Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility
  • Background Image
  • Events Handling
  • Contextual Menu
  • Async Render (AJAX)

helpButton

The helpButton Component is an ImageButton. It opens a new page showing the url specified in the "helpUrl" property of a component linked by the "for" property.

The helpButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Association with another component

imageSubmitButton

The ImageSubmitButton Component is a submitButton Component that can show an image.

The ImageSubmitButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

helpMessageZone

The helpMessageZone Component is a placeholder for help messages. The messages are shown when the pointer hover a component and this component has a "helpMessage" property.

The helpMessageZone Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & position
  • Margin & border
  • Help
  • Visibility
  • Events Handling

hyperLink

The hyperLink Component translates into a classic hyperlink and is a button.

The hyperLink Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

image

The image Component shows an image (it's equivalent to <img .../>).

The image Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Image
  • Margin
  • Help
  • Visibility
  • Events Handling

imageButton

The imageButton Component is a button Component that can show an image.

The imageButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

hiddenValue

The hiddenValue Component is a non-visual component. It is equivalent to and Input hidden type HTML tag.

It allows to access and store value on the client and on the server while keeping it concealed. The clientData Component can also be used.

The hiddenValue Component has the following capability :

  • Property changed Event handling

imageCheckButton

The imageCheckButton Component is a checkButton Component with an image instead of the checkBox.

The imageCheckButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

imageCombo

The imageCombo Component is a combo Component with an image added to the text.

The imageCombo Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

imagePagerButton

The imagePagerButton Component is an imageButton Component that works like the keyword in the pager Component and is linked to the dataGrid Component. It shows informations about the result set (ex: number of available pages) and can give direct access to a specific page ("a la Google").

The imagePagerButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Association with another component

The authorized types are :

  • first
  • prev
  • next
  • last
  • <number> where number is a page number

imageRadioButton

The imageRadioButton Component is a radioButton Component with an image instead of the rounded box.

The imageRadioButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

imageResetButton

The imageResetButton Component is a resetButton Component that can show an image.

The imageResetButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

lineBreak

The lineBreak Component is the <BR> HTML equivalent.

It is used often when simple HTML is not desirable : for example if a part of a page is loaded via AJAX it might be easier to have only a jsf tree memory represantation.

The lineBreak Component has the following capability :

  • Visibility

list

The list Component is based on the standard HTML tag <SELECT>.

The list Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text ,& font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

message

The message Component is a placeholder for error messages (only one is shown).

The message Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin
  • Help
  • Visibility
  • Events Handling

messageFieldSet

The messageFieldSet Component is a fieldSet Component combined with a message COmponent in the title part.

The messageFieldSet Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility
  • Background Image
  • Events Handling
  • Contextual Menu
  • Async Render (AJAX)

messages

The messages Component is a placeholder for error messages (several messages can be shown simultaneously).

The messages Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin
  • Help
  • Visibility
  • Events Handling

menu

The menu Component provides a way of creating desktop style menus on web pages. It allows sub-menus, check and radio menu items and image menus. It also provides pop-up menus.

The menu Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & images
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

menuBar Describes a top-level menu bar.
menuCheckItem A menu item with a check.
menuItem A menu item
menuSeparator A separator Menu item
menuRadioItem A menu item with a radiobutton (see attribute GroupName)
numberEntry NOT COMPLETE
passwordEntry

The passwordEntry Component is based on the standard HTML tag <INPUT TYPE="password"> and is a textEntry Component.

The passwordEntry Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

progressBar

The progressBar Component indicates the evolution of a task.

The progressBar Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • image
  • Margin & border
  • Help
  • Visibility

progressIndicator

The progressIndicator Component indicates the evolution of a task. It uses the porgressBar Component and add text information to it.

The progressIndicator Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Margin & border
  • Help
  • Visibility

suggestTextEntry

The suggestTextEntry is a textEntry Component with an autosuggestion feature that shows in the form of a dropdown list.

The suggestTextEntry Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

radioButton

The radioButton Component is based on the standard HTML tag <INPUT TYPE="radio">. It can interoperate automatically with other radioButtons from the same group.

The radioButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

resetButton

The resetButton Component is based on the standard HTML tag <INPUT TYPE="reset">. It is a button Component.

The resetButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

ruler

The ruler Component is the <HR> HTML equivalent.

It is used often when simple HTML is not desirable : for example if a part of a page is loaded via AJAX it might be easier to have only a jsf tree memory represantation.

The ruler Component has the following capability :

  • Position & Size
  • Foreground & Background Color
  • Visibility
  • Margin

scopeNo Description
submitButton

The submitButton Component is based on the standard HTML tag <INPUT TYPE="submit">. It is a button Component.

The submitButton Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

spinner

The spinner Component is a textEntry Component that accepts numbers and whose value can be incremented or decremented (by a parametrable step) with buttons or the keyboard arrows.

The spinner Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • limits and step

styledMessage An englobing tag that changes the style class surronuding a component when a particular message is emitted for a component. ex : <v:styledMessage errorStyleClass="formErreur" for="ef1"> <v:textEntry id="ef1" ... /> </v:styledMessage>
styledText

The styledText Component is a placeholder for displaying "enhanced" text. It accepts any HTML tags. it's a text Component

The styledText Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & justification
  • Margin
  • Help
  • Visibility
  • Events Handling
  • Association with another component

cardBox

The cardBox Component is similar to the tabbedPane Component without title and borders. It is usefull for showing alternatively different contents on the same page.

The cardBox Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

card An element belonging to a cardBox Component and holding the components.
tabbedPane

The tabbedPane Component provides a way to show more information on a single page. It can download the data asynchronously via AJAX.

The tabbedPane Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & image
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

tab An element belonging to a tabbedPane Component and holding the components.
text

The text Component is a placeholder for displaying text.

The text Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & justification
  • Margin
  • Help
  • Visibility
  • Events Handling
  • Association with another component

textEntry

The textEntry Component is based on the standard HTML tag <INPUT TYPE="text">.

The textEntry Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

textArea

The textAreaEntry Component is based on the standard HTML tag <TEXTAREA> and is a textEntry Component.

The textAreaEntry Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text & font
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling

timeEntry

The timeEntry Component is a specialized textEntry Component. it sports auto-completion related to the validity of the numbers entered as a time.

The timeEntry Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & separators
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Calendar functions

toolBar EXPERIMENTAL
toolFolder EXPERIMENTAL
toolItem EXPERIMENTAL
toolItemSeparator EXPERIMENTAL
tree

The tree Component shows informations in an arborescent view. It can be compared to the tree found in most modern file explorer. It allows contextual menus ...

The tree Component has the following capabilities :

  • Position & Size
  • Foreground & Background Color
  • Text, font & images
  • Margin & border
  • Help
  • Visibility, Read-Only, Disabled
  • Events Handling
  • Contextual actions in node or tree scope

treeNode A node belonging to a tree.
focusManager

The focusManager Component is a non-visual component.

It allows to deal with the focus on the current page.

service

The service Component is a non-visual component.

It allows to (synchronously or asynchronously) call AJAX services from the client.

The service Component has the following capability :

  • Property changed Event handling

validationParameterNo Description
serverDataNo Description
clientDataNo Description
convertByteRegister a ByteConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
convertShortRegister a ShortConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
convertIntegerRegister a IntegerConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
convertLongRegister a LongConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
convertFloatRegister a FloatConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
convertDoubleRegister a DoubleConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
 


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