tmui-cli 5.3.1 → 5.3.3

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/241/250/345/215/225/345/255/220/347/273/204/344/273/266 xFormItem.md"

@@ -3,7 +3,7 @@
 ## 介绍
 
 从1.1.2开始允许非xform直接子节点了,也就是在xform可以嵌套view进行form-item布局了,但建议不要嵌套太深,影响性能.
-1.1.17开始支持嵌套对象字段，key必须/分割如'user/id'，sdk不支持以.分割符。
+嵌套对象字段支持 / 和 . 两种写法，如 user/id、user.id，两者等价。
 
 ## 平台兼容
 
@@ -29,8 +29,8 @@
 | ------ | ---- | ---- | ---- |
 | label | `表单名称`<br> | `string` | `""` |
 | showLabel | `是否显示标题`<br> | `boolean` | `true` |
-| field | `校验的字段名称，字段名称一定要存在于form表单数据中。否则报错。`<br> | `string` | `""` |
-| required | `是否是必填项。设置了此值，才会执行校验。`<br> | `boolean` | `false` |
+| field | `校验字段。model 中没有该键时按空值校验。`<br> | `string` | `""` |
+| required | `是否是必填项。为空失败；非必填时空值跳过格式规则，有值仍校验。规则上的 required 同样生效。`<br> | `boolean` | `false` |
 | showRequired | `是否显示校验必填项前面的红*符号`<br> | `boolean` | `true` |
 | rule | `校验规则对象`<br> | `Array` | `() : FORM_RULE[] => [] as FORM_RULE[]` |
 | labelWidth | `标签宽（横向表单时有效），默认空值取父form统一的设置。`<br> | `string` | `""` |
@@ -67,6 +67,7 @@
 | vaildCompele | - | `-` | - |
 | getVaildStatus | - | `-` | - |
 | clearValid | - | `-` | - |
+| setFieldError | - | `-` | - |
 
 
 ## 示例文件路径
@@ -79,7 +80,7 @@
 
 ```vue
 <template>
-		<!-- #ifdef MP-WEIXIN -->
+		<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 		<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
 			<navigation-bar :background-color="xThemeConfigNavBgColor"
 				:front-color="xThemeConfigNavFontColor"></navigation-bar>
@@ -88,8 +89,6 @@
 		<x-sheet>
 			<x-text font-size="18" class=" text-weight-b mb-8">表单 xForm</x-text>
 			<x-text color="#999999">与官方不同的是，它只为数据进行验证，因此不仅仅局限表单组件。而是任意数据进行的验证收集，比官方更灵活，与web组件对齐的校验。</x-text>
-			<x-text color="#999999">为了体验提供了属性：默认如果有字段校验不过，会把页面滚动到当前出错 的位置。</x-text>
-			<x-text color="#999999">1.1.17开始支持嵌套对象字段，key必须/分割如'user/id'</x-text>
 		</x-sheet>
 
 		<x-sheet>
@@ -100,7 +99,7 @@
 					<x-input cursor-color="red" color='transparent' v-model="(reqData.username as string)"
 						align="right"></x-input>
 				</x-form-item>
-				<x-form-item field="testChildrenForm/text" label="嵌套字段" :required="true">
+				<x-form-item field="testChildrenForm.text" label="嵌套字段" :required="true">
 					<x-input cursor-color="red" color='transparent' v-model="(reqData.testChildrenForm.text as string)"
 						align="right"></x-input>
 				</x-form-item>
@@ -122,7 +121,7 @@
 				</x-form-item>
 				<x-form-item label="上传图片" field="upload" :required="true" contentStyle="display:flex;flex-direction:row;justify-content:flex-end">
 					<x-upload-media :max-count="3" align="right" v-model="(reqData.upload as XUPLOADFILE_FILE_VALUE[])" :column="3"
-						style="width: 200px;" img-height="70px"></x-upload-media>
+						style="width: 200px;"></x-upload-media>
 				</x-form-item>
 
 				<x-form-item field="radio" label="选择性别" :required="true">
@@ -147,10 +146,10 @@
 		</x-sheet>
 		<x-sheet>
 			<x-text font-size="18" class=" text-weight-b mb-8">ref方法对上述表单验证</x-text>
-			<view class="flex flex-row ">
-				<x-button class="flex-1 mr-n6" @click="submitByClick">ref验证</x-button>
-				<x-button class="flex-1 mr-n6" @click="clearValid">清除验证</x-button>
-				<x-button class="flex-1" @click="submitref">只验证用户名</x-button>
+			<view class="flex flex-row flex-row-center-between">
+				<x-button style="width: calc(33.33% - 3px);" @click="submitByClick">ref验证</x-button>
+				<x-button style="width: calc(33.33% - 3px);"  @click="clearValid">清除验证</x-button>
+				<x-button style="width: calc(33.33% - 3px);"  @click="submitref">仅用户名</x-button>
 			</view>
 		</x-sheet>
 
@@ -161,12 +160,12 @@
 		<x-sheet>
 			<x-form v-model:modelValid="(isPass as boolean)" :watchValidStatus="true" @submit="(submit as resultTtype)" v-model="(logindata as LOGIN_TYPE)"
 				:label-direction="('vertical' as labelDirType)">
-				<x-form-item :cell-padding="['0','0']" :showBottomBorder="false" :rule="rules.get('username')!" field="user"
+				<x-form-item :cell-padding="['0','0']" :showBottomBorder="false" :rule="rules.username" field="user"
 					label="用户帐号" :required="true">
 					<x-input darkBgColor="" left-icon="account-pin-circle-fill" placeholder="请输入你的帐号"
 						v-model="(logindata.user as string)"></x-input>
 				</x-form-item>
-				<x-form-item :cell-padding="['0','0']" :showBottomBorder="false" :rule="rules.get('password')!" field="pass"
+				<x-form-item :cell-padding="['0','0']" :showBottomBorder="false" :rule="rules.password" field="pass"
 					label="登录密码" :required="true">
 					<x-input darkBgColor="" :password="true" left-icon="lock-password-fill" placeholder="请输入8位密码"
 						v-model="(logindata.pass as string)"></x-input>
@@ -175,15 +174,53 @@
 			</x-form>
 		</x-sheet>
 
+		<x-sheet>
+			<x-text font-size="18" class=" text-weight-b mb-8">JSON 规则</x-text>
+			<x-text color="#999999">邮箱选填，空值通过，有值才校验格式。编码、城市、确认密码只写数据规则，不写函数。动态字段卸掉后不再参与校验。</x-text>
+		</x-sheet>
+		<x-sheet>
+			<x-form ref="dslForm" :rules="dslRules" v-model="(dslData as DSL_TYPE)" @submit="(onDslSubmit as resultTtype)">
+				<x-form-item field="email" label="邮箱(选填)" :required="false">
+					<x-input color="transparent" align="right" placeholder="可空" v-model="(dslData.email as string)"></x-input>
+				</x-form-item>
+				<x-form-item field="code" label="编码" :required="true">
+					<x-input color="transparent" align="right" placeholder="字母或数字" v-model="(dslData.code as string)"></x-input>
+				</x-form-item>
+				<x-form-item field="city" label="城市" :required="true">
+					<x-input color="transparent" align="right" placeholder="北京/上海/深圳" v-model="(dslData.city as string)"></x-input>
+				</x-form-item>
+				<x-form-item field="password" label="密码" :required="true">
+					<x-input color="transparent" :password="true" align="right" v-model="(dslData.password as string)"></x-input>
+				</x-form-item>
+				<x-form-item field="confirm" label="确认密码" :required="true">
+					<x-input color="transparent" :password="true" align="right" v-model="(dslData.confirm as string)"></x-input>
+				</x-form-item>
+				<x-form-item v-if="showExtra" field="extra" label="动态字段" :required="true">
+					<x-input color="transparent" align="right" v-model="(dslData.extra as string)"></x-input>
+				</x-form-item>
+				<view class="flex flex-row flex-row-center-between mt-32">
+					<x-button style="width: calc(50% - 6px);" @click="toggleExtra">动态字段</x-button>
+					<x-button style="width: calc(50% - 6px);" @click="silentValid">静默校验</x-button>
+				</view>
+				<view class="flex flex-row flex-row-center-between mt-12">
+					<x-button style="width: calc(50% - 6px);" @click="markServer">服务端错误</x-button>
+					<x-button style="width: calc(50% - 6px);" @click="clearServer">清除错误</x-button>
+				</view>
+				<x-button form-type="form" class="mt-12" :block="true">提交 JSON 规则</x-button>
+			</x-form>
+		</x-sheet>
+
 		<view style="height: 550px;"></view>
 
 </template>
 
 <script lang="ts" setup>
 	import { ref } from "vue"
-	import type { FORM_RULE,FORM_SUBMIT_RESULT, XUPLOADFILE_FILE_VALUE } from "@/uni_modules/tmx-ui"
+	import type { FORM_RULE, FORM_SUBMIT_RESULT, FORM_VALID_OPTIONS, XUPLOADFILE_FILE_VALUE } from "@/uni_modules/tmx-ui"
 	// @ts-ignore
 	const form = ref<XFormComponentPublicInstance | null>(null)
+	// @ts-ignore
+	const dslForm = ref<XFormComponentPublicInstance | null>(null)
 	type resultTtype = (evt : FORM_SUBMIT_RESULT) => void;
 	type labelDirType = 'vertical' | 'horizontal'
 	type USER_TYPE_CHILDRENFORM = {
@@ -207,8 +244,17 @@
 	}
 	const isPass = ref(false)
 	// RULES可以集中管理，也可以单位分开管理。到form-item rule上或者form中的rules上
-	let rules = new Map<string, FORM_RULE[]>([
-		["username", [
+	type DEMO_FORM_RULES = {
+		username : FORM_RULE[],
+		"testChildrenForm.text" : FORM_RULE[],
+		password : FORM_RULE[],
+		title : FORM_RULE[],
+		price : FORM_RULE[],
+		num : FORM_RULE[],
+		upload : FORM_RULE[],
+	}
+	const rules : DEMO_FORM_RULES = {
+		username: [
 			{
 				type: "string",
 				errorMessage: "姓名填写不正确，不能空，且要小于4个字符",
@@ -218,8 +264,8 @@
 					return pval.length > 0 && pval.length <= 4
 				}
 			}
-		]],
-		["testChildrenForm/text", [
+		],
+		"testChildrenForm.text": [
 			{
 				type: "string",
 				errorMessage: "嵌套字段不能空，且要小于4个字符",
@@ -229,8 +275,8 @@
 					return pval.length > 0 && pval.length <= 4
 				}
 			}
-		]],
-		["password", [
+		],
+		password: [
 			{
 				type: "number",
 				errorMessage: "请输入8位密码",
@@ -239,8 +285,8 @@
 					return pval.length == 8
 				}
 			}
-		]],
-		["title",[
+		],
+		title: [
 			{
 				type: "string",
 				errorMessage: "产品标题不空，且大于5个字符小于12个字符",
@@ -249,31 +295,31 @@
 					return pval.length > 5 && pval.length <= 12
 				}
 			}
-		]],
-		["price",[
+		],
+		price: [
 			{
 				type: "number",
 				errorMessage: "价格不能小于30元",
 				min: 30
 			}
-		]],
-		["num",[
+		],
+		num: [
 			{
 				type: "number",
 				errorMessage: "商品库存在2-200之间",
 				min: 2,
 				max: 100
 			}
-		]],
-		["upload",[
+		],
+		upload: [
 			{
 				type: "array",
 				errorMessage: "请最少选择1张图片最多3张",
 				min: 1,
 				max: 3
-			} as FORM_RULE
-		]]
-	])
+			}
+		]
+	}
 
 	const reqData = ref<USER_TYPE>({
 		username: "",
@@ -319,6 +365,102 @@
 	const clearValid = () => {
 		form.value!.clearValid()
 	}
+
+	const showExtra = ref(false)
+	type DSL_TYPE = {
+		email : string,
+		code : string,
+		city : string,
+		password : string,
+		confirm : string,
+		extra : string
+	}
+	type DSL_RULES = {
+		email : FORM_RULE[],
+		code : FORM_RULE[],
+		city : FORM_RULE[],
+		password : FORM_RULE[],
+		confirm : FORM_RULE[],
+		extra : FORM_RULE[]
+	}
+	const dslData = ref<DSL_TYPE>({
+		email: "",
+		code: "",
+		city: "",
+		password: "",
+		confirm: "",
+		extra: ""
+	})
+	const dslRules : DSL_RULES = {
+		email: [
+			{
+				type: "email",
+				errorMessage: "邮箱格式不正确"
+			}
+		],
+		code: [
+			{
+				required: true,
+				errorMessage: "请填写编码"
+			},
+			{
+				pattern: "^[A-Za-z0-9]+$",
+				errorMessage: "编码只能是字母或数字"
+			}
+		],
+		city: [
+			{
+				required: true,
+				oneOf: ["北京", "上海", "深圳"] as string[],
+				errorMessage: "城市只能是北京、上海、深圳"
+			}
+		],
+		password: [
+			{
+				type: "string",
+				min: 6,
+				max: 16,
+				errorMessage: "密码需要 6-16 位"
+			}
+		],
+		confirm: [
+			{
+				required: true,
+				errorMessage: "请再次输入密码"
+			},
+			{
+				validator: "equalTo",
+				validatorArgs: "password",
+				errorMessage: "两次密码不一致"
+			}
+		],
+		extra: [
+			{
+				type: "string",
+				min: 1,
+				errorMessage: "请填写动态字段"
+			}
+		]
+	}
+	const onDslSubmit = (evt : FORM_SUBMIT_RESULT) => {
+		uni.showToast({ title: evt.valid ? "通过" : evt.errorMessage, icon: "none" })
+	}
+	const toggleExtra = () => {
+		showExtra.value = !showExtra.value
+	}
+	const silentValid = () => {
+		let result = dslForm.value!.valid([] as string[], {
+			showError: true,
+			emitSubmit: false
+		} as FORM_VALID_OPTIONS) as FORM_SUBMIT_RESULT
+		uni.showToast({ title: result.valid ? "静默校验通过" : result.errorMessage, icon: "none" })
+	}
+	const markServer = () => {
+		dslForm.value!.setFieldError("code", "服务端：编码已存在")
+	}
+	const clearServer = () => {
+		dslForm.value!.clearFieldError("code")
+	}
 	
 </script>
 

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/257/204/345/210/206 xRate.md"

@@ -74,7 +74,7 @@
 
 ```vue
 <template>
-	<!-- #ifdef MP-WEIXIN -->
+	<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
 		<navigation-bar :background-color="xThemeConfigNavBgColor" :front-color="xThemeConfigNavFontColor"></navigation-bar>
 	</page-meta>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/272/253/344/273/275/350/257/201/351/224/256/347/233/230 xKeyboardIdcard.md"

@@ -71,7 +71,7 @@
 
 ```vue
 <template>
-	<!-- #ifdef MP-WEIXIN -->
+	<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
 		<navigation-bar :background-color="xThemeConfigNavBgColor" :front-color="xThemeConfigNavFontColor"></navigation-bar>
 	</page-meta>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/275/246/347/211/214/351/224/256/347/233/230 xKeyboardCar.md"

@@ -71,7 +71,7 @@
 
 ```vue
 <template>
-	<!-- #ifdef MP-WEIXIN -->
+	<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
 		<navigation-bar :background-color="xThemeConfigNavBgColor" :front-color="xThemeConfigNavFontColor"></navigation-bar>
 	</page-meta>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/276/223/345/205/245/346/241/206 xInput.md"

@@ -118,7 +118,7 @@
 ```vue
 <template>
 
-	<!-- #ifdef MP-WEIXIN -->
+	<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
 		<navigation-bar :background-color="xThemeConfigNavBgColor"
 			:front-color="xThemeConfigNavFontColor"></navigation-bar>
@@ -130,7 +130,7 @@
 	</x-sheet>
 	<x-sheet>
 		<x-input v-model="content" darkBgColor=""></x-input>
-		<!-- #ifdef MP-WEIXIN -->
+		<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 		<x-text font-size="18" class=" text-weight-b my-8">点击获取微信昵称</x-text>
 		<x-input v-model="content" type="nickname" darkBgColor=""></x-input>
 		<!-- #endif -->

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//350/276/223/345/205/245/346/241/206 xInputNumber.md"

@@ -117,7 +117,7 @@
 
 ```vue
 <template>
-	<!-- #ifdef MP-WEIXIN -->
+	<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
 		<navigation-bar :background-color="xThemeConfigNavBgColor"
 			:front-color="xThemeConfigNavFontColor"></navigation-bar>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//351/200/211/346/213/251/345/231/250 xPicker.md"

@@ -79,7 +79,7 @@
 
 ```vue
 <template>
-	<!-- #ifdef MP-WEIXIN -->
+	<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
 		<navigation-bar :background-color="xThemeConfigNavBgColor" :front-color="xThemeConfigNavFontColor"></navigation-bar>
 	</page-meta>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//350/241/250/345/215/225/347/273/204/344/273/266//351/200/211/346/213/251/345/231/250/345/256/271/345/231/250 xPickerView.md"

@@ -70,7 +70,7 @@
 ```vue
 <template>
 
-	<!-- #ifdef MP-WEIXIN -->
+	<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
 	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
 		<navigation-bar :background-color="xThemeConfigNavBgColor"
 			:front-color="xThemeConfigNavFontColor"></navigation-bar>

package/data/tmui4x/60.AI/350/207/252/345/212/250/345/214/226/06.tokens/350/207/252/347/224/261.md

@@ -0,0 +1,43 @@
+---
+search: false
+---
+
+# Token 词元
+
+## 高阶代理，不烧心，便宜又好用【群主代理点】
+
+::: danger 战略合作伙伴
+
+本代理中转站，便宜，稳定，使用不烧心！！！有问题可联系群主，主打一个能找到人的代理站点。
+
+:::
+
+**Claude,GPT-6,DeepSeek应有尽有，而且非常便宜。**
+
+1. [https://tks-ai.top](https://tks-ai.top)
+
+
+## 省钱我有范，烧心挠脑袋急跺脚
+
+以下是群主为大家了解到的免费模型使用。如果不够使用了，请使用上方高阶代理中充值使用更高级的模型。
+
+
+
+::: warning 提醒
+
+下面的这些免费模型我的评价是：可用，但不好用，能用，但不够聪明。
+
+下面的站点也提供付费使用，但非常贵，请慎重，请考虑上方高阶代理中转站。
+
+:::
+
+1. 请使用OpenAi的产品codex，官方提供永久免费的deepSeek4.1 flash的使用，但速率有限制，同时它是个阉割版的，请着情使用。[官网](https://opencode.ai/)
+2. 使用国际版本的腾讯IDE Agent软件 WorkBuddy ,它里面提供了多个模型的免费使用量也有DeepSeek4.1 flash，当然也是有量和速率的限制。[官网](https://www.workbuddy.ai/)
+3. 使用阿里云的IDE Agent软件Qoder CN，同样提供免费的模型Qwen3.8 Flash，免费截止时间未知，请自行动态了解。[官网](https://qoder.com/zh)
+4. 每天有定量的免费模型提供商：U1S1，见 [官网](https://u1s1app.com/),同样有量和速率限制
+
+
+## 有钱是爷，怎么爽怎么来
+
+土豪们，请直接付费使用Claude,建议不要使用GPT（又慢又烧心，用得非常纠心），建议直接Claude 200 max ,然后走：max fast主打一个快，稳，准，狠，不烧心。
+claude 200 max 的使用，请参考：[官网](https://www.claude.ai/)

package/data/tmui4x-doc-index.json

@@ -1,7 +1,7 @@
 {
-  "updatedAt": "2026-10-09T06:18:23.611Z",
+  "updatedAt": "2026-10-29T14:11:12.569Z",
   "source": "/Volumes/app/myProjects/tmui4xV2/doc/docs",
-  "count": 280,
+  "count": 283,
   "sections": [
     {
       "key": "01.教程",
@@ -16,7 +16,7 @@
     {
       "key": "30.组件库",
       "name": "组件库",
-      "count": 123
+      "count": 125
     },
     {
       "key": "31.原生图表",
@@ -31,7 +31,7 @@
     {
       "key": "60.AI自动化",
       "name": "AI自动化",
-      "count": 5
+      "count": 6
     },
     {
       "key": "70.混合开发",
@@ -1691,6 +1691,19 @@
         "x-text"
       ]
     },
+    {
+      "id": "30.组件库/常用组件/响应式布局 xLayout",
+      "section": "组件库",
+      "sectionKey": "30.组件库",
+      "title": "响应式布局 xLayout",
+      "file": "tmui4x/30.组件库/常用组件/响应式布局 xLayout.md",
+      "aliases": [
+        "响应式布局 xLayout",
+        "响应式布局",
+        "xLayout",
+        "x-layout"
+      ]
+    },
     {
       "id": "30.组件库/导航组件/标签导航 xTabs",
       "section": "组件库",
@@ -2456,16 +2469,29 @@
       ]
     },
     {
-      "id": "30.组件库/展示组件/富文本 xMarkdown",
+      "id": "30.组件库/展示组件/富文本 xHtml",
       "section": "组件库",
       "sectionKey": "30.组件库",
-      "title": "富文本 xMarkdown",
-      "file": "tmui4x/30.组件库/展示组件/富文本 xMarkdown.md",
+      "title": "富文本 xHtml",
+      "file": "tmui4x/30.组件库/展示组件/富文本 xHtml.md",
       "aliases": [
-        "富文本 xMarkdown",
+        "富文本 xHtml",
         "富文本",
-        "xMarkdown",
-        "x-markdown"
+        "xHtml",
+        "x-html"
+      ]
+    },
+    {
+      "id": "30.组件库/展示组件/富文本子组件 xHtmlNode",
+      "section": "组件库",
+      "sectionKey": "30.组件库",
+      "title": "富文本子组件 xHtmlNode",
+      "file": "tmui4x/30.组件库/展示组件/富文本子组件 xHtmlNode.md",
+      "aliases": [
+        "富文本子组件 xHtmlNode",
+        "富文本子组件",
+        "xHtmlNode",
+        "x-html-node"
       ]
     },
     {
@@ -3396,6 +3422,17 @@
         "企业级Agents"
       ]
     },
+    {
+      "id": "60.AI自动化/06.tokens自由",
+      "section": "AI自动化",
+      "sectionKey": "60.AI自动化",
+      "title": "Token 词元",
+      "file": "tmui4x/60.AI自动化/06.tokens自由.md",
+      "aliases": [
+        "06.tokens自由",
+        "tokens自由"
+      ]
+    },
     {
       "id": "70.混合开发/01.关于",
       "section": "混合开发",