XBL

What is XBL?

XBL stands for eXtensible Bindings Language, which is an XML language that is used for declaring the behavious of XUL widgets. Bindings can be attached to elements using either cascading stylesheets or the document object model. The element that the binding is attached to, called the bound element, acquires the new behavior specified by the binding.

What Does XBL Do?

Basically, XBL is a langauge that describes a set of bindings that can be attached and bound to elements on the screen. When bound, the binding implements new methods and properties to the associated element. In essence, the widgets on the screen are layed out using XUL and then given functionality using XBL.

How does XBL work?

XBL Elements

Bindings

The Bindings element contains many Binding elements.

DTD decleration

<!ELEMENT bindings ( binding* ) > [ where * indicates zero or more of the binding element]

XML representation

<bindings ...>

<binding id="binding1"> <binding> <binding id="binding2"> <binding> </bindings>

Binding

The Binding element describes a single XBL binding and can add (anonymous content, fields, properties, methods and event handlers) to any html or xml element.

<!ENTITY % binding-content "(content?,implementation?,handlers?)">
<!ELEMENT binding %binding-content;>
<!ATTLIST binding
   id                     ID             #REQUIRED
   extends                CDATA          #IMPLIED
   display                CDATA          #IMPLIED
   applyauthorstyles      false          #IMPLIED
   styleexplicitcontent   false          #IMPLIED
>

Resources/Examples

API Reference

The Mozilla Webpage has a list of Tags and examples that document the usage of XBL.

Test Cases

In this example, we can use XUL to define the layout of user interface and then use XBL to change the widgets functionality.

Here is the XUL Code that lays out the widgets:

<?xml version="1.0"?>
<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>
<?xml-stylesheet href="chrome://example/skin/example.css" type="text/css"?>

<window xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
  <box class="okcancelbuttons"/>
</window>

This lays out an interface with the buttons for OK and Cancel. To give these buttons functionality, XBL is used:

<?xml version="1.0"?>
<bindings xmlns="http://www.mozilla.org/xbl" xmlns:xul="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
  <binding id="okcancel">
    <content>
      <xul:button label="OK"/>
      <xul:button label="Cancel"/>
    </content>
  </binding>
</bindings>

Newsgroup

netscape.public.mozilla.xbl