# bi.basic_button

## 一般的button父级,表示一个可以点击的区域,基类[BI.Single](/core/single.md)

## API
##### 基础属性
| 参数    | 说明           | 类型  | 可选值 | 默认值
| :------ |:-------------  | :-----| :----|:----
| stopEvent | 是否阻止事件 |boolean | true,false | false |
| stopPropagation | 是否阻止冒泡 | boolean | true,false| false |
| selected | button的选中状态 | boolean | true,false |false |
| once | 点击一次选中有效,再点无效 | boolean | true,false | false|
| forceSelected | 点击即选中, 选中了就不会被取消,与once的区别是forceSelected不影响事件的触发| boolean | true,false| false|
| forceNotSelected | 无论怎么点击都不会被选中 | boolean| true,false | false|
| disableSelected | 使能选中| boolean | true,false| false|
| shadow | 是否显示阴影 | boolean| true,false| false|
| isShadowShowingOnSelected| 选中状态下是否显示阴影|boolean|  true,false | false|
| trigger | 被选元素要触发的事件 | string | mousedown, mouseup, click, dblclick, lclick | null|
| text | 文本 | string | —| "" |
| handler | 点击事件回调 | function | —| BI.emptyFn |


## 对外方法
| 名称     | 说明                           |  回调参数
| :------ |:-------------                  | :-----
| hover | 触发hover| —|
| dishover | 取消触发hover| —|
| setSelected | 设置选中| b|
| isSelected | 是否被选中| —|
| isOnce | 是否只允许点击一次| —|
| isForceSelected| 判断是否点击即选中| —|
| isForceNotSelected| 判断是否怎么点击都不会被选中|—|
| isDisableSelected| 判断是否不让选中|—|
| setText| 设置文本值|—|
| getText| 获取文本值|—|

## 用于继承的方法
| 名称     | 说明                           |  回调参数
| :------ |:-------------                  | :-----
| beforeClick | 点击事件之前钩子 | —|
| doClick | 点击之后钩子 | — |
| handle | 获取事件作用的对象 | —|


---