tmui-cli 1.3.0 → 2.0.1

package/data/guides//345/277/253/351/200/237/344/270/212/346/211/213.md

@@ -0,0 +1,191 @@
+---
+title: 快速上手
+---
+
+<script setup>
+import webview from '../components/mobileWebview.vue'
+import headertips from '../components/headertips.vue'
+</script>
+
+<headertips></headertips>
+
+
+##### 开发指南 tmui.design
+
+# 快速上手
+
+
+::: danger 特别提醒
+
+采用全局TypeScript。因此任何vue页面，都将只能使用ts模式编写页面。默认采用CLI安装方式。
+
+:::
+
+::: details 为什么默认使用CLI方式？
+编译方便，代码提示更强。并且可以使用任意你喜欢的工具来写，比如最新的curror ai,trae ai等快速写页面极致方便。
+:::
+
+<webview url="https://tmui.design/h5by32/#/"></webview>
+
+## :point_right:自动tmui-cli方式安装
+一键安装部署并编译运行，只要一条命令，没有其它繁琐的操作啦。<br>
+[tmui-cli](/start/cli.md)
+
+## :point_right:市场HBX安装
+
+下载TMUI3.0组件库
+
+1. 首先下载tmui3.0组件库 [前往下载](https://ext.dcloud.net.cn/plugin?id=8372)
+2. 根据提示点击导入组件到你的项目即可.
+
+## :point_right:CLI SDK升级
+
+打开命令行工具，执行命令```npm view @dcloudio/uni-app```打印当前最新的版本号，找到``` vue3: 版本号在这是一串数字 ```
+复制 ``` 上述版本号 ``` 替换掉根目录中的package.json文件中的版本号。然后执行 ```npm install```升级，安装即可。记得删除packe-lock.json文件。
+
+
+
+基本的CLI目录结构如下：
+
+```
+
+│  index.html
+│  package-lock.json
+│  package.json ---可替换掉里面的版本号，再执行npm install 即可升级
+│  postcss.config.js
+│  tsconfig.json
+│  vite.config.ts
+│  components.d.ts -- 这是自动生成的vscode组件提示文件
+└─src
+    │  App.vue
+    │  main.ts
+    │  manifest.json
+    │  pages.json
+    │  uni.scss
+	  │  hybrid 目录，部分组件需要
+    ├─pages
+    ├─static
+    │
+    └─uni_modules
+      └─tm-ui -- tmui组件目录，如果是hbx可以右键升级或者到市场导入，都会在这里。
+
+```
+
+## :point_right:HBX项目（非cli）
+
+hbx项目，结构如下：
+
+```
+│─App.vue
+│ env.d.ts
+│ main.ts
+│ manifest.json
+│ pages.json
+│ uni.scss
+│ hybrid 目录，部分组件需要
+├─pages
+├─static
+└─uni_modules
+      └─tm-ui -- tmui组件目录，如果是hbx可以右键升级或者到市场导入，都会在这里。
+
+```
+
+
+## :point_right:配置main.ts文件
+
+::: tip 💡提示
+
+如果你的项目已经启用了Pinia，请确保将`app.use(tmui)`写在`app.use(pinia)`后面。
+因为TMUI如果检测到已经启用Pinia，默认会复用实例，否则会创建一个新的Pinia实例。
+
+:::
+
+如下配置即可,或者直接复制如下代码到你的main.ts
+
+```ts {2,3,7,8,11}
+import { createSSRApp } from "vue";
+import * as Pinia from 'pinia';
+import App from "./App.vue";
+import tmUi from "./uni_modules/tm-ui";
+export function createApp() {
+  const app = createSSRApp(App);
+  app.use(Pinia.createPinia());
+  app.use(tmUi);
+  return {
+    app,
+    Pinia
+  };
+}
+
+```
+
+## :point_right:配置APP.vue引入样式
+
+```vue {14-19}
+<script setup lang="ts">
+import { onLaunch, onShow, onHide } from "@dcloudio/uni-app";
+onLaunch(() => {
+  console.log("App Launch");
+});
+onShow(() => {
+  console.log("App Show");
+});
+onHide(() => {
+  console.log("App Hide");
+});
+</script>
+<style >
+/* 图标必须 */
+@import url(@/uni_modules/tm-ui/css/remixicon.min.css);
+/* 自定预处理类，可选 */
+@import url(@/uni_modules/tm-ui/css/tmui.css);
+page {
+  background: #f5f5f5;
+}
+
+</style>
+```
+
+
+## :heavy_check_mark:编译运行项目
+编译运行一个cli项目非常方便。导航至项目根目录，执行命令即可。<br>
+比如我要编译预览H5页面```npm run dev:h5```即可。
+
+::: details cli编译运行到更多平台命令
+```json
+"dev:app": "uni -p app",
+"dev:custom": "uni -p",
+"dev:h5": "uni",
+"dev:h5:ssr": "uni --ssr",
+"dev:mp-alipay": "uni -p mp-alipay",
+"dev:mp-baidu": "uni -p mp-baidu",
+"dev:mp-kuaishou": "uni -p mp-kuaishou",
+"dev:mp-lark": "uni -p mp-lark",
+"dev:mp-qq": "uni -p mp-qq",
+"dev:mp-toutiao": "uni -p mp-toutiao",
+"dev:mp-weixin": "uni -p mp-weixin",
+"dev:quickapp-webview": "uni -p quickapp-webview",
+"dev:quickapp-webview-huawei": "uni -p quickapp-webview-huawei",
+"dev:quickapp-webview-union": "uni -p quickapp-webview-union",
+"build:app": "uni build -p app",
+"build:custom": "uni build -p",
+"build:h5": "uni build",
+"build:h5:ssr": "uni build --ssr",
+"build:mp-alipay": "uni build -p mp-alipay",
+"build:mp-baidu": "uni build -p mp-baidu",
+"build:mp-kuaishou": "uni build -p mp-kuaishou",
+"build:mp-lark": "uni build -p mp-lark",
+"build:mp-qq": "uni build -p mp-qq",
+"build:mp-toutiao": "uni build -p mp-toutiao",
+"build:mp-weixin": "uni build -p mp-weixin",
+"build:quickapp-webview": "uni build -p quickapp-webview",
+"build:quickapp-webview-huawei": "uni build -p quickapp-webview-huawei",
+"build:quickapp-webview-union": "uni build -p quickapp-webview-union"
+```
+:::
+
+HBX运行项目，请在HBX工具菜单找到```运行```菜单，编译预览到你的目标平台即可。
+
+## :interrobang:我有疑问？
+1. 建议或者BUG提交：[提交建议和bug](https://gitee.com/LYTB/tmui-design)
+2. 加微信群:[介绍页面查看微信群码](介绍.md)

package/data/guides//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,155 @@
+---
+title: 关于tmUi3.0的更新日志
+---
+<script setup>
+import webview from '../components/mobileWebview.vue'
+import headertips from '../components/headertips.vue'
+</script>
+
+<headertips></headertips>
+
+##### 开发指南 tmui.design
+
+# TMUI 3.0
+
+### :couplekiss: 更新日志
+
+## 3.2.20（2026-08-12）
+* 启用了Config全局配置，现在可以全局配置一些关键属性及主题
+* 内置了Vuei18n多语言配置，组件增加至8国语言
+* 优化了很多细节
+## 3.2.19（2026-07-03）
+* 修复问题
+## 3.2.18（2026-06-03）
+* 优化重写了部分组件父子间通信逻辑，减少兼容问题
+## 3.2.17（2026-04-25）
+* 大量优化和性能提升，修复部分问题。
+* 添加了skills用于ai页面对3.2的页面生成。/pages/demo下的页面是测试ai生成的页面模板，可以用于你们效果。
+* 修复tmDate
+## 3.2.16（2026-04-02）
+* 大量优化底层函数（使用了Opus4.6 max Fast全方位的极致性能提升）
+* x-pullrefresh适配了pc 鼠标下拉刷新操作。
+* 添加了路由拦截器Router
+* upload-photo,upload-video增加了长按排序功能。
+* 新增了picker-time ，时分秒选择组件
+* 新增了switch-slider左滑菜单组件
+* 修复tm-circle-progress，tm-sign-board在app端失败。
+## 3.2.15（2026-03-23）
+* 修复部分问题。
+* 使用了地表最强Opus4.6 max进行优化性能，类型检查。
+## 3.2.14（2026-03-18）
+* 优化相关组件，以适配可视化设计器，从设计器中导出模板导出可以以直接编译，与设计器基本还原一致。
+* [AI+可视化+协作+模板](https://store.tmui.design/)，努力拥抱ai让产出规划，设计为一体。
+* 通过ai输出的界面会以组件风格产出，杜绝一股ai味，让你的页面就像设计过一样的美观精致。请大家自备好ai密钥访问模板库。
+*
+## 3.2.13（2026-03-07）
+tmui3.2重新上线了模板库；
+请访问：https://store.tmui.design/
+主要特性：
+1、可视化调整和编辑，拖拽组件，针对TMUI3.2特别优化针对
+2、源码导出精准自动SFC-VUE linit检查，css检查，容错修复
+3、解放双手，插入自己的ai可以无限生成组件模板页面，可以让你不需要拖动拖组件搭页面，后台为ai提供了精准知识库：实测使用qwenplus35b,glm-5,minimax2.5等对话生成页面模板基本命中率99%，高效的容错机制应对ai的回复提取。
+4、模板资源，目前可以用ai无限限制的生成模板存储在你的个人模板库内，可以可视货调整，然后作为 你的模板库，后面所有的项目可直接插入复用，让你的效率提升1000%
+5、平台提供预览模式，对于设计完页面后可以分享给客户直接演示应用。
+6、平台提供单个页面导致源码（会自动创建子组件）。也提供按项目整体导出所有页面。还提供了导出所有页面的设计稿图片（供领导，客户审阅（如果需要设计图时非常有用））这会让你的项目非常专业。提供各种可能。
+## 3.2.12（2026-02-26）
+* 优化 slider-menu 增加点击选中项后,如果右侧滚动但还在本节点范围内时再次点击不再触发事件（防止重复触发），并且位置重新定义到节点顶部。并美化了组件。
+* 修复switch组件类型警告。
+## 3.2.11（2026-02-26）
+* 【重磅】首次发布tmui3.2的移动端 vue版本，不依赖uniapp，
+* 更新了文档，增加搜索功能，文档表格文字断行（防止超长影响阅读文档），其它文档优化。
+* 但可以像uniapp那样写rpx,view单位和标签，不会改变你的习惯，
+* 但可以不依赖uniapp。配合tmui4x实现高效的app混合开发。
+* **********
+* tm-image可能值处理触发sdk的lazy在小程序。
+* switch开发，增加回弹动画
+* signboard 增加对pc的支持。
+* 通过ts-check检查消除爆红。
+* 修复modal组件的beforeClose属性不生效。
+* 增加组件tm-float-drawer 浮动面板组件
+* 增加组件tm-pull-refresh 下拉刷新组件
+* 增加组件tm-dropdown-menu下拉菜单组件
+* 增加组件tm-slider-double 双向滑块组件
+* 增加组件tm-slider 单向向滑块组件
+* 优化upload-video，upload-photo默认同步及回显。
+* 优化between-time的start和end，由于很多人在提供起始和结束时，不提供时分秒，导致比较时以默认的时分秒来判断，现在检测如果用户不提供到秒的结束时间时
+* 自动把起始时秒分设置为0，结束的时秒分为59，这样避免时区问题。
+## 3.2.10（2025-12-31）
+* 兼容了鸿蒙APP,cli用户请重新更新cli底座package.json(可在代码仓库下载替换，新用户可直接cli安装新项目)，删除旧的，重新安装依赖（旧的依赖也要先删除）
+* 类型，注释等优化在编译器中清除报红的类型。
+* image组件加了上事件error，load
+* 增加日历组件
+* 增加汽泡菜单组件
+* 增加步骤条组件
+* 增加进度条组件
+* 增加圆环进度条 TmCircleProgress组件
+* 增加签名版 TmSignBoard组件
+* 增加查看更多 TmMore组件
+#
+## 3.2.09（2025-09-01）
+* 修改maring,padding计算规则。
+* [新增] tm-more更多展开和收缩组件
+* [优化] tm-picker新增了插槽数据label，如果使用插槽展示标签时不显示（这是hbx bug需要高版本4.8x才会显示),此时要写全标准格式才会在小程序上显示
+```ts
+<template v-slot:default="{label}">
+///这里放标签用于触发展示
+// {{label}} 是选中的标签字符串
+</template>
+```
+## 3.2.08（2025-08-30）
+* 优化大部分组件性能和显示效果，动效等。
+* tmForm允许嵌套对象进行表单校验。
+* upload相关组件优化相关问题。
+* 新增国际化语言插件，可以直接在任意位置```import {$i18n} from "@/uni_modules/tm-ui"```来使用，具体见文档。组件一些文字也使用了多语言配置。（本语言插件是自写的非vueI18n因此不会与你已有的冲突），相比直接使用vuI18n在app端是使用不了插值的,自定的话更灵活，可以直接插值。
+* 修复表单对null的校验。
+* 修复了upload相关组件可能的问题（不一定会触发）
+* 新增了请求类，可未授权时队列等候自动请求。（针对小程序中wxocde静默登录自动授权处理），可以对接口自动缓存，请直接调用uni.tmRq调用。并且在示例中为你新增了路由示例。
+* modal 添加了beforeClose属性，用于控制在关闭前执行的一些校验（比如嵌套的表单，输入框等的校验操作）
+* tm-between-time 修复，当start和end不在可快捷列表之间时，会选择快捷时间，但实际快捷时间不在起始之间
+* 【新增】tm-tabbar底部导航组件。
+## 3.2.07（2025-07-16）
+* tm-stepperx组件修复可能在深层嵌套时，可能默认值时可能会有错误。
+* 表单校验，兼容更广泛的可能类型不兼容时的处理情况。并增加了些属性，更新了校验时机的处理（已在非常复杂的表单嵌套及主/子表单动态渲染结构中得到验证）
+* tmDate及picker-date,date-view,picker-between修复了某些问题。【请务必升级】
+* tm-stepper增加autoHideBtn属性及示例，自动隐藏减号，同时增加input-style属性
+* 完善组件针对style属性的ts提示，这样可在写对象css时有css全局字典提示，并解决爆红问题，比如tmText属性:_style="{fontSize:16}",时会有css提示。
+* 修复tm-html和navbar组件，如果页面被分享到朋友圈，当用户在朋友圈浏览时会出现错误（注意不是打开仅是朋友圈的内嵌浏览）
+* 修复tm-upload-photo，tm-upload-videou状态不变化，成功后，数据不同步。
+## 3.2.06（2025-04-15）
+* picker-date复制错了
+## 3.2.05（2025-04-14）
+* 修复了一些问题
+* tmNavbar属性删除了scrollTop属性,改为内部实现。
+* 修复弹层类modal,drawer类可能在不同平台上的显示的问题。
+* 修改了input组件样式
+* 增加了tmAvatarGroup头像组件
+* 增加了tmSkeleton加载动画组件
+* 修复tm-tabs如果值为空与0时可能无法判断
+* 修复uploadphoto,uploadvideo可能外部无法清空,可能外部造成内部多次上传,可能内外数据污染.
+* 给各个弹层添加了禁用disabled属性
+* tm-echart添加了点击事件，兼容了pc操作
+* tmDate,tmPickerData,tm-between-time现支持非正常格式了如：YYYY,YYYY-MM,YYYY-MM-DD,YYYY-MM-DD HH,YYYY-MM-DD HH:mm,YYYY-MM-DD HH:mm:ss
+同时提供了属性：formatSyncValue用于格式化同步到vmodel中，默认是不同步的，默认它是返回一个标准的时间戳字符串，这样就不需要vmodel:modal-str来绑定，可以直接提交为你需要的字段格式值。
+## 3.2.04（2024-12-24）
+* 更新优化,修复bug和新增部分组件,
+## 3.2.03（2024-11-21）
+* 更新和新增部分组件,
+## 3.2.02（2024-11-12）
+* 更新部分组件,将会提供设计专用的可视化超级编辑器，适用于有设计经验，远程案例预览，模板保存，多面板设计，多选项同时修改样式，类似即时，xd,sketch等设计软件，敬请期待
+## 3.2.01（2024-10-28）
+* 更新部分组件
+## 3.2.0（2024-10-11）
+* [注意]本版本不向下兼容,可以直接通过市场导入或者在插件目录右键升级到项目中
+* [3.2.x文档链接](https://tmui.design/)
+* 1. 本版本不向下兼容!!!!!
+* 2. 不再兼容nvue平台,请谨慎升级
+* 3. 本版本不是之前的3.1.x版本的升级版本,无法平移过度到本版本
+* 4. 本版本为全新的tmui4.0x版本的小程序版本,风格,标准,细节与其一样,属性也大多相同,但内部是本质的不同.不可以4.0x混用
+* 5. 本版本以webview app + 小程序为准兼容,并且不提供任何原生插件,如果需要原生请使用tmui4.0x来支持我.
+* 6. 本版本一样是免费的,可以自由的使用,商用,任意修改不用担心版权问题.但请保留版权信息.但不得发布为公共的竞品版本,发现立即追究版权.
+* 7. 本版本更新迭代比较慢,力求后续兼容鸿蒙系统及所有小程序,因此会逐步减少组件数量,但会保证组件质量,保留最基本的组件库功能.
+* 8. 如果需要赞助或者捐赠,可以通过官网付款码赞助支持我的开发或者购买tmui4.0x以支持.
+* 发布第一个3.2.0版本为公测版本
+* 如果有遇到问题请提交bug至[Gitee](https://gitee.com/LYTB/tm-vuetify-for-vue3)
+
+	

package/data/guides//350/264/241/347/214/256/350/200/205.md

@@ -0,0 +1,97 @@
+---
+title: 关于tmUi3.0的介绍
+---
+
+<script setup>
+import webview from '../components/mobileWebview.vue'
+import headertips from '../components/headertips.vue'
+</script>
+
+<headertips></headertips>
+
+##### 伟大的贡献人员 tmui.design
+
+# TMUI 3.0
+
+## :couplekiss: 赞助者
+
+**不管金额多少，你的赞助都是有利余项目的开源，以及可待续性的发展。因此```如果可以请赞助我的辛苦付出吧~```**
+以下赞助未统计uni市场数据，以下数据随时更新。<br>
+以下顺序按时间从新到旧排序
+
+---
+
+| 赞助者 | 赞助金额 | 赞助时间 | 赞助方式 |
+| --- | --- | --- | --- |
+|*李 |666.66	|2023.2.7	|微信转帐	|
+|1*x |10		|2023.1.16	|微信转帐	|
+|** |300		|2023.1.15	|微信转帐	|
+|*欣 |30		|2023.1.10	|微信转帐	|
+|6*6 |50		|2023.1.9	|微信转帐	|
+|流* |10		|2022.12.16	|微信红包	|
+|Peng.C |18.8		|2022.12.13	|微信红包	|
+|-* |10		|2022.12.8	|微信转帖	|
+|幸福*猪 |6.66		|2022.12.2	|微信红包	|
+|何*阳 |20		|2022.12.2	|微信红包	|
+|U*D|10		|2022.11.4	|微信转账	|
+|微信1群-幸福的小猪|6.6		|2022.10.24	|微信转账	|
+|*派|1		|2022.10.12	|微信转账	|
+|Ben|35		|2022.9.29	|微信转账	|
+|离旋|18.8		|2022.9.28	|微信转账	|
+|隔壁老王|18.88		|2022.9.27	|微信转账	|
+|T*Y|10		|2022.9.10	|微信转账	|
+|**俊|131.4		|2022.9.8	|支付宝转账	|
+|*O|1		|2022.8.30	|微信转账	|
+|*必	|100		|2022.8.27	|微信转账	|
+|幸福的小猪	|1.13		|2022.8.17	|微信红包	|
+|t*e	|6.6		|2022.8.17	|微信转帐	|
+|*白	|22.22		|2022.8.14	|微信转帐	|
+|**	|30		|2022.8.8	|微信转帐	|
+|**飞	|50		|2022.8.4	|支付宝转帐	|
+|*攀	|25		|2022.8.1	|支付宝转帐	|
+|**天	|20		|2022.7.28	|支付宝转帐	|
+|**武	|10		|2022.7.25	|支付宝转帐	|
+|微信群2群-mark	|18.18		|2022.7.23	|微信红包	|
+|微信群1群-等風来离开	|66		|2022.7.22	|微信转账	|
+|*滚		|20.2		|2022.7.22	|微信转账	|
+|微信群1群-Dliylru		|20		|2022.7.22	|微信转账	|
+|微信群1群-光羽		|66		|2022.7.22	|微信红包	|
+|微信群2群-阿轩		|18.88	|2022.7.22	|微信红包	|
+|微信群2群-6*6		|50		|2022.7.22	|微信转帐	|
+|*滚				|6		|2022.7.12	|微信转帐	|
+|*康				|300	|2022.7.5	|支付宝转帐	|
+|*柴				|6.66	|2022.6.29	|微信转帐	|
+|*像				|18.8	|2022.6.14	|微信转帐	|
+|*风				|10		|2022.6.9	|微信转帐	|
+|Q群-青舟网络		|50		|2022.6.9	|QQ红包		|
+|**民				|30		|2022.5.30	|支付宝转帐	|
+|*北				|18.8	|2022.5.23	|微信转帐	|
+|Q群-努力才幸福		|68		|2022.5.28	|QQ红包		|
+|Q群-__wj潕钶取玳	|2		|2022.1.20	|QQ红包		|
+|Q群-时间记录者		|5		|2021.12.28	|QQ红包		|
+|Q群-青春无悔		|100	|2021.12.21	|QQ红包		|
+|Q群-HAKAN49520		|10		|2021.12.17	|QQ红包		|
+|Q群-孟秋二十二		|5.2	|2021.11.10	|QQ红包		|
+
+
+---
+
+**本UI库离不开以下贡献人员，在此我非常感谢大家的帮助！**
+
+## :couplekiss: 社区积极贡献人者
+
+这里将会列表在开源gitee上积极提出bug和建议者。
+我在统计中。
+
+
+
+## :couplekiss: 贡献人员
+
+排名不分先后，不管是贡献什么都按时间往排序。<br>
+按时更新，以下贡献人员定期更新，```点击图片可以查看各自的主页哦！```
+
+---
+
+[![贡献人员](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f5b1722f-8766-40af-a22a-acc454202a37/ef8a8962-1153-44c9-aee5-6a616996e595.jpg)](https://gitee.com/LYTB/tmui-design/contributors?ref=master)
+
+---