Page Comparison

The UI Options component works in conjunction with the UI Enhancer component and the Fluid Skinning System (FSS) to allow users to set personal user interface preferences. The UI Options component provides a user interface for setting and saving personal preferences, and the UI Enhancer component carries out the work of applying those preferences to the user interface.

The settings that are currently supported are:

• themes
• text size
• text and line spacing
• font family
• show/hide background images
• simplified layout
• table of contents
• input and link highlighting

The UI Options interface may be implemented as a dialog (though this is not required). In this case, the implementer should provide a control such as a button or link which activates the dialog. For example, in the UI Options Sakai Integration Demo , the "Edit Appearance" button activates the UI Options dialog.

Implementers are free to provide their own markup for this dialog and a preview of the changes, but Fluid Infusion includes two template files for this interface

• a dialog (UIOptions.html), and
• a preview pane that is included in the dialog (UIOptionsPreview.html).

NOTE: UI Options requires a UI Enhancer to be instantiated on the page before being created.

Subcomponents

UIOptions, like many other components, uses subcomponents for some of its user interface. UI Options uses the Textfield Slider subcomponent as the control for the minimum text size and line spacing controls. fluid:Textfield Slider has its own configuration options described below.

Creation

fluid.uiOptions(componentContainer, options);

Return: The UI Options component object.