This page explains how to develop Rialto-JSF components.

As any JSF components, Rialto-JSF components are composed of :

• A Java object representing the Rialto component. This object must extend javax.faces.component.UIComponent. For easier implementation, the object can extends UIComponentBase or UIInput. The properties of the Rialto component should match the name of the default JSF component when possible.
• A Java JSP object tag allowing to place the component in the view. This object must extends javax.faces.webapp.UIComponentTag. The tag properties should match the UIComponent it is linked with. To set the properties of the UIComponent, override the method setProperties(UIComponent).
• A Java object specialized for rendering the UIComponent. The renderer generates the Javascript code which creates and updates Rialto Javascript components. As there are two steps involved in a Rialto component (defining the component in Javascript, which is only done once, and updating it), there are 4 rendering methods to implement (defineBegin, defineEnd, updateBegin, updateEnd) instead of the usual 2 generic ones (encodeBegin and encodeEnd).

Editable components must use their “value” property to hold their values.