# 升级指南

说明

由于之前没有此专题模块，所以之前的版本可能不会有内容写入，使用组件时注意查看组件文档的参数是否发生变化。

本专题不是每次更新版本的时候都会写入内容，只有某些需要特殊留意和处理的版本升级时，才会在这里写入相关的升级指导，如果您想看ThorUI都有哪些升级记录，请查看：更新日志 (opens new window)

# V2.8.0 升级注意事项

# 1、新增全局配置

详见文档全局配置（主色配置以及部分组件属性配置），使用该功能需要将所有组件更新到最新版本。

# 2、tui-list-cell（列表项）组件优化

为了更好的扩展，调整了该组件部分属性，详见文档属性说明，该调整不向下兼容，注意替换后对使用到的属性进行相关调整。

# 3、tui-calendar（日历）组件优化

组件确定按钮调整（移除内部tui-button组件），移除btnType属性，改为 btnBgColor 属性，该调整不向下兼容，注意调整。

# V2.1.0 升级注意事项

# 1、uni-app版 tui-waterfall（瀑布流）组件优化

之前版本中item项循环在组件内部执行，2.1.0版本中将循环提到页面中执行，此处更新不向下兼容，不可直接替换使用，需要重新看文档和示例进行调整（之前版本编译到小程序出现警告，可能导致开发工具卡死，所以做了此调整）。

# 2、tui-tabbar（标签栏）组件优化

新增字体图标配置，内置了tui-icon组件，使用标签栏组件时需要将字体图标组件同时引入项目中，且uni-app中如果不是easycom配置，需要在标签栏组件中手动进行引入图标组件。

# V2.0.0（ThorUI示例V1.5.0）升级注意事项

# 1、uni-app版 tui-index-list（索引列表）组件优化

之前版本中item项循环在组件内部执行，2.0版本中将循环提到页面中执行，此处更新不向下兼容（之前版本vue3下编译到小程序无法渲染数据，所以做了此调整）。

# V1.7.0（ThorUI示例V1.2.0）升级注意事项

# 1、tui-form（表单验证）组件优化

部分平台不支持在props中嵌套传入Function函数，model 和 rules 参数不再推荐由props传入，改为校验方法 validate 中传入。

# 2、uni-app端所有 commonJS 改为 ES6 模块规范

导入模块 ,uni-app端所改变如下（小程序端不变）：

// 之前 - Vue 2, 使用 commonJS
const thorui = require("@/**/xxx.js");

// 之后 - Vue 3， 只支持 ES6 模块
import thorui from "@/**/xxx.js";

# 3、tui-progress（进度条）组件优化

移除 animation 和 activeMode 属性。

# V1.6.5（ThorUI示例V1.1.0）升级注意事项

# 1、组织架构树组件（tui-org-tree）优化

该组件传入的数据结构做了如下调整(id=>value，label=>text)，具体查看文档。

//调整之前
treeData: [{
	id: 1,
	label: '组织架构树',
	children: [{
		id: 101,
		label: '多级数据展示',
		page: '../org-tree_default/org-tree_default',
		children: [{
			id: 10001,
			label: '多级数据展示',
			page: '../org-tree_default/org-tree_default',
			children: []
		}, {
			id: 10002,
			label: '自定义样式',
			page: '../org-tree_style/org-tree_style',
			children: []
		}]
	}, {
		id: 102,
		label: '自定义样式',
		page: '../org-tree_style/org-tree_style',
		children: []
	}]
}]

//调整之后
treeData: [{
	text: '组织架构树',
	value: 1,
	//vertical,horizontal 为空则自适应排列
	align: '',
	children: [{
		text: '多级数据展示',
		value: 101,

		page: '../org-tree_default/org-tree_default',
		children: []
	}, {
		text: '自定义样式',
		value: 102,
		page: '../org-tree_style/org-tree_style',
		children: []
	}]
}]

# V1.6.1升级注意事项

# 1、消息提示组件（tui-tips）优化

该组件去掉了参数 type，使用了自定义背景色，字体颜色以及字体大小进行替代，具体查看文档。

← 注意事项 FAQ →