更新记录

0.7.2-beta.1（2026-02-27） 下载此版本

0.7.2（2026-02-26） 下载此版本

Features

• Calendar: 新增 PopupProps 属性，透传至 Popup @novlan1 (#4264)
• Navbar: 支持监听页面变化，重新计算尺寸 @novlan1 (#4282)

Bug Fixes

• Button: 修复 icon.size 不生效问题 @novlan1 (#4264)
• Form: 修改边距错误问题 @novlan1 (#4282)
• Search: 修复 value 未监听问题 @novlan1 (#4264)

0.7.1（2026-02-04） 下载此版本

Features

• ActionSheet: 为 items 子项的 icon 字段新增 object 类型，支持透传到 TIcon 组件 @novlan1 (#4255)
• Button: 新增 activity-type，entrance-path 和 need-show-entrance 属性 @novlan1 (#4255)
• Icon: 新增 217 个与人工智能、文档、徽标和文件相关的图标 @novlan1 (#4255)
• Search: 为 change 事件新增 trigger 参数，表示触发源 @novlan1 (#4255)

平台兼容性

uni-app(3.6.17)

uni-app x(3.6.17)

其他

TDesign 适配 uniapp 的组件库。

文档

点此查看

预览

扫码查看 ↓

其他平台同样支持，仅因平台审核等原因未能上架预览，不影响组件库正常使用。

安装

NPM 方式

npm i @tdesign/uniapp

UNI_MODULES 方式

已上传 插件 到 DCloud 插件市场，请打开插件详情页并点击使用 HBuilderX 导入插件。

使用

1. 在 main.ts 中引入样式文件

// CLI 模式
import '@tdesign/uniapp/common/style/theme/index.css';

// HBuilderX 模式
// import './uni_modules/tdesign-uniapp/components/common/style/theme/index.css';

也可以引入 rpx 单位的 less 文件，该文件与 tdesign-miniprogram 完全一致。

// CLI 模式
import '@tdesign/uniapp/common/style/theme/index.less';

// HBuilderX 模式
// import './uni_modules/tdesign-uniapp/components/common/style/theme/index.less';

2. 在文件中使用

<template>
  <t-loading />
</template>

<script lang="ts" setup>
import TLoading from '@tdesign/uniapp/loading/loading.vue';
</script>

只提供按需导入方式，不支持全量导入（全量导入在小程序下有兼容性问题）。

自动导入

在 pages.json 配置 easycom，可实现自动导入。

CLI 模式

使用 CLI 模式，即使用 node_modules 下的 @tdesign/uniapp 时，配置如下。

{
  "easycom": {
    "custom": {
      "^t-(.*)": "@tdesign/uniapp/$1/$1.vue"
    }
  }
}

UNI_MODULES 模式

使用 uni_modules 下的 tdesign-uniapp 时，配置如下。

{
  "easycom": {
    "custom": {
      "^t-(.*)": "@/uni_modules/tdesign-uniapp/components/$1/$1.vue"
    }
  }
}

编辑器提示

安装注册 TDesign 之后，在开发项目时，可以配合插件在VSCode等主流编辑器中达到提示组件名及API的效果。

推荐安装 Volar，并在项目的 tsconfig.json 的 includes 属性中增加 node_modules/@tdesign/uniapp/global.d.ts，即可实现该效果。

平台兼容性

浏览器兼容性

Firefox	Chrome	iOS Safari	Samsung	Opera	[]() Android Browser
Firefox >=104	Chrome >=105	iOS Safari >=12.2	Samsung >=10.2	Opera >=64	Android Browser >=105

详情参见移动端组件库浏览器兼容性说明

反馈

有任何问题，建议通过 Github issues 反馈或扫码加入用户微信群。

开源协议

TDesign 遵循 MIT 协议。