tmui-cli 2.0.6 → 5.3.2

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/213/226/346/213/275/346/216/222/345/272/217/345/255/220/347/273/204/344/273/266 xDragItem.md"

@@ -90,7 +90,7 @@
 						backgroundColor: bgColor,
 						opacity:index==1?'0.6':'1'
 					}">
-						<x-text>{{index==1?'我被固定在2':`长按${item.getNumber('id')}排序`}}</x-text>
+						<x-text>{{index==1?'我被固定在2':`长按${item['id']}排序`}}</x-text>
 					</view>
 				</x-drag-item>
 			</x-drag>
@@ -108,7 +108,7 @@
 						backgroundColor: bgColor,
 						opacity:index==2?'0.6':'1'
 					}">
-						<x-text>长按{{item.getNumber('id')}}排序</x-text>
+						<x-text>长按{{item['id']}}排序</x-text>
 					</view>
 				</x-drag-item>
 			</x-drag>
@@ -159,33 +159,33 @@
 
 <script setup lang="ts">
 	import { xConfig } from "@/uni_modules/tmx-ui"
-	const list = ref<UTSJSONObject[]>([])
-	const list2 = ref<UTSJSONObject[]>([
-		{ id: 1 } as UTSJSONObject,
-		{ id: 2 } as UTSJSONObject,
-		{ id: 3 } as UTSJSONObject,
-		{ id: 4 } as UTSJSONObject,
-		{ id: 5 } as UTSJSONObject,
-		{ id: 6 } as UTSJSONObject
+	const list = ref<Record<string, any>[]>([])
+	const list2 = ref<Record<string, any>[]>([
+		{ id: 1 } as Record<string, any>,
+		{ id: 2 } as Record<string, any>,
+		{ id: 3 } as Record<string, any>,
+		{ id: 4 } as Record<string, any>,
+		{ id: 5 } as Record<string, any>,
+		{ id: 6 } as Record<string, any>
 	])
-	const list3 = ref<UTSJSONObject[]>([
-		{ id: 1 } as UTSJSONObject,
-		{ id: 2 } as UTSJSONObject,
-		{ id: 3 } as UTSJSONObject,
-		{ id: 4 } as UTSJSONObject,
-		{ id: 5 } as UTSJSONObject,
-		{ id: 6 } as UTSJSONObject,
-		{ id: 7 } as UTSJSONObject,
-		{ id: 8 } as UTSJSONObject,
-		{ id: 9 } as UTSJSONObject
+	const list3 = ref<Record<string, any>[]>([
+		{ id: 1 } as Record<string, any>,
+		{ id: 2 } as Record<string, any>,
+		{ id: 3 } as Record<string, any>,
+		{ id: 4 } as Record<string, any>,
+		{ id: 5 } as Record<string, any>,
+		{ id: 6 } as Record<string, any>,
+		{ id: 7 } as Record<string, any>,
+		{ id: 8 } as Record<string, any>,
+		{ id: 9 } as Record<string, any>
 	])
-	const list4 = ref<UTSJSONObject[]>([
-		{ id: 1 } as UTSJSONObject,
-		{ id: 2 } as UTSJSONObject,
-		{ id: 3 } as UTSJSONObject,
-		{ id: 4 } as UTSJSONObject,
-		{ id: 5 } as UTSJSONObject,
-		{ id: 6 } as UTSJSONObject
+	const list4 = ref<Record<string, any>[]>([
+		{ id: 1 } as Record<string, any>,
+		{ id: 2 } as Record<string, any>,
+		{ id: 3 } as Record<string, any>,
+		{ id: 4 } as Record<string, any>,
+		{ id: 5 } as Record<string, any>,
+		{ id: 6 } as Record<string, any>
 	])
 	let tid = 0
 	let nowPageScrollY = ref(0)
@@ -198,13 +198,13 @@
 	onReady(() => {
 		tid = setTimeout(function () {
 			list.value = [
-				{ id: 1 } as UTSJSONObject,
-				{ id: 2 } as UTSJSONObject,
-				{ id: 3 } as UTSJSONObject,
-				{ id: 4 } as UTSJSONObject,
-				{ id: 5 } as UTSJSONObject,
-				{ id: 6 } as UTSJSONObject
-			] as UTSJSONObject[]
+				{ id: 1 } as Record<string, any>,
+				{ id: 2 } as Record<string, any>,
+				{ id: 3 } as Record<string, any>,
+				{ id: 4 } as Record<string, any>,
+				{ id: 5 } as Record<string, any>,
+				{ id: 6 } as Record<string, any>
+			] as Record<string, any>[]
 		}, 500);
 	})
 	onUnload(() => {
@@ -234,7 +234,7 @@
 	function onclick(index : number) {
 		uni.showToast({ title: `点击了:${index}`, icon: 'none' })
 	}
-	function onchange(list : UTSJSONObject[]) {
+	function onchange(list : Record<string, any>[]) {
 		console.warn("变动的数据：", list)
 	}
 	

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/265/256/347/220/203 xFloatButton.md"

@@ -123,7 +123,7 @@
 
 </template>
 
-<script setup>
+<script setup lang="ts">
 	const offsets = ref<number[]>([])
 	const onclik = () => {
 		console.log('click')

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/266/210/346/201/257/346/235/241 xSnackbar.md"

@@ -87,7 +87,7 @@
 		</x-sheet>
 </template>
 
-<script lang="uts" setup>
+<script lang="ts" setup>
 	import type { SNACKBAR_INFO } from '@/uni_modules/tmx-ui';
 	const content = ref<SNACKBAR_INFO>({
 		id: -1,//-1表示 不显示。

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/217/215/351/246/210/347/273/204/344/273/266//346/266/210/346/201/257/346/235/241/345/255/220/350/212/202/347/202/271 xSnackbarItem.md"

@@ -85,7 +85,7 @@ xSnackbar内部子组件，不可引用。
 		</x-sheet>
 </template>
 
-<script lang="uts" setup>
+<script lang="ts" setup>
 	import type { SNACKBAR_INFO } from '@/uni_modules/tmx-ui';
 	const content = ref<SNACKBAR_INFO>({
 		id: -1,//-1表示 不显示。

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//344/276/247/350/276/271/350/217/234/345/215/225 xSliderMenu.md"

@@ -44,7 +44,7 @@
 | showToggleMenu | `是否允许侧边菜单收起和打开(会在菜单顶部出现一个收缩按钮)`<br>`这里需要你的菜单项中提供icon图标,不然收起后左侧就取项目的第一个字符.`<br> | `boolean` | `false` |
 | menuPosition | `菜单位置,left或者right`<br>`默认在左侧,不可以动态更改.`<br> | `string` | `"left"` |
 | itemHeight | `左侧菜单项目的高,默认44,不能为百分比,auto这种`<br>`只能是如:'44','44px','88rpx'`<br> | `string` | `"44"` |
-| itemSelectedStyle | `左侧菜单项目被选中时的style样式对象,可以覆盖默认的样式-`<br>`改成自己的设计稿样式.`<br> | `UTSJSONObject` | `() : UTSJSONObject => ({} as UTSJSONObject)` |
+| itemSelectedStyle | `左侧菜单项目被选中时的style样式对象,可以覆盖默认的样式-`<br>`改成自己的设计稿样式.`<br> | `Record` | `() : Record<string, any> => ({} as Record<string, any>)` |
 | layoutMode | `右侧布局模式,=scroll时,右侧为动态循环的scroll-view,item插槽`<br>`上方的插槽数据启用,你需要自己在循环内布局内容.如果为default默认就是之前的`<br>`模式右侧就是一个空view,内容需要自己写滚动.`<br>`default,scroll`<br> | `string` | `"default"` |
 
 
@@ -112,10 +112,10 @@
 </template>
 
 <script setup lang="ts">
-	import { SLIDER_TREE_ITEM_INFO } from "@/uni_modules/tmx-ui/interface.uts"
+	import { SLIDER_TREE_ITEM_INFO } from "@/uni_modules/tmx-ui/interface"
 	import { xConfig, xDate } from "@/uni_modules/tmx-ui"
 	const modelvalue = ref("1-3-1")
-	const itemStyle = ref(xConfig.dark == 'dark' ? ({ backgroundColor: '#181a1b', border: 'none' } as UTSJSONObject) : ({ backgroundColor: '#ccd8e6', border: 'none' } as UTSJSONObject))
+	const itemStyle = ref(xConfig.dark == 'dark' ? ({ backgroundColor: '#181a1b', border: 'none' } as Record<string, any>) : ({ backgroundColor: '#ccd8e6', border: 'none' } as Record<string, any>))
 	const list = ref<SLIDER_TREE_ITEM_INFO[]>([
 		{ title: '江西省1', id: "1-2-1", icon: 'cloud-fill' } as SLIDER_TREE_ITEM_INFO,
 		{ title: '安徽2', id: "1-3-1", icon: 'archive-2-fill' } as SLIDER_TREE_ITEM_INFO,

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/256/253/346/240/274 xGrid.md"

@@ -144,7 +144,7 @@
 
 </template>
 
-<script lang="uts" setup>
+<script lang="ts" setup>
 
 </script>
 

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/256/253/346/240/274/345/255/220/347/273/204/344/273/266 xGridItem.md"

@@ -140,7 +140,7 @@
 
 </template>
 
-<script lang="uts" setup>
+<script lang="ts" setup>
 
 </script>
 

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/272/225/351/203/250/345/257/274/350/210/252 xTabbar.md"

@@ -238,7 +238,7 @@
 
 <script setup lang="ts">
 	import { ref, computed, onBeforeMount } from 'vue'
-	import { TABBAR_ITEM_INFO,NAVIGATE_TYPE,TABBAR_ITEM } from "@/uni_modules/tmx-ui/interface.uts"
+	import { TABBAR_ITEM_INFO,NAVIGATE_TYPE,TABBAR_ITEM } from "@/uni_modules/tmx-ui/interface"
 	import { xConfig,xTabbarConfig } from "@/uni_modules/tmx-ui"
 	
 	const autoTabbarHeight = ref(0)

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/274/225/345/257/274 xGuid.md"

@@ -2,10 +2,11 @@
 
 ## 介绍
 
-内部只可放置x-guid-item。在app上根节点必须是scroll-view或者list-view等可滚动的页面使用。
-还要设置容器:scroll-with-animation="false"禁止滚去动画。
-且你的元素唯一id必须是容器的直接子节点，否则会无效(安卓会无效，为了所有平台有效，必须是容器的直接第一级子节点)。
-您可以参考我的dmeo页面使用，严格按照demo使用！！！
+内部只可放置x-guid-item，遮罩与提示卡由当前激活的x-guid-item自己渲染。
+目标元素必须有页面内唯一的id、可见、且不被隐藏（不可以封装在会裁切的容器里）。
+蒸汽模式（HBuilderX 5.12+）各端页面默认可滚动，组件会自动把目标滚进可视区；
+若页面在pages.json里配置了disableScroll:true（自定义导航栏/tabbar页面官方推荐），页面不可滚动，
+自动滚动会失败并告警，此时请自行保证目标元素在可视区内，或者设置autoScroll=false。
 
 ## 平台兼容
 
@@ -29,9 +30,17 @@
 
 | 名称 | 说明 | 类型 | 默认值 |
 | ------ | ---- | ---- | ---- |
-| maskColor | ``<br> | `string` | `'rgba(0,0,0,0.4)'` |
+| maskColor | `遮罩颜色`<br> | `string` | `'rgba(0,0,0,0.4)'` |
 | activeId | `如果要双向绑定请使用v-model:active-id,您在子组件上定义的target-id属性，且是唯一的`<br> | `string` | `''` |
-| defaultActiveId | ``<br> | `string` | `''` |
+| defaultActiveId | `初始默认选中的id，为空不自动开始引导`<br> | `string` | `''` |
+| zIndex | `遮罩与提示卡的层级，页面里有更高的固定层（底栏等）时可调大`<br> | `number` | `50` |
+| holePadding | `挖洞区域在目标矩形基础上向外扩的边距（px），目标贴边时更好看`<br> | `number` | `0` |
+| holeRadius | `高亮环圆角（px）；四块矩形遮罩做不出圆角洞，圆角由环呈现，建议ringWidth >= holeRadius x 0.3`<br> | `number` | `0` |
+| ringColor | `高亮环颜色，为空不显示环`<br> | `string` | `''` |
+| ringWidth | `高亮环粗细（px）`<br> | `number` | `2` |
+| duration | `切换步骤时遮罩与提示卡的淡入时长（ms），0为不淡入`<br> | `number` | `250` |
+| autoScroll | `目标不在可视区时，是否自动滚动页面到目标处`<br> | `boolean` | `true` |
+| scrollOffset | `透传给uni.pageScrollTo的offsetTop，用于自定义导航栏留白；`<br> | `number` | `0` |
 
 
 ## Events 事件
@@ -75,8 +84,11 @@
 	<!-- #endif -->
 	<x-sheet>
 		<x-text font-size="18" class="text-weight-b mb-8">引导 xGuid {{activeId}}</x-text>
-		<x-text color="#999999">引导组件，需要定位聚焦的元素必须在页面上不可以在子组件中或者隐藏中，并且必须要设定唯一id标识。</x-text>
+		<x-text color="#999999">引导组件，需要定位聚焦的元素必须在页面上不可以在子组件中或者隐藏中，并且必须要设定唯一id标识。蒸汽模式各端页面默认可滚动，目标不在可视区时组件会自动滚过去；页面若在pages.json里配置了disableScroll:true（自定义导航栏/tabbar），自动滚动会失败并告警，此时请自行保证目标可见或设置autoScroll=false。</x-text>
 	</x-sheet>
+	<view class="pa-12">
+		<x-button color="primary" :block="true" @click="onStart">重新开始引导</x-button>
+	</view>
 	<view style="height:50px"></view>
 	<view id="testId1" class="mx-16 mb-16 pa-16">
 		<x-text font-size="18" class="text-weight-b mb-8">节点1 testId1</x-text>
@@ -103,20 +115,29 @@
 		<x-text font-size="18" class="text-weight-b mb-8">节点4 testId4</x-text>
 		<view class="flex flex-row flex-row-center-end">
 			<view>
-				<x-text color="#999999">testId4</x-text>
+				<x-text color="#999999">testId4（在屏幕外，验证自动滚动定位）</x-text>
 			</view>
 		</view>
 	</view>
 	<view style="height:200px"></view>
-	<x-guid v-model:activeId="activeId" defaultActiveId="testId1">
+	<!--
+	hole-padding：挖洞在目标基础上外扩，目标贴边时更好看
+	ring-color / ring-width / hole-radius：高亮环，四块矩形遮罩做不出圆角洞，圆角由环呈现
+	z-index：遮罩与提示卡的层级，页面有更高的固定层（底栏等）时可调大
+	-->
+	<x-guid v-model:activeId="activeId" defaultActiveId="testId1" :hole-padding="6" ring-color="primary"
+		:ring-width="3" :hole-radius="8">
 		<x-guid-item v-for="(item,index) in 4" :key="item" :order="index" :targetId="`testId${item}`"
 			:title="`标题${item}`" :content="`testId${item}`"></x-guid-item>
 	</x-guid>
 </template>
 
 <script lang="ts" setup>
-	const activeId = ref('')
+	const activeId = ref('')
 	
+	const onStart = () => {
+		activeId.value = 'testId1'
+	}
 </script>
 
 <style lang="scss">

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/274/225/345/257/274/345/255/220/347/273/204/344/273/266 xGuidItem.md"

@@ -2,7 +2,7 @@
 
 ## 介绍
 
-内部只可放置在x-guid内。
+内部只可放置在x-guid内，遮罩、高亮环、提示卡都由它自己渲染。
 
 ## 平台兼容
 
@@ -30,6 +30,15 @@
 | order | `必填；顺序索引，一般循环的index即可。`<br> | `number` | `0` |
 | title | `标题`<br> | `string` | `""` |
 | content | `内容描述`<br> | `string` | `""` |
+| bgColor | `提示卡的背景色`<br> | `string` | `"#000000"` |
+| darkBgColor | `提示卡的暗黑背景色，为空取bgColor`<br> | `string` | `""` |
+| color | `提示卡的文字色`<br> | `string` | `"#ffffff"` |
+| round | `提示卡圆角（px）`<br> | `number` | `12` |
+| maxWidth | `提示卡宽度（px）；超过视口可用宽度时自动收窄`<br> | `number` | `350` |
+| titleSize | `标题字号（px）`<br> | `number` | `18` |
+| contentSize | `内容描述字号（px）`<br> | `number` | `14` |
+| gap | `提示卡与挖洞的间距（px）`<br> | `number` | `12` |
+| edge | `提示卡与屏幕边缘、挖洞的最小间距（px）`<br> | `number` | `12` |
 
 
 ## Events 事件
@@ -70,8 +79,11 @@
 	<!-- #endif -->
 	<x-sheet>
 		<x-text font-size="18" class="text-weight-b mb-8">引导 xGuid {{activeId}}</x-text>
-		<x-text color="#999999">引导组件，需要定位聚焦的元素必须在页面上不可以在子组件中或者隐藏中，并且必须要设定唯一id标识。</x-text>
+		<x-text color="#999999">引导组件，需要定位聚焦的元素必须在页面上不可以在子组件中或者隐藏中，并且必须要设定唯一id标识。蒸汽模式各端页面默认可滚动，目标不在可视区时组件会自动滚过去；页面若在pages.json里配置了disableScroll:true（自定义导航栏/tabbar），自动滚动会失败并告警，此时请自行保证目标可见或设置autoScroll=false。</x-text>
 	</x-sheet>
+	<view class="pa-12">
+		<x-button color="primary" :block="true" @click="onStart">重新开始引导</x-button>
+	</view>
 	<view style="height:50px"></view>
 	<view id="testId1" class="mx-16 mb-16 pa-16">
 		<x-text font-size="18" class="text-weight-b mb-8">节点1 testId1</x-text>
@@ -98,20 +110,29 @@
 		<x-text font-size="18" class="text-weight-b mb-8">节点4 testId4</x-text>
 		<view class="flex flex-row flex-row-center-end">
 			<view>
-				<x-text color="#999999">testId4</x-text>
+				<x-text color="#999999">testId4（在屏幕外，验证自动滚动定位）</x-text>
 			</view>
 		</view>
 	</view>
 	<view style="height:200px"></view>
-	<x-guid v-model:activeId="activeId" defaultActiveId="testId1">
+	<!--
+	hole-padding：挖洞在目标基础上外扩，目标贴边时更好看
+	ring-color / ring-width / hole-radius：高亮环，四块矩形遮罩做不出圆角洞，圆角由环呈现
+	z-index：遮罩与提示卡的层级，页面有更高的固定层（底栏等）时可调大
+	-->
+	<x-guid v-model:activeId="activeId" defaultActiveId="testId1" :hole-padding="6" ring-color="primary"
+		:ring-width="3" :hole-radius="8">
 		<x-guid-item v-for="(item,index) in 4" :key="item" :order="index" :targetId="`testId${item}`"
 			:title="`标题${item}`" :content="`testId${item}`"></x-guid-item>
 	</x-guid>
 </template>
 
 <script lang="ts" setup>
-	const activeId = ref('')
+	const activeId = ref('')
 	
+	const onStart = () => {
+		activeId.value = 'testId1'
+	}
 </script>
 
 <style lang="scss">

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//346/227/266/351/227/264/345/221/250 xWeekbar.md"

@@ -138,7 +138,7 @@
 		<view style="height: 50px;"></view>
 </template>
 
-<script setup>
+<script setup lang="ts">
 	import type { xCalendarDateStyleStatusType } from "@/uni_modules/tmx-ui"
 const nowDate = ref("2025-9-24")
 const startDate = ref('2025-9-22')

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//346/240/207/347/255/276/345/257/274/350/210/252 xTabs.md"

@@ -141,7 +141,7 @@
 
 </template>
 
-<script setup>
+<script setup lang="ts">
 	import type { TABS_ITEM_INFO, TABS_ITEM } from "@/uni_modules/tmx-ui"
 	const list = ref<TABS_ITEM_INFO[]>([
 		{ title: "全部" } as TABS_ITEM_INFO,

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//346/240/207/351/242/230/345/257/274/350/210/252 xNavbar.md"

@@ -107,7 +107,7 @@
 		</template>
 	</x-navbar>
 	<view>
-		<x-image src="https://picsum.photos/750/750"></x-image>
+		<x-image height="500px" src="https://picsum.photos/750/750"></x-image>
 	</view>
 
 	<x-sheet :margin="['16']">
@@ -133,7 +133,10 @@
 	const bgcolor = ref<string[]>([])
 	const linear = ref<string[]>([])
 	const staticTransparent = ref(true)
-
+	// #ifdef MP
+	// 微信需要在页面上开启滚动事件。其它平台不需要。
+	onPageScroll(()=>{})
+	// #endif
 	const setbgcolor = () => {
 		bgcolor.value = ['to right', '#ff338f', '#6b3eff']
 		linear.value = ['to right', '#02a7ff', '#22e192']

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//347/262/230/346/200/247/345/270/203/345/261/200 Sticky.md"

@@ -101,7 +101,10 @@
 </template>
 
 <script setup lang="ts">
-
+	// #ifdef MP
+	// 微信需要在页面上开启滚动事件。其它平台不需要。
+	onPageScroll(()=>{})
+	// #endif
 </script>
 
 <style lang="scss">

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//347/264/242/345/274/225 xIndexbar.md"

@@ -3,7 +3,8 @@
 ## 介绍
 
 特别提醒：本组件在1.0.9重构不向下兼容，并且删除了子组件：x-indexbar-item，不再需要子组件。请使用对应的动态插槽来渲染数据。
-内部为 scroll-view 套 list-view 的嵌套滚动：顶部 top 插槽随外层上推，下方按 A/B/C 分组，分类标题在列表中，滑到当前组才吸顶（类似 iOS 通讯录 / 微信联系人）。
+App/Web/鸿蒙端内部为单个 list-view + sticky-section 原生吸顶：顶部 top 插槽随列表上推，下方按 A/B/C 分组，分类标题滑到当前组时原生吸顶（类似 iOS 通讯录 / 微信联系人）；小程序端为单个 scroll-view（using-sticky 吸顶），不用嵌套滚动。
+右侧索引条默认离右边 12px（right 属性可调），安卓端列表会为它让出一条（索引条宽 16px + right，默认 28px），索引条不再压在列表上，列表内容的可用宽度因此比其它端窄 28px；安卓的索引条触摸挂在每个字母上，不依赖矩形换算。
 
 ## 平台兼容
 
@@ -29,10 +30,11 @@
 | ------ | ---- | ---- | ---- |
 | width | `宽`<br> | `string` | `"auto"` |
 | height | `高，%,rpx,px单位均可。`<br> | `string` | `"100%"` |
+| right | `右侧索引条离右边的距离，px,rpx单位均可。`<br> | `string` | `"12"` |
 | dotActiveColor | `侧边指示激活时的文字颜色`<br>`空值是取全局主题值`<br> | `string` | `""` |
 | dotColor | `侧边指示未激活时的文字颜色`<br> | `string` | `"#c0c0c0"` |
 | dotBgColor | `侧边指示的背景颜色`<br> | `string` | `"white"` |
-| list | ``<br> | `UTSJSONObject[]` | `() : UTSJSONObject[] => [] as UTSJSONObject[]` |
+| list | ``<br> | `Record<string, any>[]` | `() : Record<string, any>[] => [] as Record<string, any>[]` |
 | cellHeight | `项目的高`<br>`只能是数字，或者带rpx,px单位`<br> | `string` | `'50'` |
 | titleHeight | `项目的标题高`<br>`只能是数字，或者带rpx,px单位`<br> | `string` | `'32'` |
 | customSliderBar | ``<br> | `Array<string>` | `() : string[] => [] as string[]` |
@@ -48,9 +50,9 @@
 
 | 名称 | 说明 | 数据 |
 | ------ | ---- | ---- |
-| top | `顶部布局，可以自由布局。滚动时会先被外层 scroll-view 上推。` | - |
-| header | `悬浮的菜单头` | title: string<br>title: number<br>index: string<br>index: number<br> |
-| default | `动态插槽` | index: UTSJSONObject<br>index: number<br>index: number<br>currentIndex: UTSJSONObject<br>currentIndex: number<br>currentIndex: number<br>current: UTSJSONObject<br>current: number<br>current: number<br> |
+| top | `顶部布局，可以自由布局。滚动时会随列表上推。` | - |
+| header | `分组标题，滑到当前分类时吸顶` | title: string<br>title: number<br>index: string<br>index: number<br> |
+| default | `动态插槽` | index: Record<string, any><br>index: number<br>index: number<br>currentIndex: Record<string, any><br>currentIndex: number<br>currentIndex: number<br>current: Record<string, any><br>current: number<br>current: number<br> |
 
 
 ## Ref 方法
@@ -77,15 +79,42 @@
 	<!-- #endif -->
 
 	
-	<view class="mx-16 flex-1">
-		<x-indexbar :customSliderBar="['搜','火']" :list="list" height="100%" cellHeight="72">
+	<view class="flex-1">
+		<x-indexbar :customSliderBar="['#','搜','火']" :list="list" height="100%" cellHeight="72">
 			<template v-slot:top>
-				<x-search color="transparent" input-bg-color="#ffffff"></x-search>
+				<!--
+					top 插槽：索引条上的自定义项（# 搜 火 热 新）没有对应的列表分组，
+					点它们都会定位到这个插槽，所以这些项对应的内容要写在这里。
+				-->
+				<view >
+					<x-search round="0" darkColor="transparent" color="transparent" input-bg-color="#ffffff"></x-search>
+
+					<view class="pa-16">
+						<!-- # 对应的内容：点右侧 # 回到顶部搜索框这里 -->
+						<view class="flex flex-row flex-row-center-between mt-16">
+							<view class="flex flex-row flex-row-center-start">
+								<text class="text-size-lg text-weight-b" :style="{color:textColor}">#</text>
+								<text class="text-size-s ml-8" :style="{color:textColor}">快捷入口</text>
+							</view>
+							<text class="text-size-xxs opacity-6" :style="{color:textColor}">点右侧 # 回到这里</text>
+						</view>
+						
+						<!-- 搜 / 火 / 热 / 新 对应的内容 -->
+						<view class="flex flex-row flex-wrap mt-12">
+							<view v-for="(item, index) in quickEntries" :key="index"
+								class="flex flex-row flex-row-center-start round-12 px-16 py-8 mr-12 mb-12"
+								:style="{backgroundColor:chipBgColor}">
+								<text class="text-size-xs text-weight-b" :style="{color:textColor}">{{item.tag}}</text>
+								<text class="text-size-xs ml-8 opacity-8" :style="{color:textColor}">{{item.title}}</text>
+							</view>
+						</view>
+					</view>
+				</view>
 			</template>
 			<template v-slot:default="{index,currentIndex,current}">
-				<view class="flex flex-row flex-row-center-start" style="border-bottom: 1px solid rgba(100, 100, 100, 0.1);height:72px;">
+				<view class="flex flex-row flex-row-center-start px-16 " style="border-bottom: 1px solid rgba(100, 100, 100, 0.1);height:72px;">
 					<image class="flex-shrink" :src="`https://picsum.photos/100/100?random=${index}`" style="width:50px;height:50px;border-radius: 50px;"></image>
-					<text :style="{color:isDark?'#ffffff':'#000000'}" class="ml-20">{{(current as UTSJSONObject).getAny("name")}}</text>
+					<text :style="{color:isDark?'#ffffff':'#000000'}" class="ml-20">{{(current as Record<string, any>)["name"]}}</text>
 				</view>
 			</template>
 		</x-indexbar>
@@ -93,12 +122,25 @@
 		
 </template>
 
-<script setup>
+<script setup lang="ts">
 	// 示例参数数据,请vip用户到demo中下载查询数据样例.
-	import {dataslist} from "./indexdata.uts"
+	import {dataslist} from "./indexdata"
 	import { xConfig } from "@/uni_modules/tmx-ui";
+
+	type QuickEntry = {
+		tag : string,
+		title : string
+	}
+
 	const isDark = computed(():boolean => xConfig.dark=='dark')
-	const list = ref<UTSJSONObject[]>(JSON.parseArray(dataslist)! as UTSJSONObject[])
+	const textColor = computed(():string => isDark.value?'#ffffff':'#000000')
+	const chipBgColor = computed(():string => isDark.value?'rgba(255,255,255,0.10)':'rgba(0,0,0,0.05)')
+	// 索引条上的 搜/火/热/新 自定义项对应的内容样例
+	const quickEntries = ref<QuickEntry[]>([
+		{ tag: '搜', title: '雷克萨斯 ES 200' },
+		{ tag: '火', title: '保时捷 911' }
+	] as QuickEntry[])
+	const list = ref<Record<string, any>[]>(JSON.parse(dataslist) as Record<string, any>[])
 </script>
 
 <style lang="scss">

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/markdown xCmarkdown.md"

@@ -2,11 +2,10 @@
 
 ## 介绍
 
-markdown组件,可以用来渲染标签的html文章或者纯Markdown或者markdown+简单的html标签混合渲染，与原x-markdown不同，采用官方原生c库实现解析速度超猛。
-并且是纯原生渲染，不再是webview渲染了，因此渲染速度也超快。并且为了兼容和生成截图的需求，针对官方C库解析扩展了相关的功能
-1、允许你在markdown中输入简单的html标签，以控制一些文本样式：比如颜色，背景字号等行内样式。2、允许启用isHtml纯html解析，当你启用html解析时它的技术路径是
-参考微信小程序支持的标签过滤掉不支持的标签，和删除属性，再进行原生渲染，因此理论上说纯html会比较快解析的数量要少。
-[此组件依赖uni-cmark插件可在代码仓库下载]
+markdown组件,可以用来渲染标签的html文章或者纯Markdown或者markdown+简单的html标签混合渲染。
+内部使用自有插件x-chatmarkdown-u的原生引擎渲染（app端原生view，web/小程序端节点渲染），
+不再依赖官方uni-cmark，也不再把内容解析为token后用子组件循环渲染。
+[此组件依赖x-chatmarkdown-u插件]
 
 ## 平台兼容
 
@@ -33,11 +32,11 @@ markdown组件,可以用来渲染标签的html文章或者纯Markdown或者markd
 | value | ``<br> | `string` | `""` |
 | codeTheme | ``<br> | `union` | `'jetbrains'` |
 | codeThemeMode | `代码块主题，以什么样式主题输出，auto:自动跟随全局主题，light:使用亮系配色，dark:使用暗系配色`<br> | `union` | `'auto'` |
-| previewImage | `预览图片`<br> | `boolean` | `true` |
-| showCodeToolbar | `是否显示代码复制工具栏`<br> | `boolean` | `true` |
-| showTableRipple | `显示表格波纹背景`<br> | `boolean` | `true` |
-| linkAndCopyColor | `链接及复制的主色，空取全值`<br> | `string` | `''` |
-| isHtml | `是否是纯html，它会先把html内容解析为标签的Markdown格式，删除不支持的标签，删除所有属性和样式，统一样式`<br>`如果你需要指定文本颜色可以使用行内html块比如<span style="color:red;">我是内容</span>,仅支持行内样式。`<br> | `boolean` | `false` |
+| previewImage | `预览图片（改用x-chatmarkdown-u引擎后此属性不再生效，图片由引擎内部处理）`<br> | `boolean` | `true` |
+| showCodeToolbar | `是否显示代码复制工具栏（改用x-chatmarkdown-u引擎后此属性不再生效）`<br> | `boolean` | `true` |
+| showTableRipple | `显示表格波纹背景（改用x-chatmarkdown-u引擎后此属性不再生效）`<br> | `boolean` | `true` |
+| linkAndCopyColor | `链接及复制的主色，空取全值（改用x-chatmarkdown-u引擎后此属性不再生效）`<br> | `string` | `''` |
+| isHtml | `是否是纯html。改用x-chatmarkdown-u引擎后不再做前置解析，内容原样交给引擎处理，`<br>`引擎按markdown+内嵌html混合内容渲染。`<br> | `boolean` | `false` |
 | fontSize | `默认的字号,它是文本字号，不包含其它特殊的文本字号，如果有标签内的样式字号此处会失效`<br> | `string` | `"16px"` |
 
 
@@ -46,7 +45,7 @@ markdown组件,可以用来渲染标签的html文章或者纯Markdown或者markd
 | 名称 | 参数 | 说明 |
 | ------ | ---- | ---- |
 | link | `val: string<br>` | 连接被点击 |
-| image | `val: string<br>` | 图片被点击 |
+| image | `val: string<br>` | 图片被点击（x-chatmarkdown-u引擎暂不提供图片点击事件，保留此事件仅为兼容旧api） |
 
 
 ## Slots 插槽
@@ -86,7 +85,7 @@ markdown组件,可以用来渲染标签的html文章或者纯Markdown或者markd
 
 </template>
 
-<script setup>
+<script setup lang="ts">
 	const markdown = ref('')
 	const markdownTempData : string = `
 > 这是一个引用块
@@ -131,7 +130,7 @@ if (closeTagMatch != null && closeTagMatch.length > 0 && closeTagMatch[0] != nul
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | ☑️ | ☑️ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.1.18 |
 
-这是行内公式 \\(E = mc^2\\)，这是块级公式：$$\\sum_{i=1}^n i = \\frac{n(n+1)}{2}$$
+这是行内公式 $E = mc^2$，这是另一个公式：$\\sum_{i=1}^n i = \\frac{n(n+1)}{2}$
 
 ## 文件路径
 
@@ -219,7 +218,7 @@ border-color: transparent; margin: 0px 14px 14px; padding: 14px; box-shadow: non
 const hello = 'world';
 \`\`\`
 
-这是一个[链接](https://example.com)和一张![图片](https://xui.tmui.design/lp-18.jpg)。
+这是一个[链接](https://example.com)和一张![图片](https://web-assets.dcloud.net.cn/unidoc/zh/uni@2x.png)。
 
 ---
 
@@ -319,7 +318,14 @@ const hello = 'world';
 
 ### 图片
 
-![引用图片](https://xui.tmui.design/lp-18.jpg)
+![DCloud Logo](https://web-assets.dcloud.net.cn/unidoc/zh/uni@2x.png)
+
+<img src="https://web-assets.dcloud.net.cn/unidoc/zh/uni-app.png" alt="指定尺寸" width="200" height="80">
+
+### 视频
+
+<video src="https://stream7.iqilu.com/10339/upload_transcode/202002/09/20200209104902N3v5Vpxuvb.mp4" width="100%" controls></video>
+
 
 ## 7. 表格测试
 
@@ -347,7 +353,7 @@ ___
 ### 行内数学公式
 这是行内公式：$E = mc^2$，这是另一个公式：$\\sum_{i=1}^n i = \\frac{n(n+1)}{2}$
 
-LaTeX 格式行内公式：\\(E = mc^2\\) 和 \\(\\alpha + \\beta = \\gamma\\)
+LaTeX 格式行内公式：$E = mc^2$ 和 $\\alpha + \\beta = \\gamma$
 
 ### 块级数学公式
 $$E = mc^2$$
@@ -357,7 +363,8 @@ $$\\sum_{i=1}^n i = \\frac{n(n+1)}{2}$$
 $$\\int_{-\\infty}^{\\infty} e^{-x^2} dx = \\sqrt{\\pi}$$
 
 LaTeX 格式块级公式：
-\\\\[\\frac{\\partial f}{\\partial x} = \\lim_{h \\to 0} \\frac{f(x+h) - f(x)}{h}\\\\]
+
+$$\\frac{\\partial f}{\\partial x} = \\lim_{h \\to 0} \\frac{f(x+h) - f(x)}{h}$$
 
 ## 10. HTML 标签测试
 

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/210/206/345/211/262/347/272/277 xDivider.md"

@@ -99,7 +99,7 @@
 
 </template>
 
-<script setup>
+<script setup lang="ts">
 	
 </script>