1.3.0 20170313

升级指南

一, 资源替换:

  1. (必须) 替换bui.js
  2. (必须) 替换bui.css
  3. (可选) zeptojs 报trigger错问题,去掉了默认的swipe longtap 事件
  4. (可选) bingotouch 纯api版本

二, 重要修改,可能会对已有的项目造成影响的地方:

js 方面

  1. bui.sidebar 的初始化在 bui-page 的父级id , 需要在原本的 bui-sidebar 加上 swiperight 滑动方向.

  2. bui.slide 修改了参数 zoom: false; 不再默认缩放slide的整体比例. 之前如果有用到焦点图的地方,需要修改为 zoom: true; 也可以在配置文件修改.

    1. bui.config.slide.zoom = true;

  3. 使用bui.swipe重写 bui.sidebar,bui.listview 等插件, 如果有用到 bui.sidebar 或者 bui.listview 则需要在想要滑动的方向加上 swipeleft swiperight ;如果用到的这类控件的地方比较多,可以修改配置文件批量修改

    1. 往左边滑动: bui.config.sidebar.swipeleft = ".bui-sidebar";
    2. 往右边滑动: bui.config.sidebar.swiperight = ".bui-sidebar";
    3. 往左边滑动: bui.config.listview.swipeleft = ".bui-listview-menu";
    4. 往右边滑动: bui.config.listview.swiperight = ".bui-listview-menu";

  4. 增加页面及控件的事件监听,具体查看, 控件初始化以后会有 on 方法用来监听事件. BUI 事件演示

  5. 比较重要的方法放在 bui, 不常用方法放在第三级, 例如 bui.platform.isWindow bui.unit.pxToRem 之类的 bui.platform 统一了这类判断控件的调用方式 bui.platform.isWinow() ( 以前是bui.platform().isWindow() )

  6. bui.getPagaparams 1.2.3版本 原生获取不到传参问题

  7. bui.list 跟 bui.listview 的结合,不再需要在 bui.list 的回调里面多次执行 bui.listview ,一个控件只需要初始化一次.

** CSS方面 **

  1. bui-btn 统一了最小高度 .6rem的高度,并且line-height更改为 1

  2. bui-list 列表的样式,单行改为固定高度垂直居中, bui-list 下面的 bui-btn 会变成box 布局, 要注意有没有对自己的列表样式造成影响, 如果有影响,自定义对应的列表名称,把按钮改为 block;

    1. //自定义列表的样式,不要使用 .bui-list .bui-btn {} 会影响到其它控件
    2. .customList .bui-btn { display:block; }

  3. dialog 的头部底部,采用固定最小高度的方式,单行.6rem, 如果对你的造成影响,可以这样修改.

    1. // 自定义对话框的样式, 不要 .bui-dialog .bui-dialog-head
    2. .custom-dialog .bui-dialog-head { line-height:inherit; min-height:inherit; }

  4. bui.checkVersion 检测版本更新的方法做过修改,需要传当前版本号进行比对

优化-修复-完善

** 3.1 原生相关**

bui原生方法结构重整,方便扩展第三方平台

bui.download

bui.download 如果文件地址没有文件名,会存在文件被替换的情况, 新增 fileName 参数,可以自定义下载文件的名字

bui.ajax

bui.ajax 新增全局配置

** 3.2 滑动交互类**

bui.swipe 新增

bui.swipe 控件,支持更复杂的滑动交互,支持上下左右滑动,支持自定义滑动距离

bui.slide

bui.slide 在魅族浏览器滑动一次以后不灵敏的问题 bui.slide zoom 参数的缩放问题

bui.listview

bui.listview 自定义渲染打开再关闭会有条蓝边 bui.listview 只有最后一个有遮罩的问题. bui.listview 的滑动重构,支持左右两边都有侧滑栏 bui.listview 新增 open close active 等方法,支持自定义滑动距离

bui.sidebar的滑动重构

bui.sidebar 只能滑动打开,不能滑动关闭的问题 bui.sidebar 的滑动重构,支持左右两边都有侧滑栏,支持自定义滑动距离

** 3.3 数据交互类**

bui.btn

bui.btn 一个页面只需要初始化一个 bui.btn 的绑定操作就可以了. bui.btn 新增disabled属性跟disabled样式的判断 bui.btn 新增 replace 替换当前窗口参数,解决 登录提交->成功->后退 又回到登录页面问题 bui.btn 新增 timeout 参数,定时关闭, 默认3000秒,主要因为在原生下一个页面,会导致页面返回还看到进度条

bui.load

bui.load 新增 replace 替换当前窗口参数,解决 登录提交->成功->后退 又回到登录页面问题

bui.list 页面跳转

bui.list 修改 onRefresh, onLoad 参数回调的第2个参数为 请求得到的对象(之前是数组) bui.list 支持 vuejs, artTemplate, baiduTemplate 等第三方模板操作并提供示例. bui.list 支持自定义参数 刷新是增加数据,还是覆盖数据 bui.list 下拉刷新高度不足以后不会自动请求下一页 bui.list 支持手动初始化 bui.list 修改跟 bui.scroll children handle 保持一致的调用 bui.list bui.scroll 小于最小高度又没有数据的情况下会一直请求. bui.list 跟 bui.listview 配合使用导致页面宽度计算不准确问题. bui.list bui.listview bui.sidebar bui.btn 等几个控件一起使用的复杂场景问题 bui.list 的刷新方法数据为空的时候,不执行

bui.scroll

bui.scroll 新增 isRefresh 方法, 获取当前执行的是刷新操作还是加载操作. bui.list bui.scroll 小于最小高度又没有数据的情况下会一直请求. bui.pullrefresh,bui.list,bui.scroll 的下拉刷新优化

bui.searchbar

bui.searchbar 的示例页面拿不到数据 bui.searchbar 修复 search 方法不能触发

bui.accordion

bui.accordion 扩展性更强,详情可以参考 bui.accordion_article.html 示例

** 3.4 弹出交互类**

bui.pickerdate

bui.pickerdate 简化参数, 可以不传 value min max bui.pickerdate 支持按钮取消及确定再进行设置 bui.pickerdate 的格式导致ios报错问题 bui.pickerdate 日期统一从0开始

bui.mask

bui.mask 增加了zIndex 参数设置, 默认 100, 跟 dropdown结合的时候,有可能需要设置层级 低于10. bui.mask 修复2个弹窗以后,关闭弹窗会导致有一个没有遮罩

bui.loading

bui.loading 新增 pause 暂停滚动方法 bui.loading 新增 timeout 参数,定时关闭,这种一般在 页面跳转时使用

bui.dialog

bui.dialog 底部按钮样式问题及自定义的dialog高度问题

bui.confirm

bui.confirm 新增几种弹出成功失败提醒示例 bui.confirm 默认确定按钮高亮

bui.hint

bui.hint 去掉close参数,使用autoClose替代 bui.hint 统一了提醒样式 bui.hint interval 参数改为 timeout

bui.select

bui.select 新增 active 方法,可以激活选中的第几个数据 bui.select 弹出窗口的情况下会导致页面跳到底部,不采用label绑定input的方式 bui.select 数据一多导致超出页面高度,滚动问题.

bui.dropdown

bui.dropdown 新增 active 方法,可以激活指定二级菜单 bui.dropdown 在第2个TAB会导致二级菜单不显示 bui.dropdown 激活高亮显示 bui.dropdown 跟 bui-bar 的各种不同位置使用场景 ui_controls/bui.dropdown_scenes.html

bui.actionsheet

bui.actionsheet 美化