XBL 除了事件與屬性,也能為元素定義方法。方法會附加在被綁定的元素上,可由腳本呼叫,例如 element.getMaximum(5, 10)。
<implementation>
<method name="getMaximum">
<parameter name="num1"/>
<parameter name="num2"/>
<body>
if (num1 <= num2) return num2;
else return num1;
</body>
</method>
</implementation>
method 的 name 是方法名稱,每個 parameter 對應一個參數,body 則放 JavaScript 程式碼。因為 XBL 常用 JavaScript,參數不需要宣告型別。
XBL 建立的內容通常是匿名的,無法直接用一般 DOM 查詢取得。此時可使用 document.getAnonymousNodes(element),它會回傳匿名子元素陣列。
var nodes = document.getAnonymousNodes(element);
var first = nodes[0];
若綁定內有多個元素,就能依索引取得。例如在 binding 方法內部,可直接傳入 this:
var first = document.getAnonymousNodes(this)[0];
以下範例建立一個帶標題的元件,並用 showTitle 方法切換標題可見性。
<binding id="labeledbutton">
<content>
<xul:label xbl:inherits="value=title"/>
<xul:label xbl:inherits="value"/>
<xul:button label="Show" oncommand="parentNode.showTitle(true);"/>
<xul:button label="Hide" oncommand="parentNode.showTitle(false);"/>
</content>
<implementation>
<method name="showTitle">
<parameter name="state"/>
<body>
if (state)
document.getAnonymousNodes(this)[0].setAttribute("style", "visibility: visible");
else
document.getAnonymousNodes(this)[0].setAttribute("style", "visibility: collapse");
</body>
</method>
</implementation>
</binding>
匿名內容中的按鈕可用 parentNode 取得被綁定的元素,再呼叫該元素上的自訂方法。這是因為自訂屬性與方法屬於綁定所在的元素,而不是匿名內容本身。
若使用 xbl:inherits,也要記得在 XBL 文件宣告 XBL 命名空間。
XBL 支援兩個特殊方法:constructor 與 destructor。建構子在綁定生效時執行,常用於初始化;解構子在綁定解除時執行,常用於保存狀態。
<constructor>
if (this.childNodes[0].getAttribute("open") == "true") {
this.loadChildren();
}
</constructor>
<destructor action="saveMyself(this);"/>
每個綁定最多一個建構子與一個解構子,且兩者都不接受參數。若修改 -moz-binding 造成重新綁定,舊綁定會先解構,新綁定再建構。