新版本1.4.2发布了。第一次升级到 1.4.x 版本请注意在1.4.0版本的重大变动,具体请阅读更新日志

开发者文档

这是js重写的选框组件,兼容ie8+。但是使用此组件必须引入sui.js。此组件内部依然通过原生的checkbox和radio来实现,所以不会影响原生的表单操作。
注意,在使用此组件的时候,如果要通过JS修改状态,最好不要通过直接修改input的方式来操作,而是通过checkbox api来调用。

  • 更新 v1.4.2: 增加了readonly状态。
  • 更新 v1.1.6: 修复了checkbox可能导致页面滚动的bug。

通过data-api使用

在初始化的时候同时设置好input的属性和label的class,否则在js加载之后可能会闪一下或者会出现状态不一致。
半选和未选中的值是一样的,只是样式不同而已。

复选框

单选框

半选

禁用

只读

因为checkbox是不支持readonly状态的,所以通过将label改为span来实现让用户无法操作

只读 只读

              

通过JS调用

复选框


              
  • 要把checkbox当做一个组件来用,最好不要通过js直接修改input的属性,要通过checkbox api来调用。
  • 禁用状态会禁止用户的操作,但是不会禁止通过api来修改状态。
  • 半选状态其实就是未选中,所以不会向后台提交。
方法 说明
check 选中
uncheck 取消选中
halfcheck 半选
disable 禁用
enable 启用