# bi.widget

## 所有控件的超类

## API
##### 基础属性
| 参数    | 说明           | 类型  | 可选值 | 默认值
| :------ |:-------------  | :-----| :----|:----
| root | 是否是根组件 | boolean | true,false | false |
| tagName |  html标签 | string| —| "div" |
| attributes |  属性 | object | —| null |
| data | 数据 | object | — | null |
| disabled | 是否可用 |  boolean |true,false | false |
| invisible | 是否可见 | boolean | true,false | false|
| invalid | 是否有效 | boolean | true,false |false |
| baseCls | 基础class类 | string | —| " "|
| extraCls | 扩展class类,用于继承类中 | string| — | " "|
| cls | class,用于对外调用 | string |— | " "|

## 生命周期函数
| 名称     | 说明                           |  回调参数     
| :------ |:-------------                  | :-----   
| beforeCreate | 组件实例刚被创建 |— |
| created | 组件实例创建完成 | —|
| render | 渲染组件 | — |
| beforeMount | 组件挂载之前| —|
| mounted | 组件挂载 |—|
| update | 组件更新 | —|
| beforeDestroy | 组件销毁前调用| —|
| destroyed | 组件销毁后调用 | —|


## 对外方法
#####(注: fineui2.0引入生命周期后，widget的实现类不需要重写setEnable，setValid等方法，会自动调用子组件的对应方法
#####,一些需要在设置状态后做的额外工作可以通过重写_setXXX来实现)

| 名称     | 说明                           |  回调参数     
| :------ |:-------------                  | :-----   
| isMounted | 判断组件是否挂载| — |
| setWidth | 设置组件宽度 | width |
| setHeight | 设置组件高度 | height |
| setEnable | 设置组件是否可用 | enable |
| setVisible | 设置组件是否可见 | visible |
| setValid | 设置组件是否有效 | valid|
| doBehavior | 行为,如高亮,标红等 | —|
| getWidth | 获取组件宽度 | —|
| getHeight| 获取组件高度| —|
| isValid | 判断是否有效 | —|
| addWidget | 添加组件 | name,widget|
| getWidgetByName | 根据组件名称获取组件| name |
| removeWidget | 移除组件 | nameOrWidget |
| hasWidget | 判断是否有该组件 | name |
| getName | 获取组件名称 | —| 
| setTag | 设置tag | tag |
| getTag | 获取tag | —|
| attr | 设置组件属性 | key,value |
| getText | 获取text值 | —|
| setText | 设置text值 | text|
| getValue | 获取value值 | —|
| setValue| 设置value值| value|
| isEnabled | 是否可用 | —|
| isVisible | 是否可见 | —|
| disable | 设置组件不可用 | —|
| enable | 设置组件可用| —|
| valid | 设置组件有效| —|
| invalid | 设置组件无效 | —|
| invisible | 设置组件不可见 | —|
| visible | 设置组件可见 | —|
| isolate | 类似于destroy,但元素并不会被销毁,只是被挂载起来了 | —|
| empty | 清空组件 | —|
| destroy | 销毁组件| —|



---