# 升级指南

本专题不是每次更新版本的时候都会写入内容,只有某些需要特殊留意和处理的版本升级时,才会在这里写入相关的升级指导,如果您想看看uView近来 都有哪些升级记录,请移步:更新日志

# 1.2.8升级指导(2020-05-22)

本次升级,对Waterfall瀑布流组件进行升级,新增了可以清空和移除瀑布流列表数据的组件内部方法,需要通过ref调用,因为组件内部无法直接修改父组件的数据, 所以需要您手动将原来的flow-list参数改为v-model双向绑定父组件的数据,内部才可以修改父组件的瀑布流数组数据。



# 1.1.9升级指导(2020-05-06)

本次升级,对swipeAction组件进行了修改,可以配置多个按钮,原本通过btn-textbtn-bg-color配置按钮的文字和背景颜色,本次升级,加入options 参数(数组),可以配置多个按钮,详见SwipeAction 滑动操作的基本说明,另外,点击的回调事件中,返回了两个 参数,一个为Props传递的index参数,另一个options按钮参数的索引。



# 1.1.7升级指导(2020-05-05)

本次升级,迎来了uView的一个跨越发展,uView正式支持npm方式安装,借助此方式,您不用每次都下载覆盖升级,仅执行npm update uview-ui即可, 由于uView在npm的包名为uview-ui,引入时需写上import uView from "uview-ui",旧版中下载方式安装时uView的文件夹为uview,为了规范和统一, 在此1.1.7版本后,uView将以前根目录的uview文件夹,改名为uview-ui,其他保持不变。

对此您有两个选择:

  1. uView下载解压后得到uview-ui文件夹,您可以将其改名为uview,从而覆盖原有的同名库(如果这不是您第一次下载的话),这样您无需在pages.jsonmain.jsuni.scssApp.vue做出路径名称的变更(但是我们不推荐这样做)
  2. 如果您是在进行下载方式的升级,删掉(或备份)原来的uview文件夹,将uview-ui文件夹放到根目录,然后根据下载安装方式配置说明对pages.jsonmain.jsuni.scssApp.vue做出细微修改。(推荐此方式,一劳永逸)


# 1.1.4升级指导(2020-04-29)

由于本次更新,加入基础类内置样式,需要作出一些调整(修改两行代码),原因如下:

  1. 内置样式如果放在uni.scss文件中,在微信小程序上,由于编译机制的问题,会同时被打包 到全局样式文件和单独的每个页面样式文件中,可能造成分包、整包变大而无法预览或者发布。故uView对此样式进行了分拆,将基础样式类放到uView库的index.scss中,由于目前uni-app的V3版本不支持在main.js中引入, 故需要在App.vue中引入,不会导致被打包到每个单独的页面样式文件中。
  2. 由于uni-app的机制,对于SCSS的变量,只能在uni.scss中引入才生效,故uView将主题样式变量相关的部分,放到了uView库的theme.scss文件中。

具体操作如下:

  • App.vue首行的位置,增加如下一行import "@/uview-ui/index.scss"

注意:

  1. 必须要将标签加入lang="scss"属性以支持SCSS,否则会出错!
  2. 请将将引入的代码,写在style标签的首行。
<style lang="scss">
	/* 注意要写在第一行,同时给style标签加入lang="scss"属性 */
	@import "@/uview-ui/index.scss";
	
	/* ......其他的样式 */
</style>
  • 在项目根目录的uni.scss中,删除原来的@import '@/uview-ui/theme.scss';一行,改成如下:
// 删除原来的这一行
// @import '@/uview-ui/index.scss';

// 加入这一行
@import '@/uview-ui/theme.scss';