工具栏

简介

工具栏标签（toolBar），用于存放各种控件。当控件的总宽度超过工具栏宽度时，超出的部分将自动显示在右侧下拉菜单中，原工具栏中的竖直分割按钮也将会以水平分割按钮显示。同时，工具栏支持自适应，当窗口大小发生变化时，右侧下拉菜单中的按钮也将会有所不同。工具栏标签的id为必要属性，可以设置其style、tagClass属性，控制其显示样式。

使用方法

2.1 静态框架使用方法仅EAS7.5版本

<wafctrl:toolBar id="toolbar" isShowMore="false"></wafctrl:toolBar>

2.2 JS动态创建 EAS8.0+

var options = {id:"toolbar1",style:"height:50px"};
var dom = waf.createDOM("toolBar", options);
waf.appendDOM(waf("body"), dom);
waf.initComponent("toolBar", options, dom);

2.3 通用DOM创建 EAS8.0+

<div id='toolbar2' style='border:1px solid red;height:35px;'></div>

<!--DOM创建好之后，使用js初始化控件-->
waf("#toolbar2").wafToolBar({isShowMore:false});

2.4 方法&事件使用 EAS7.5+

//调用方法
waf("#id").wafToolBar('method', parameter...);
//eg:获取和设置值
waf("#id").wafToolBar("getValue");
waf("#id").wafToolBar("setValue");
//eg:更改事件
waf("#id").wafToolBar("option","onchange",fn);

属性说明

id String 缺省值: null EAS7.5+

定义工具栏的id

hidden Boolean 缺省值: false EAS7.5+

工具栏是否隐藏

menuClass String 缺省值: null 不可以在运行期改变 EAS7.5+

定义工具栏右侧下拉菜单的样式

style String 缺省值: null EAS7.5+

定义工具栏的样式

tagClass String 缺省值: null EAS7.5+

定义工具栏的样式类，可以添加一个或多个

isShowMore Boolean 缺省值: true 不可以在运行期改变 EAS8.0-

定义是否显示更多控件。当值为false时，多出的控件显示在右侧下拉菜单中，当值为true时，多出的控件折行显示。默认值为true。从8.2开始已不支持

方法说明

option 参数: (property[,value]) 返回值类型: (Object) EAS7.5+

获得或设置数字输入框某属性的值，当value参数存在时，设置控件的property属性值，且无返回值，否则返回控件的property属性值.[参考样例]

参数说明:
- property：必要参数，数字输入框的属性
- value：可选参数，数字输入框的属性值
返回值说明：
- 当前实例化对象

addElement 参数: (obj[,index]) 返回值类型: (无) EAS7.5+

在工具栏第index个位置上添加obj标签，若添加后超出工具栏长度，超出的部分将显示在右侧下拉菜单中，竖直分割按钮将以水平分割按钮显示.[参考样例]

参数说明:
- obj: 必填参数，html标签元素的jquery对象
- index: 可选参数，标签元素所添加的位置，从0开始计数，当该参数不存在时，标签元素将默认添加在工具栏尾部
返回值说明：无

addVSplitbutton 参数: ([index]) 返回值类型: (无) EAS7.5+

在工具栏第index个位置上添加竖直分割按钮，若添加后超出工具栏长度，超出的部分将显示在右侧下拉菜单中，竖直分割按钮将以水平分割按钮显示.[参考样例]

参数说明:
- index：可选参数，标签元素所添加的位置，从0开始计数，当该参数不存在时，竖直分割按钮将添加在工具栏尾部
返回值说明：无

getElement 参数: (index) 返回值类型: (Object) EAS7.5+

获得工具栏上第index个位置上的标签.[参考样例]

参数说明:
- index :必填参数，表示要获得的标签的位置，从0开始计数
返回值说明：工具栏上第index个位置上的标签对象

removeElement 参数: (index) 返回值类型: (无) EAS7.5+

移除工具栏上第index个位置上的标签.[参考样例]

参数说明:
- index: 必填参数，表示要移除的标签的位置，从0开始计数
返回值说明：无

工具栏

简介