tmui-cli 2.0.1 → 2.0.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//344/270/213/346/213/211/345/210/267/346/226/260 xPullRefresh.md"

@@ -0,0 +1,244 @@
+# 下拉刷新 xPullRefresh
+
+## 介绍
+
+常用下拉容器，不要虚拟切片。pulldown / refresh 用 Promise，组件自己收 refresher。listType 切换 scroll-view / list-view。#top / #sticky 和内容同一层滚动容器。不要原生子协商。scroll-view：App / Web #sticky 到达后 fixed，小程序 using-sticky。list-view：App / Web 用 sticky-header，小程序 list-item + sticky。
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ☑ | ☑ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.1.18 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-pull-refresh/x-pull-refresh.uvue
+```
+
+## 使用
+
+```ts
+<x-pull-refresh></x-pull-refresh>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| height | ``<br> | `string` | `"100%"` |
+| full | ``<br> | `boolean` | `true` |
+| empty | ``<br> | `boolean` | `false` |
+| listType | ``<br> | `string` | `"scroll-view"` |
+| refresh | ``<br> | `xPullRefreshFun` | `() : xPullRefreshFun => {     return null }` |
+| pulldown | ``<br> | `xPullRefreshFun` | `() : xPullRefreshFun => {     return null }` |
+| showScrollbar | ``<br> | `boolean` | `false` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| scroll | `-` | - |
+| refresh | `-` | - |
+| pulldown | `-` | - |
+
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| top | `-` | - |
+| sticky | `-` | - |
+| empty | `-` | - |
+| default | `-` | - |
+| refresh | `-` | - |
+
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| refreshSize | - | `-` | - |
+| resetScroll | - | `-` | - |
+| setScrollTop | - | `-` | - |
+
+
+## 示例文件路径
+
+```json
+/pages/fankui/pull-refresh
+```
+
+## 示例源码
+
+```vue
+<template>
+	<!-- #ifdef MP-WEIXIN -->
+	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
+		<navigation-bar :background-color="xThemeConfigNavBgColor"
+			:front-color="xThemeConfigNavFontColor"></navigation-bar>
+	</page-meta>
+	<!-- #endif -->
+
+	<view class="page">
+		<x-pull-refresh class="pageList" height="100%" :list-type="listType" :empty="list.length == 0"
+			:pulldown="onPulldown" :refresh="onLoadMore">
+			<template #top>
+				<x-sheet :margin="[0, 0, 0, 8]">
+					<x-text font-size="18" class=" text-weight-b mb-8">下拉刷新 xPullRefresh</x-text>
+					<x-text color="#999999" class="mb-12">常用下拉容器。向下先推顶部，菜单吸顶后再滚内容。下拉和触底都交 Promise。listType 可切
+						scroll-view / list-view。本页 {{ list.length }} 条，当前 {{ listType }}。</x-text>
+					<view class="flex flex-row flex-row-center-between">
+						<x-button size="small" class="flex-1" @click="toggleListType">容器</x-button>
+						<x-button size="small" class="ml-5 flex-1" @click="reloadAll">重载</x-button>
+						<x-button size="small" class="ml-5 flex-1" @click="appendRows">追加</x-button>
+						<x-button size="small" class="ml-5 flex-1" @click="clearAll">清空</x-button>
+					</view>
+				</x-sheet>
+			</template>
+			<template #sticky="{ pinned }">
+				<view >
+					<x-tabs v-model="menuId" :list="tabList" item-width="33.333%" height="44"></x-tabs>
+				</view>
+			</template>
+
+			<template v-if="listType == 'scroll-view'">
+				<view style="height: 8px;"></view>
+				<view v-for="item in list" :key="item.key" class="cardWrap">
+					<view class="card" :style="{ backgroundColor: cardBg }">
+						<x-text>{{ item.title }}</x-text>
+					</view>
+				</view>
+			</template>
+			<template v-else>
+				<list-item>
+					<view style="height: 8px;"></view>
+				</list-item>
+				<list-item v-for="item in list" :key="item.key">
+					<view class="cardWrap">
+						<view class="card" :style="{ backgroundColor: cardBg }">
+							<x-text>{{ item.title }}</x-text>
+						</view>
+					</view>
+				</list-item>
+			</template>
+			<template #empty>
+				<x-empty v-if="list.length == 0" :empty="true" :loading="false" btn-label="加载数据"
+					@click="reloadAll"></x-empty>
+			</template>
+		</x-pull-refresh>
+	</view>
+</template>
+
+<script lang="ts" setup>
+	import { computed, ref } from "vue"
+	import { xConfig, TABS_ITEM_INFO } from "@/uni_modules/tmx-ui"
+
+	type DemoRow = {
+		key : string
+		title : string
+	}
+
+	function makeRows(from : number, count : number) : DemoRow[] {
+		const out : DemoRow[] = []
+		for (let i = 0; i < count; i++) {
+			const n = from + i
+			out.push({
+				key: n.toString(),
+				title: "下拉刷新，上拉加载 - " + (n + 1).toString()
+			})
+		}
+		return out
+	}
+
+	const listType = ref<string>("scroll-view")
+	const menuId = ref<string>("all")
+	const tabList = [
+		{ id: "all", title: "综合" },
+		{ id: "new", title: "新品" },
+		{ id: "hot", title: "热门" }
+	] as TABS_ITEM_INFO[]
+	const list = ref<DemoRow[]>(makeRows(0, 12))
+
+	const cardBg = computed(() : string => {
+		if (xConfig.dark == "dark") return xConfig.sheetDarkColor
+		return "#ffffff"
+	})
+
+	function wait(ms : number) : Promise<void> {
+		return new Promise<void>((resolve) => {
+			setTimeout(() => {
+				resolve()
+			}, ms)
+		})
+	}
+
+	function toggleListType() : void {
+		if (listType.value == "list-view") {
+			listType.value = "scroll-view"
+			return
+		}
+		listType.value = "list-view"
+	}
+
+	function reloadAll() : void {
+		list.value = makeRows(0, 8)
+	}
+
+	function appendRows() : void {
+		list.value = list.value.concat(makeRows(list.value.length, 4))
+	}
+
+	function keepEight() : void {
+		list.value = list.value.slice(0, 8)
+	}
+
+	function clearAll() : void {
+		list.value = [] as DemoRow[]
+	}
+
+	async function onPulldown() : Promise<void> {
+		await wait(800)
+		list.value = makeRows(0, 8)
+	}
+
+	async function onLoadMore() : Promise<void> {
+		await wait(600)
+		appendRows()
+	}
+</script>
+
+<style scoped>
+	.page {
+		flex: 1;
+		display: flex;
+		flex-direction: column;
+	}
+
+	.pageList {
+		flex: 1;
+		min-height: 0;
+	}
+
+
+	.cardWrap {
+		padding: 0 8px 8px 8px;
+	}
+
+	.card {
+		height: 120px;
+		padding: 16px;
+		border-radius: 10px;
+		display: flex;
+		flex-direction: column;
+		justify-content: center;
+	}
+</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/217/215/351/246/210/347/273/204/344/273/266//344/270/213/346/213/211/350/217/234/345/215/225 xDropdownMenu.md"

@@ -0,0 +1,144 @@
+# 下拉菜单 xDropdownMenu
+
+## 介绍
+
+下拉菜单，标签内只能放置子项目x-dropdown-item
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ☑ | ☑ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.1.18 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-dropdown-menu/x-dropdown-menu.uvue
+```
+
+## 使用
+
+```ts
+<x-dropdown-menu></x-dropdown-menu>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| position | `位置，`<br>`static \`<br>` fixed`<br>`静态 \`<br>` 展开后悬浮在顶部。`<br> | `string` | `"fixed"` |
+| offsetTop | `顶部的偏移量，针对你们自定标题导航时可能需要让出顶部位置。`<br>`数字字符，prx,px等单位`<br>`如果position=static此属性失效。`<br> | `string` | `"0"` |
+| modelValue | `当前激活的索引`<br>`-1表示关闭。提供值时请大于-1,`<br>`如果不想要变量控制，可不提供。交由内部自行处理。`<br>`当你想要用变量控制开关时可v-model="索引"来控制关闭和打开。`<br> | `number` | `-1` |
+| height | `菜单栏的高度`<br> | `string` | `"44"` |
+| width | `宽度`<br> | `string` | `"auto"` |
+| color | `背景颜色`<br> | `string` | `"white"` |
+| darkColor | `暗黑时的背景颜色`<br> | `string` | `""` |
+| zIndex | `层级`<br> | `number` | `88` |
+| hidnMask | `对于要把此组件嵌套在fiexd中时,并且position为static时`<br>`请一定设置为true,否则在web端会出现层级混乱(这是css dom规则所定)`<br>`为了全平台对齐请嵌套组件时一定注意使用事项.`<br> | `boolean` | `false` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| change | `index: number<br>keyName: string<br>status: boolean<br>` | 切换菜单时触发 |
+| update:modelValue | `-` | - |
+
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| default | `默认插槽，只能放置子项目x-dropdown-item` | - |
+
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| addMenu | - | `-` | - |
+| delMenu | - | `-` | - |
+
+
+## 示例文件路径
+
+```json
+/pages/fankui/dropdown-menu
+```
+
+## 示例源码
+
+```vue
+<template>
+	<!-- #ifdef MP-WEIXIN -->
+	<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">下拉菜单 dropdownMenu</x-text>
+			<x-text color="#999999" >
+				提供static和fiexd两种位置方式。内容完全通过插槽自由布局。x-dropdown-menu 中的render="true"后动画会消失
+			</x-text>
+		</x-sheet>
+		<x-dropdown-menu @change="onchange" v-model="activeIndex">
+			<x-dropdown-item  title="按销量" key-name="xiaoliang">
+				<x-text class="mb-32">因自由度非常高，你可以自由布局最大高度是否滚动内容。</x-text>
+				<!-- -1表示关闭 -->
+				<x-button @click="activeIndex=-1" :block="true">关闭</x-button>
+			</x-dropdown-item>
+			<x-dropdown-item :title="menus" key-name="wiff">
+				<x-text>自己添加scrollview等实现页脚功能.</x-text>
+			</x-dropdown-item>
+			<x-dropdown-item title="硬盘容量" key-name="yingpan">
+				<x-text>内容层的高度是自动高。不需要额外设置。</x-text>
+			</x-dropdown-item>
+			<x-dropdown-item title="综合" key-name="zhonghe" :isBtn="true" icon="sort-desc" active-icon="sort-asc">
+				<x-text>内容层的高度是自动高。不需要额外设置。</x-text>
+			</x-dropdown-item>
+		</x-dropdown-menu>
+
+
+		<x-sheet :margin="['0','24']">
+			<x-text font-size="18" class=" text-weight-b ">正文是静态，弹出时，菜单不会置顶在页面顶部。</x-text>
+		</x-sheet>
+
+		<x-dropdown-menu position="static">
+			<x-dropdown-item title="按距离">
+				<x-text>这里由用户自由布局内容，实现逻辑。</x-text>
+			</x-dropdown-item>
+			<x-dropdown-item title="综合条件">
+				<x-text>你还可以实现更多更复杂的功能.</x-text>
+			</x-dropdown-item>
+			<x-dropdown-item title="所有项目">
+				<x-text>完全插槽实现灵活度极高。</x-text>
+			</x-dropdown-item>
+		</x-dropdown-menu>
+
+	<view style="height:580px"></view>
+
+</template>
+
+<script setup lang="ts">
+	import { ref } from 'vue'
+	
+	const activeIndex = ref(-1)
+	const remove = ref(true)
+	const menus = ref("网络类型")
+	
+	const onchange = (index : number, keyName : string, status : boolean) => {
+		console.log('当前索引：', index, ';当前项目标识：', keyName, ';当前开关状态：', status)
+	}
+</script>
+
+<style lang="scss">
+
+</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/217/215/351/246/210/347/273/204/344/273/266//344/270/213/346/213/211/350/217/234/345/215/225/345/255/220/347/273/204/344/273/266 xDropdownItem.md"

@@ -0,0 +1,143 @@
+# 下拉菜单子组件 xDropdownItem
+
+## 介绍
+
+注意只能放置在父组件x-dropdown-menu中
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ☑ | ☑ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.1.18 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-dropdown-item/x-dropdown-item.uvue
+```
+
+## 使用
+
+```ts
+<x-dropdown-item></x-dropdown-item>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| title | `菜单标题`<br> | `string` | `"标题"` |
+| keyName | `标识，变换或者点击时，会通过事件传回。`<br> | `string` | `""` |
+| icon | `未选中时的图标`<br> | `string` | `"arrow-down-s-fill"` |
+| activeIcon | `激活时的图标`<br> | `string` | `"arrow-up-s-fill"` |
+| fontColor | `默认的文字及图标颜色`<br> | `string` | `"#333333"` |
+| darkFontColor | `暗黑时的默认的文字及图标颜色，`<br>`空取时白色`<br> | `string` | `""` |
+| fontSize | `文字及图标大小`<br> | `string` | `"16"` |
+| activeFontColor | `激活的文字及图标颜色`<br>`空值时取全局统一的主题色。`<br> | `string` | `""` |
+| isBtn | `是否是按钮选项。`<br> | `boolean` | `false` |
+| color | `内容背景颜色`<br> | `string` | `"white"` |
+| darkColor | `暗黑时的内容背景颜色,空值取sheetDarkColor`<br> | `string` | `""` |
+| render | `渲染,如果设置为true,内部使用vif切换渲染`<br>`注意它不会影响其它菜单只影响本菜单.vif切换会导致内容重绘,但`<br>`可以解决sdk的一些异常组件嵌套的问题.`<br>`当您嵌套的组件在此内出现异常,闪退,报错时请设置为true,否则不用理会本属性`<br>`本属性存在就是为了绕开sdk bug.`<br> | `boolean` | `false` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| - | - | - |
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| default | `默认插槽，弹层内容。` | - |
+
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| - | - | - | - |
+
+## 示例文件路径
+
+```json
+/pages/fankui/dropdown-menu
+```
+
+## 示例源码
+
+```vue
+<template>
+	<!-- #ifdef MP-WEIXIN -->
+	<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">下拉菜单 dropdownMenu</x-text>
+			<x-text color="#999999" >
+				提供static和fiexd两种位置方式。内容完全通过插槽自由布局。x-dropdown-menu 中的render="true"后动画会消失
+			</x-text>
+		</x-sheet>
+		<x-dropdown-menu @change="onchange" v-model="activeIndex">
+			<x-dropdown-item  title="按销量" key-name="xiaoliang">
+				<x-text class="mb-32">因自由度非常高，你可以自由布局最大高度是否滚动内容。</x-text>
+				<!-- -1表示关闭 -->
+				<x-button @click="activeIndex=-1" :block="true">关闭</x-button>
+			</x-dropdown-item>
+			<x-dropdown-item :title="menus" key-name="wiff">
+				<x-text>自己添加scrollview等实现页脚功能.</x-text>
+			</x-dropdown-item>
+			<x-dropdown-item title="硬盘容量" key-name="yingpan">
+				<x-text>内容层的高度是自动高。不需要额外设置。</x-text>
+			</x-dropdown-item>
+			<x-dropdown-item title="综合" key-name="zhonghe" :isBtn="true" icon="sort-desc" active-icon="sort-asc">
+				<x-text>内容层的高度是自动高。不需要额外设置。</x-text>
+			</x-dropdown-item>
+		</x-dropdown-menu>
+
+
+		<x-sheet :margin="['0','24']">
+			<x-text font-size="18" class=" text-weight-b ">正文是静态，弹出时，菜单不会置顶在页面顶部。</x-text>
+		</x-sheet>
+
+		<x-dropdown-menu position="static">
+			<x-dropdown-item title="按距离">
+				<x-text>这里由用户自由布局内容，实现逻辑。</x-text>
+			</x-dropdown-item>
+			<x-dropdown-item title="综合条件">
+				<x-text>你还可以实现更多更复杂的功能.</x-text>
+			</x-dropdown-item>
+			<x-dropdown-item title="所有项目">
+				<x-text>完全插槽实现灵活度极高。</x-text>
+			</x-dropdown-item>
+		</x-dropdown-menu>
+
+	<view style="height:580px"></view>
+
+</template>
+
+<script setup lang="ts">
+	import { ref } from 'vue'
+	
+	const activeIndex = ref(-1)
+	const remove = ref(true)
+	const menus = ref("网络类型")
+	
+	const onchange = (index : number, keyName : string, status : boolean) => {
+		console.log('当前索引：', index, ';当前项目标识：', keyName, ';当前开关状态：', status)
+	}
+</script>
+
+<style lang="scss">
+
+</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/217/215/351/246/210/347/273/204/344/273/266//345/212/240/350/275/275/344/270/255 xLoading.md"

@@ -0,0 +1,113 @@
+# 加载中 xLoading
+
+## 介绍
+
+加载中占位符，场景用到页面加载前。请在标签内写上你的文本, 如果不写，默认显示"加载中..."
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ☑ | ☑ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.1.18 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-loading/x-loading.uvue
+```
+
+## 使用
+
+```ts
+<x-loading></x-loading>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| color | `图标颜色`<br> | `string` | `"#8b8b8b"` |
+| textColor | `文字颜色`<br> | `string` | `"#8b8b8b"` |
+| textSize | `文字大小`<br> | `string` | `"12"` |
+| iconSize | `图标大小`<br> | `string` | `"21"` |
+| vertical | `是否垂直，默认是水平`<br> | `boolean` | `true` |
+| icon | `图标`<br> | `string` | `"loader-line"` |
+| hideText | `隐藏加载文本插槽`<br> | `boolean` | `false` |
+| label | `加载中的文本,加载中...`<br> | `string` | `""` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| - | - | - |
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| default | `请在插槽内写上你的文本, 如果不写，默认显示"加载中..."` | - |
+
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| - | - | - | - |
+
+## 示例文件路径
+
+```json
+/pages/fankui/loading
+```
+
+## 示例源码
+
+```vue
+<template>
+	<!-- #ifdef MP-WEIXIN -->
+	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
+		<navigation-bar :background-color="xThemeConfigNavBgColor"
+			:front-color="xThemeConfigNavFontColor"></navigation-bar>
+	</page-meta>
+	<!-- #endif -->
+	<view>
+
+		<x-sheet>
+			<x-text font-size="18" class=" text-weight-b mb-8">加载 Loading</x-text>
+			<x-text color="#999999">
+				可在需要占位加载中使用。
+			</x-text>
+		</x-sheet>
+		<x-sheet>
+			<x-loading></x-loading>
+		</x-sheet>
+		<x-sheet>
+			<x-text font-size="18" class=" text-weight-b ">水平</x-text>
+		</x-sheet>
+		<x-sheet>
+			<x-loading :vertical="false"></x-loading>
+		</x-sheet>
+		<x-sheet>
+			<x-text font-size="18" class=" text-weight-b ">更改图标及颜色</x-text>
+		</x-sheet>
+		<x-sheet>
+			<x-loading icon="refresh-line" color="primary"></x-loading>
+		</x-sheet>
+	</view>
+</template>
+
+<script setup lang="ts">
+
+</script>
+
+<style lang="scss">
+
+</style>
+```
+
+---
+
+## 版权
+
+@2026 tmui4x [https://xui.tmui.design](https://xui.tmui.design)