Links Controls

The Links Controls subcomponent is used by UI Options to manage the controls for customizing the appearance of links of the page. The options described on this page can be configured through the options of the main UI Options components. Three version of UI Options are available:

Do not use this component directly. The information on this page should be use when customizing one of the three versions.

#Supported Events	`#onUIOptionsRefresh` This event fires whenever the settings have been saved or reset, or when changes are cancelled.
#Options	`listeners` See #Supported Events for information. `selectors` See below
#Selectors	`#inputsLarger` Container for the controls to request enlarged inputs. `#links` Container for the controls to request emphasized links.

Supported Events

back to top

Listeners can be attached to any supported events through a component's listeners option. Values can be a function reference (not a string function name) or an anonymous function definition, as illustrated below:

var myComponent = component.name("#myContainerID", {
    listeners: {
        eventName1: functionName,
        eventName2: function (params) {
            ...
        }
    }
});

For information on the different types of events, see Infusion Event System.

onUIOptionsRefresh

Description	This event fires any time the links settings are saved or reset, or when the user cancels their changes to the interface.
Type	default
Parameters	none
Availability	Infusion 1.4 and later

Options

back to top

The second argument to the creator function is the options argument. This is a JavaScript object containing name/value pairs: The name is the name of the option and the value is the desired setting. Components define their own default values for options, but integrators can override these defaults by providing new values using the options argument. For technical information about how options are merged with defaults, see Options Merging.

Selectors

Description	... See below.

Selectors

back to top

One of the options that can be provided to the component is a set of CSS-based selectors identifying where in the DOM different elements can be found. The value for the option is itself a Javascript object containing name/value pairs:

selectors: {
    selector1Name: "selector 1 string",
    selector2Name: "selector 2 string",
      ...
}

The component defines defaults for these selectors: If you use those defaults in your markup, you do not need to specify the selectors option. If you do choose to override any of the selectors, you can specify your custom selector using this option.

inputsLarger

Description	Container for the controls to request enlarged inputs (by default, a checkbox).
Default	".flc-uiOptions-inputs-larger"
Example	selectors: { inputsLarger: "#inputsLarger" }

links

Description	Container for the controls to request emphasized links (by default, a checkbox).
Default	".flc-uiOptions-links"
Example	selectors: { links: "input.enhanced-links" }