RSF Sakai Widgets

Information

The vision of re-usuable, consistent, and flexible user interface components was presented early in the development of Sakai. A large effort resulted in a set of XML tags that extended JSF layouts. The idea was that if everyone used these tags, the user interface would be rendered in a consistent manner for all. While the idea was sound, several problems were encountered along the way:

  1. JSF is not that easy to use and has some serious representation problems.
  2. Creating JSF compoments that implement the tags is not easy and requires special knowledge.
  3. People started using other presentation technologies like JSP, Struts, and even Servlets, none of which leveraged the idea of reusuable UI components.

RSF has a chance to breath new life into the idea of reusable components without the challenges presented by JSF.

This page contains information on the usage of Sakai Widgets in RSF.

Widgets

The following tags come from the JSF tablib for Sakai 2.3
Some relatively up to date information on styles can be found in Sakai Skin

The prefix "SakaiUI" is proposed for classes that implement Sakai widgets and elements to an RSF component tree.

Show Messages

Tag Name

Component Name

Style

Notes

sakai:debug

SakaiUIDebug

alertMessage

 

sakai:instruction_message

SakaiUIInstruction

instruction

 

sakai:messages

 

(didn't find a style)

 

(information)

 

information

 

(success)

 

success

 

View Containers and Boxes

Tag Name

Component Name

Style

Notes

sakai:view

 

 

 

sakai:view_container

 

 

 

sakai:view_content

 

 

 

sakai:view_title

 

 

 

sakai:group_box

 

 

 

sakai:panel_edit

 

 

 

sakai:panel_titled

 

 

 

Tool Bar

Tag Name

Component Name

Style

Notes

sakai:tool_bar

 

 

 

sakai:tool_bar_item

 

 

 

sakai:tool_bar_message

 

 

 

sakai:tool_bar_spacer

 

 

 

Lists

Tag Name

Component Name

Style

Notes

sakai:dynaTable

 

 

 

sakai:flat_list

 

 

 

(side by side)

 

 

 

Documents

Tag Name

Component Name

Style

Notes

sakai:doc_properties

 

 

 

sakai:doc_section

 

 

 

sakai:doc_section_title

 

 

 

sakai:applet

 

 

 

sakai:multiColumn

 

 

 

sakai:anchorReference

 

 

 

sakai:alphaIndex

 

 

 

sakai:stylesheet

 

 

 

(indent}

 

 

 

Forms

Tag Name

Component Name

Style

Notes

sakai:button_bar

 

 

 

sakai:button_bar_item

 

 

 

sakai:input_date

 

 

 

sakai:inputColor

 

 

 

sakai:inputFileUpload

 

 

 

sakai:inputRichText

 

 

 

sakai:rich_text_area

 

 

 

Indicators and Instruments

Tag Name

Component Name

Style

Notes

sakai:progressBar

 

 

 

sakai:timerBar

 

 

 

Other Stuff

These widgets can be moved up to other sections if they seem to be more appropriate.

Tag Name

Component Name

Style

Notes

sakai:contentTypeMap

 

 

 

sakai:courier

 

 

 

sakai:dataLine

 

 

 

sakai:flowState

 

 

 

sakai:hideDivision

 

 

 

sakai:output_date

 

 

 

sakai:pager

 

 

 

sakai:peer_refresh

 

 

 

sakai:popup

 

 

 

sakai:script

 

 

 

sakai:selectCommand

 

 

Â