tmui-cli 5.3.1 → 5.3.3

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//345/257/214/346/226/207/346/234/254/345/255/220/347/273/204/344/273/266 xHtmlNode.md"

@@ -0,0 +1,183 @@
+# 富文本子组件 xHtmlNode
+
+## 介绍
+
+x-html 在 Web / 小程序端的递归节点渲染器。只能作为 x-html 的内部子节点使用，不要单独引用或自行挂载。
+App 端不使用本组件：x-html 在 App 走官方 rich-text；本组件仅在 Web / MP-WEIXIN 条件编译分支中由 x-html 引用并渲染。
+负责把 htmlparser2 解析出的节点树递归渲染为 text / image / view，并向上抛出链接、图片点击。
+示例与能力说明见同页 xHtml。
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+|  | ☑ |  |  | ☑️ |  | 4.76+ | 1.1.18 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-html-node/x-html-node.uvue
+```
+
+## 使用
+
+```ts
+<x-html-node></x-html-node>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| node | `当前 HTML 解析节点`<br> | `HtmlNode` | `` |
+| parentStyle | `继承自父级的文本样式`<br> | `TextStyle` | `` |
+| depth | `递归深度，由 x-html 传入，一般从 0 开始`<br> | `number` | `0` |
+| userSelect | `文本是否可选，透传自 x-html`<br> | `boolean` | `true` |
+| space | `连续空格显示方式：ensp / emsp / nbsp，透传自 x-html`<br> | `string` | `''` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| linkclick | `<br><br>` | 链接点击 |
+| imageclick | `<br>` | 图片点击 |
+
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| - | - | - |
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| - | - | - | - |
+
+## 示例文件路径
+
+```json
+/pages/zhanshi/html
+```
+
+## 示例源码
+
+```vue
+<template>
+
+	<!-- #ifdef MP-WEIXIN || MP-ALIPAY -->
+	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
+		<navigation-bar :background-color="xThemeConfigNavBgColor"
+			:front-color="xThemeConfigNavFontColor"></navigation-bar>
+	</page-meta>
+	<!-- #endif -->
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">富文本 HTML xHtml</x-text>
+		<x-text color="#999999">
+			App 端基于官方 rich-text，Web / 小程序走节点渲染；只支持 HTML，不解析 Markdown。
+			App 端使用官方 rich-text 原生渲染；Web/小程序通过条件编译使用 htmlparser2 解析节点，再由 x-html-node 递归渲染，支持链接和图片点击。
+			App 端支持的标签以官方 rich-text 为准，Web/小程序额外支持表格、pre、blockquote、ol 等。
+		</x-text>
+	</x-sheet>
+	<x-sheet>
+		<x-html :value="html" @itemClick="onItemClick"></x-html>
+		<x-button class="mt-20" @click="appendHtml" :block="true">追加一段 HTML</x-button>
+	</x-sheet>
+
+	<!-- #ifdef WEB || MP-WEIXIN || MP-ALIPAY -->
+	<x-sheet>
+		<x-text font-size="16" class="text-weight-b mb-8">Web / 小程序扩展标签</x-text>
+		<x-text color="#999999" class="mb-12">
+			App 端以官方 rich-text 支持范围为准；Web/小程序节点渲染额外支持表格、引用、代码块和有序列表。
+		</x-text>
+		<x-html :value="richHtml" @itemClick="onItemClick"></x-html>
+	</x-sheet>
+	<!-- #endif -->
+
+</template>
+
+<script setup lang="ts">
+	import { ref } from "vue"
+
+	const html = ref<string>(`<h1>富文本 HTML</h1>
+<p style="line-height:1.8;">
+	这是 <strong>加粗</strong>、<i>斜体</i>、<u>下划线</u>、<del>删除线</del> 和
+	<span style="color:#ff6600;">彩色文字</span> 的示例。
+	<br/>第二行还可以放 <big>大号文字</big> 和 <small>小号文字</small>。
+</p>
+<h2>列表</h2>
+<ul>
+	<li>第一项</li>
+	<li>第二项</li>
+	<li>第三项</li>
+</ul>
+<h2>链接和图片</h2>
+<p>
+	<a href="https://xui.tmui.design">点击打开 TMUI 官网</a>
+</p>
+<p>
+	<img src="https://xui.tmui.design/assets/logo-a483vlZl.png" style="width:120px;height:auto;" />
+</p>
+顶层行内混排（没有 p 包裹）：<strong>加粗</strong>、<a href="https://xui.tmui.design">链接</a>和普通文字应该保持在同一行。
+`)
+
+	// #ifdef WEB || MP-WEIXIN || MP-ALIPAY
+	const richHtml = ref<string>(`<h2>表格</h2>
+<table>
+	<caption>组件对照</caption>
+	<thead>
+		<tr><th>组件</th><th>说明</th></tr>
+	</thead>
+	<tbody>
+		<tr><td>x-html</td><td>HTML 渲染入口</td></tr>
+		<tr><td>x-html-node</td><td>内部递归节点渲染器，不单独使用</td></tr>
+	</tbody>
+</table>
+<h2>引用和代码</h2>
+<blockquote>Web / 小程序节点渲染支持 blockquote。</blockquote>
+<pre><code>const html = "&lt;strong&gt;hello&lt;/strong&gt;";
+console.log(html);</code></pre>
+<h2>有序列表</h2>
+<ol start="3">
+	<li>第三项</li>
+	<li>第四项</li>
+</ol>
+`)
+	// #endif
+
+	function onItemClick(detail : Record<string, any>) : void {
+		const href = detail['href'] as string
+		const src = detail['src'] as string
+		let text = ''
+		if (href != null && href != '') {
+			text = href
+		} else if (src != null && src != '') {
+			text = src
+		}
+		if (text == '') return
+		uni.showToast({
+			title: text,
+			icon: 'none'
+		})
+	}
+
+	function appendHtml() : void {
+		html.value = html.value + `<p style="line-height:1.8;">
+	追加的一段 HTML：<strong>动态更新</strong>、<span style="color:#007aff;">蓝色文字</span>。
+</p>`
+	}
+</script>
+
+<style>
+
+</style>
+```
+
+---
+
+## 版权
+
+@2026 tmui4x [https://xui.tmui.design](https://xui.tmui.design)

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/212/230/345/217/240/351/235/242/346/235/277 xCollapse.md"

@@ -62,7 +62,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//345/261/225/347/244/272/347/273/204/344/273/266//346/212/230/345/217/240/351/235/242/346/235/277/345/255/220/347/273/204/344/273/266 xCollapseItem.md"

@@ -77,7 +77,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//345/261/225/347/244/272/347/273/204/344/273/266//346/225/260/345/255/227/347/277/273/346/273/232 xRollingNumber.md"

@@ -85,7 +85,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//345/261/225/347/244/272/347/273/204/344/273/266//346/237/245/347/234/213/346/233/264/345/244/232 xMore.md"

@@ -72,7 +72,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//345/261/225/347/244/272/347/273/204/344/273/266//346/250/252/345/220/221/346/273/232/345/212/250 xScrollx.md"

@@ -68,7 +68,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//345/261/225/347/244/272/347/273/204/344/273/266//346/255/245/351/252/244/346/235/241 xSteps.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>
 	</page-meta>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//346/255/245/351/252/244/346/235/241/345/255/220/347/273/204/344/273/266 xStepsItem.md"

@@ -67,7 +67,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//345/261/225/347/244/272/347/273/204/344/273/266//346/260/264/345/215/260 xWatermark.md"

@@ -61,7 +61,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//345/261/225/347/244/272/347/273/204/344/273/266//347/200/221/345/270/203/346/265/201 xWaterfall.md"

@@ -75,7 +75,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//345/261/225/347/244/272/347/273/204/344/273/266//347/251/272/347/212/266/346/200/201 xEmpty.md"

@@ -72,7 +72,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//345/261/225/347/244/272/347/273/204/344/273/266//350/231/232/346/213/237/345/210/227/350/241/250 xVirtualList.md"

@@ -80,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>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/241/250/346/240/274 xTable.md"

@@ -2,7 +2,7 @@
 
 ## 介绍
 
-列定义用 columns 或 x-table-col。表头与 pin 行钉在滚动区外（top 表头下 / bottom 表底）；冻结列 left 写死，中间列只 translateX；#cell 每行只循环一次。
+列定义用 columns 或 x-table-col。表头与 pin 行钉在滚动区外（top 表头下 / bottom 表底）；冻结列 left 写死，中间列只 translateX；#cell 每行只循环一次。表格自带 1px 外框并按 round 剪圆角，最右一列的右边线和最底一行的下边线都不画，避免和外框凑成双线。行不够填满总高时，表底补一条空行把列线连到下边线。
 
 ## 平台兼容
 
@@ -50,6 +50,7 @@
 | hideHead | ``<br> | `boolean` | `false` |
 | showCheck | ``<br> | `boolean` | `false` |
 | checkValue | ``<br> | `Array` | `() : string[] => [] as string[]` |
+| round | `表格外框的圆角，空值取全局卡片圆角。写 "0" 就是直角`<br> | `string` | `""` |
 
 
 ## Events 事件
@@ -90,7 +91,7 @@
 	<!-- #ifdef APP -->
 	<scroll-view style="flex:1">
 	<!-- #endif -->
-	<!-- #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>
@@ -163,6 +164,14 @@
 		<x-table :list="listMore" :columns="columnsMore" row-key="key" max-height="220px" :refresh="loadMore"></x-table>
 	</x-sheet>
 
+	<x-sheet>
+		<x-text font-size="16" class=" text-weight-b mb-8">外框与圆角</x-text>
+		<x-text color="#999999" class="mb-12">表格自带 1px 外框，四边都是单线。圆角由 round 控制，不写取全局卡片圆角；下面这张写 round="0" 是直角。</x-text>
+	</x-sheet>
+	<x-sheet :padding="['0']">
+		<x-table :list="listGroup" :columns="columnsGroup" row-key="key" round="0"></x-table>
+	</x-sheet>
+
 	<x-modal v-model:show="showEdit">
 		<x-input v-model="editName"></x-input>
 		<x-text class="mt-12" color="#999999">演示用，确认后不写回列表。</x-text>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/241/250/346/240/274/345/210/227 xTableCol.md"

@@ -65,7 +65,7 @@ x-table 的列定义。通过 provide/inject 向父表登记列元数据，不
 	<!-- #ifdef APP -->
 	<scroll-view style="flex:1">
 	<!-- #endif -->
-	<!-- #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>
@@ -138,6 +138,14 @@ x-table 的列定义。通过 provide/inject 向父表登记列元数据，不
 		<x-table :list="listMore" :columns="columnsMore" row-key="key" max-height="220px" :refresh="loadMore"></x-table>
 	</x-sheet>
 
+	<x-sheet>
+		<x-text font-size="16" class=" text-weight-b mb-8">外框与圆角</x-text>
+		<x-text color="#999999" class="mb-12">表格自带 1px 外框，四边都是单线。圆角由 round 控制，不写取全局卡片圆角；下面这张写 round="0" 是直角。</x-text>
+	</x-sheet>
+	<x-sheet :padding="['0']">
+		<x-table :list="listGroup" :columns="columnsGroup" row-key="key" round="0"></x-table>
+	</x-sheet>
+
 	<x-modal v-model:show="showEdit">
 		<x-input v-model="editName"></x-input>
 		<x-text class="mt-12" color="#999999">演示用，确认后不写回列表。</x-text>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/247/222/346/240/207 xBadge.md"

@@ -66,7 +66,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//345/261/225/347/244/272/347/273/204/344/273/266//350/255/246/345/221/212 xAlert.md"

@@ -80,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>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/257/215/344/272/221 xTextCloud.md"

@@ -63,7 +63,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>
@@ -76,13 +76,18 @@
 	<x-sheet>
 		<x-text font-size="16" class=" text-weight-b mb-8">朝向</x-text>
 		<x-radio-button v-model="rotateId" :list="rotateList" font-size="13" height="40" class="mb-12"></x-radio-button>
-		<x-text-cloud :list="words" :rotate="rotateId" height="480rpx"></x-text-cloud>
 	</x-sheet>
+	<view class="mx-n4 mb-n4">
+		<x-text-cloud :list="words" :rotate="rotateId" height="300px"></x-text-cloud>
+	</view>
 	<x-sheet>
 		<x-text font-size="16" class=" text-weight-b mb-8">指定热词颜色</x-text>
 		<x-text color="#999999" class="mb-12">个别词写 color，其余仍走主题派生。</x-text>
-		<x-text-cloud :list="colored" rotate="cross" height="480rpx" color="success"></x-text-cloud>
+
 	</x-sheet>
+	<view class="mx-n4">
+		<x-text-cloud :list="colored" rotate="cross" height="300px" color="success"></x-text-cloud>
+	</view>
 	<view class="py-32"></view>
 
 </template>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/261/225/347/244/272/347/273/204/344/273/266//350/277/233/345/272/246/346/235/241 xProgress.md"

@@ -72,7 +72,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//345/261/225/347/244/272/347/273/204/344/273/266//351/200/232/347/237/245/346/240/217 xNotice.md"

@@ -66,7 +66,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//345/261/225/347/244/272/347/273/204/344/273/266//351/207/221/351/242/235/346/240/205/346/240/274 xMoney.md"

@@ -68,7 +68,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//345/261/225/347/244/272/347/273/204/344/273/266//351/223/276/346/216/245 xLink.md"

@@ -67,7 +67,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//345/261/225/347/244/272/347/273/204/344/273/266//351/252/250/346/236/266/345/261/217 xSkeleton.md"

@@ -62,7 +62,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>