更新记录

1.2.8(2026-03-18) 下载此版本

修改tabbar的适配状态栏问题

1.2.6(2026-03-17) 下载此版本

修复了安卓端编译报错问题

1.2.5(2026-03-06) 下载此版本

'新增地址解析组件' '新增地址模板接入地址解析组件' '身份证上传组件更新'

查看更多

平台兼容性

uni-app x(3.96)

Chrome Chrome插件版本 Safari Safari插件版本 Android Android插件版本 iOS iOS插件版本 鸿蒙 微信小程序
+80 1.1.0 +14 1.1.0 5.0 1.1.0 12 1.1.0 - -

其他

多语言 暗黑模式 宽屏模式
×

TX-UI Demo 使用说明

txui 是用于上传到插件市场与在 HBuilderX 中直接运行体验的 TX-UI 示例工程,可用于查看组件效果、交互行为和页面模板示例。

当前版本:1.2.6

本次版本说明:已修复 Android 端部分运行报错问题。

1. 项目说明

  • 技术栈:uni-app x + UTS
  • 组件来源:txui/uni_modules/tx-ui
  • 工程用途:插件市场下载后的可运行示例项目
  • 已测试平台:H5、Web、Android
  • 暂未测试平台:Harmony、iOS

2. 获取方式

可前往 DCloud 插件市场下载项目文件:

  • 插件市场地址:https://ext.dcloud.net.cn/plugin?id=26852

下载后将项目文件导入到 HBuilderX 中即可运行。

3. 环境准备

  • 安装支持 uni-app x 的 HBuilderX
  • 建议使用最新版 HBuilderX,避免编译器版本过旧导致运行异常

说明:当前 txui 目录下通常不需要额外执行 npm install,以 HBuilderX 直接打开运行的方式为主。

4. 项目如何使用

  1. 先前往插件市场下载项目文件
  2. 打开 HBuilderX
  3. 选择“文件 -> 导入 -> 从本地目录导入”
  4. 选择下载并解压后的 txui 项目目录
  5. 等待工程索引完成
  6. 点击顶部菜单 运行,运行到对应客户端

常用运行方式:

  • 运行到浏览器(H5 / Web)
  • 运行到 Android 真机或模拟器

平台声明:

  • H5WebAndroid 端均已测试
  • HarmonyiOS 端暂未测试

5. 目录结构(核心)

txui/
├─ pages/                     # 演示页面
│  ├─ components/             # 组件 Demo(按基础/表单/展示/反馈/导航/业务分类)
│  ├─ templates/              # 模板页面 Demo
│  ├─ tabbar/                 # 底部导航页(组件/API/模板)
│  └─ api/                    # API 详情页
├─ config/
│  ├─ nav.uts                 # 组件导航配置
│  └─ site.uts                # 站点信息配置(名称、描述、文档地址等)
├─ uni_modules/
│  └─ tx-ui/                  # TX-UI 组件库源码
├─ pages.json                 # 路由与 tabBar 配置
├─ manifest.json              # 平台配置
└─ vite.config.js             # Web 开发配置

6. 快速运行说明

  1. 使用 HBuilderX 打开 txui 目录
  2. 等待工程索引完成
  3. 点击顶部菜单 运行,选择目标平台:
    • 运行到浏览器(H5 / Web)
    • 运行到手机或模拟器(Android)

默认 Web 开发端口请以项目内实际配置为准。

7. 如何新增一个组件演示页

  1. 在对应分类下新增页面文件,例如:pages/components/basic/xxx.uvue
  2. pages.json 中注册新页面路由
  3. config/nav.uts 对应分类的 items 中新增导航项
  4. 重新运行项目并验证页面入口是否可见

8. 常见问题

  • 导入后无法运行:优先确认 HBuilderX 版本是否支持 uni-app x
  • 运行后看不到新页面:检查 pages.jsonconfig/nav.uts 是否同时更新
  • Web/H5 启动异常:检查 vite.config.jsmanifest.json 中的相关配置
  • Android 端若仍遇到异常:请优先确认 HBuilderX 版本、基座版本与缓存状态后重新运行
  • 编译异常:优先确认 HBuilderX 版本与 uni-app x 支持情况,再清理并重新运行

9. 相关链接

  • 插件市场:https://ext.dcloud.net.cn/plugin?id=26852
  • 在线文档:http://txui.aypkq.com/#/
  • uni-app x 文档:https://doc.dcloud.net.cn/uni-app-x/

10. 使用声明

  • 如果你在已测试平台(H5WebAndroid)中遇到 Bug,欢迎反馈提出
  • 由于个人精力有限,问题处理与修复时间无法保证,请理解
  • 如果项目需要用于生产环境,请务必结合你的业务场景自行完成完整测试与验收

11. 许可证

MIT License(见 LICENSE

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT License

Copyright (c) 2026 TX-UI

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.