FAXL3: Controls

From fringDocumentation

Contents 1 Controls 1.1 Element Controls 1.2 FAXL Syntax 1.3 FAXL compatibility

Controls

Controls is a set of Control elements where a fring Control defines a GUI element in the fring client interface. The default container for Controls is the add-on tab (but they can have a non-default container similar to a Contacts list or a specific Chat tab). Internal Control properties (like visibility or position) can be changed during runtime using the corresponding Actions.

Controls may be declared in various locations in FAXL: within the add-on creation form, Message Feeds or inside Actions. The difference between them depend on whether the default container of a Control inside a Message Feed is the add-on tab for the add-on, as other Controls have no default container. Controls inside the add-on creation form are cached, so when the fring client loads they are immediately visible.

The Control life cycle depends on the following situations:

• Container: When a Control is inside a Chat tab that closes the Control is deleted.
• Add-on: When the user unregisters an add-on, all Controls are deleted.

Element Controls

The following are elements or building blocks comprising a Controls:

Required	Name	Type	Description
Optional/Unbounded	-	Control	An element defining a GUI component.

FAXL Syntax

<Controls>
	<XXXControl>
	</XXXControl>
	<YYYControl>
	</YYYControl>
</Controls>

FAXL compatibility

Supported from FAXL 2.5