20210826 DHX 基础常识

参考链接：https://docs.dhtmlx.com/api__dhtmlxtoolbar_onbeforestatechange_event.html

1.onBeforeStateChange

fires before the moment when the state of a two-state button item is changed

boolean onBeforeStateChange(string|number id,boolean state){ ... };

Parameters

id	string|number	id of an item
state	boolean	new state of an item

Returns

boolean

true to allow state changing, false to forbid it

Example

myToolbar.attachEvent("onBeforeStateChange", function(id, state){
    // your code here
});

2.onButtonSelectHide

fires when the list of options of ButtonSelect collapses

void onButtonSelectHide(string|number id){ ... };

Parameters

id

string|number

id of an item

Example

myToolbar.attachEvent("onButtonSelectHide", function(id){
    // your code here
});

3.onButtonSelectShow

fires when the list of options of ButtonSelect expands

void onButtonSelectShow(string|number id){ ... };

Parameters

id

string|number

id of an item

Example

myToolbar.attachEvent("onButtonSelectShow", function(id){
    // your code here
});

4.onClick

fires when the user clicks the left mouse button on a button or a select button items

void onClick(string|number itemId){ ... };

Parameters

itemId

string|number

the id of a button or a select button

Example

myToolbar.attachEvent("onClick", function(id){
    //your code here
});

5.onEnter

fires when the user presses the "Enter" button inside of an input item

void onEnter(string|number id,number value){ ... };

Parameters

id	string|number	the id of an item
value	number	the text that the user types in an input item

Example

myToolbar.attachEvent("onEnter", function(id, value){
    //your code here
});

6.onStateChange

fires when the user changes the state of a two-state button item

void onStateChange(string|number id,boolean state){ ... };

Parameters

id	string|number	id of an item
state	boolean	new state of an item

Example

myToolbar.attachEvent("onStateChange", function(id, state){
    //your code here
});

7.onValueChange

fires when the user changes the value of a slider item

void onValueChange(string|number id,number value){ ... };

Parameters

id	string|number	the id of an item
value	number	a new value of an item

Example

myToolbar.attachEvent("onValueChange", function(id, value){
    //your code here
});

8.onXLE

fires when the data loading is finished and a component or data is rendered

void onXLE(){ ... };

var myComponent = new dhtmlXComponent();
 
myComponent.attachEvent("onXLS", function(){
    // before loading started
    // your code here
});
 
myComponent.attachEvent("onXLE", function(){
    // after loading ended and data rendered (before user's callback)
    // your code here
});
 
function doOnLoad() {
    // callback, optional
    // called after loading ended and data rendered (after onXLE)
};
 
myComponent.load("server/data.json", doOnLoad);
 
// or
myComponent.loadStruct("server/config.json", doOnLoad);

9.onXLS

fires when XML loading started

void onXLS(){ ... };

Example

var myComponent = new dhtmlXComponent();
 
myComponent.attachEvent("onXLS", function(){
    // before loading started
    // your code here
});
 
myComponent.attachEvent("onXLE", function(){
    // after loading ended and data rendered (before user's callback)
    // your code here
});
 
function doOnLoad() {
    // callback, optional
    // called after loading ended and data rendered (after onXLE)
};
 
myComponent.load("server/data.json", doOnLoad);
 
// or
myComponent.loadStruct("server/config.json", doOnLoad);