tmui-cli 2.0.1 → 2.0.2

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//346/220/234/347/264/242/351/200/211/346/213/251 xpickerSelected.md"

@@ -0,0 +1,259 @@
+# 搜索选择 xpickerSelected
+
+## 介绍
+
+弹层式大数据列表筛选，搜索。可异步加载数据。可针对本地搜索及异步搜索加载数据。弹层列表走 x-virtual-list，不要 list-view。
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ☑ | ☑ | ☑️ | ☑️ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.1.18 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-picker-selected/x-picker-selected.uvue
+```
+
+## 使用
+
+```ts
+<x-picker-selected></x-picker-selected>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| modelValue | `当前选中的数据，any数组string[],number[]`<br>`否则报错，无法运行。`<br> | `Array` | `() => [] as any[]` |
+| modelShow | `当前打开的状态。`<br>`等同v-model:model-show`<br> | `boolean` | `false` |
+| modelStr | `回显当前选中的文本，只输出`<br>`等同v-model:model-str`<br> | `Array` | `() => [] as string[]` |
+| title | `顶部标题,默认：请选择`<br> | `string` | `""` |
+| cancelText | `取消按钮的文本,默认：取消`<br> | `string` | `""` |
+| confirmText | `确认按钮的文本,默认：确认`<br> | `string` | `""` |
+| filterKey | `搜索的字段名称`<br> | `string` | `"text"` |
+| labelKey | `显示文本的字段`<br> | `string` | `"text"` |
+| idKey | `列表字段的唯一标识`<br>`注意它的数据是number或者string类型.`<br> | `string` | `"id"` |
+| list | `数据列表。`<br> | `Array` | `() => [] as UTSJSONObject[]` |
+| localSearch | `默认采用本地对list的结果集进行筛选搜索。`<br>`如果禁用用，你可以自行通过search事件来搜索`<br>`并赋值给list更新结果。`<br> | `boolean` | `true` |
+| multiple | `是否允许多选`<br> | `boolean` | `true` |
+| isRadioMode | `当设置multiple为false时`<br>`是否允许为单选唯一模式,即不允许取消唯一项,意味着一旦选中一项就无法清空或者取消.`<br> | `boolean` | `false` |
+| lazyContent | `是否懒加载内部内容。`<br>`当前你的列表内容非常多，且影响打开的动画性能时，请务必`<br>`设置此项为true，以获得流畅视觉效果。`<br> | `boolean` | `false` |
+| lazyDuration | `lazyContent的延迟时间 单位 ms`<br>`如果你的 app效果不行，请加大此值`<br> | `number` | `100` |
+| itemHeight | `项目的高度.不要去动态改变高,内部是虚拟列表,动态改高会出现问题.`<br> | `string` | `"50"` |
+| zIndex | `层级`<br> | `number` | `1100` |
+| showClose | `是否显示关闭按钮`<br> | `boolean` | `false` |
+| refresh | `下拉刷新时v-model:refresh,触发时会设置为true，结束时需要自行设置为false`<br>`来结束刷新。`<br> | `boolean` | `false` |
+| bottomRefresh | `触底刷新时，v-model:bottomR-refresh,触发时会设置为true，结束时需要自行设置为false`<br>`来结束刷新。`<br> | `boolean` | `false` |
+| disabledPull | `是否禁用下拉刷新`<br> | `boolean` | `true` |
+| disabledBottom | `是否禁用触底刷新`<br> | `boolean` | `true` |
+| disabled | `是否禁用弹出`<br> | `boolean` | `false` |
+| widthCoverCenter | `宽屏时是否让内容剧中显示`<br>`并限制其宽为屏幕宽，只展示中间内容以适应宽屏。`<br> | `boolean` | `false` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| bottomRefresh | `-` | 触底刷新时触发，需要自行设置属性bottomRefresh为false结束状态 |
+| refresh | `-` | 下拉刷新时触发，需要自行设置属性refresh为false结束状态 |
+| search | `keyword: string<br>` | 搜索时触发 |
+| confirm | `ids: any[]<br>data: UTSJSONObject[]<br>` | 确认选择时触发 |
+| cancel | `-` | 取消搜索时触发 |
+| open | `-` | 显示弹层时触发，<br>可以用来在此第一次加载list异步数据。 |
+| update:modelShow | `-` | 变量控制打开状态<br>等同v-model:model-show |
+| update:modelStr | `-` | 自动回显文本数组，此属性只对外输出。 |
+| update:bottomRefresh | `-` | v-model:bottomR-refresh |
+| update:refresh | `-` | v-model:refresh |
+| update:modelValue | `-` | v-model:modelValue |
+
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| default | `插槽,默认触发打开选择器。你的默认布局可以放置在这里。` | label: string<br> |
+| item | `动态循环列表的项目插槽` | item: xPickerSelectedListyType<br> |
+
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| open | - | `-` | 打开选择器 * |
+| close | - | `-` | 关闭选择器 * |
+| clearAll | - | `-` | 清空选择 * |
+| selectedAll | - | `-` | 全选 * |
+| clearSearchKey | - | `-` | 清空搜索框内容 * |
+
+
+## 示例文件路径
+
+```json
+/pages/biaodan/picker-selected
+```
+
+## 示例源码
+
+```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">搜索选择 xPickerSelected</x-text>
+		<x-text color="#999999" class="mb-20">通过弹出式的列表，异步加载数据来显示并选择数据</x-text>
+	</x-sheet>
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">本地搜索</x-text>
+		<x-text color="#999999" class="">此处使用了lazyContent属性展开内容超多，视觉效果也流畅</x-text>
+		<x-sheet color="info" dark-color="#333" :margin="['0','16']">
+			<x-text color="#999999">已选ids：{{model1.join(",")}}</x-text>
+			<x-text color="#999999">回显文本：{{modelStr1.join(",")}}</x-text>
+		</x-sheet>
+		<x-picker-selected label-key="name" :lazyContent="true" v-model:model-str="modelStr1" v-model="model1"
+			:list="list">
+			<x-button :block="true">打开本地数据集搜索</x-button>
+			<template v-slot:item="{item}">
+				<x-text>{{item.getAny('name')}}</x-text>
+			</template>
+		</x-picker-selected>
+	</x-sheet>
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-8">下拉刷新触底加载</x-text>
+		<x-picker-selected v-model:refresh="refresTop" v-model:bottom-refresh="refresBottom" @refresh="refreshLoad"
+			@bottom-refresh="refresBottomhLoad" :disabled-bottom="false" :disabled-pull="false" label-key="name"
+			:lazyContent="true" v-model:model-str="modelStr1" v-model="model1" :list="list">
+			<template v-slot:default="{label}">
+				<x-button :block="true">打开本地数据集搜索</x-button>
+			</template>
+		</x-picker-selected>
+	</x-sheet>
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b ">异步搜索</x-text>
+		<x-sheet color="info" dark-color="#333" :margin="['0','16']">
+			<x-text color="#999999">已选ids：{{model2.join(",")}}</x-text>
+			<x-text color="#999999">回显文本：{{modelStr2.join(",")}}</x-text>
+		</x-sheet>
+		<x-picker-selected :local-search="false" @search="onSearch" v-model:model-str="modelStr2" v-model="model2"
+			:list="list2">
+			<x-button :block="true">打开异步数据搜索</x-button>
+		</x-picker-selected>
+	</x-sheet>
+
+</template>
+
+<script setup lang="ts">
+	import { ref } from 'vue'
+
+	const model1 = ref<number[]>([2, 8])
+	const modelStr1 = ref<string[]>([])
+	const model2 = ref<number[]>([])
+	const modelStr2 = ref<string[]>([])
+	const list = ref<UTSJSONObject[]>([
+		{ id: 1, lid: '1001', name: '广州信瑞化妆品公司' } as UTSJSONObject,
+		{ id: "2", lid: '1002', name: '深圳市创明展览设计有限公司' } as UTSJSONObject,
+		{ id: 3, lid: '1003', name: '上海盟威实业发展有限公司' } as UTSJSONObject,
+		{ id: 4, lid: '1004', name: '国都期货有限公司' } as UTSJSONObject,
+		{ id: 5, lid: '1005', name: '山西宇达集团' } as UTSJSONObject,
+		{ id: 6, lid: '1006', name: '博达网络有限公司' } as UTSJSONObject,
+		{ id: 7, lid: '1007', name: '新贸易有限公司' } as UTSJSONObject,
+		{ id: 8, lid: '1008', name: '东莞市东辉仪器有限公司' } as UTSJSONObject,
+		{ id: 9, lid: '1009', name: '东省东莞市石碣镇东辉电子仪器有限公司' } as UTSJSONObject,
+		{ id: 10, lid: '10010', name: '古兰电子科技有限责任公司' } as UTSJSONObject,
+		{ id: 11, lid: '10011', name: '邦达礼品公司' } as UTSJSONObject,
+		{ id: 12, lid: '10012', name: '广州市广花制冷配件公司' } as UTSJSONObject,
+		{ id: 13, lid: '10013', name: '中国云南彩蝶谷服饰加盟连锁店' } as UTSJSONObject,
+		{ id: 14, lid: '10014', name: '明珠盘艺有限公司' } as UTSJSONObject,
+		{ id: 15, lid: '10015', name: '景滔塑胶五金有限公司' } as UTSJSONObject,
+		{ id: 16, lid: '10016', name: '福建古拉特商贸公司' } as UTSJSONObject,
+		{ id: 17, lid: '10017', name: '吐鲁番市英俊农产品有限责任公司' } as UTSJSONObject,
+		{ id: 18, lid: '10018', name: '新疆亿艾斯国际贸易公司' } as UTSJSONObject,
+		{ id: 19, lid: '10019', name: '淮安市万家家具用品有限公司' } as UTSJSONObject,
+		{ id: 20, lid: '10020', name: '深圳市优派克电子有限公司销售部' } as UTSJSONObject,
+		{ id: 21, lid: '10021', name: '深圳市精博艺印刷有限公司采购部' } as UTSJSONObject,
+		{ id: 22, lid: '10022', name: '北京福茂源纸制品有限公司' } as UTSJSONObject,
+		{ id: 23, lid: '10023', name: '淮安苏粤食品有限公司' } as UTSJSONObject,
+		{ id: 24, lid: '10024', name: '巨龙燕泉饮品有限公司' } as UTSJSONObject,
+		{ id: 25, lid: '10025', name: '浙江嘉力宝精机股份有限公司' } as UTSJSONObject,
+		{ id: 26, lid: '10026', name: '嘉兴市南湖区欣鑫塑料厂' } as UTSJSONObject,
+		{ id: 27, lid: '10027', name: '太原晓旭物流服务部' } as UTSJSONObject,
+		{ id: 28, lid: '10028', name: '南昌三众实业有限公司' } as UTSJSONObject,
+		{ id: 29, lid: '10029', name: '无锡托普电子有限公司' } as UTSJSONObject,
+		{ id: 30, lid: '10030', name: '江阴市泰惠钢铁有限公司' } as UTSJSONObject,
+		{ id: 31, lid: '10031', name: '东莞泓锐国际货运有限公司' } as UTSJSONObject,
+		{ id: 32, lid: '10032', name: '苏必努商留有限公司业务部' } as UTSJSONObject,
+		{ id: 33, lid: '10033', name: '东莞菲迩康自动化设备有限公司' } as UTSJSONObject,
+		{ id: 34, lid: '10034', name: '恒盛贸易公司' } as UTSJSONObject,
+		{ id: 35, lid: '10035', name: '杭州华声汉腾文化发展有限公司' } as UTSJSONObject,
+		{ id: 36, lid: '10036', name: '固力锁业经营部' } as UTSJSONObject,
+		{ id: 37, lid: '10037', name: '江苏德生纺织印染公司营销部' } as UTSJSONObject,
+		{ id: 38, lid: '10038', name: '江都天都液压件有限公司' } as UTSJSONObject,
+		{ id: 39, lid: '10039', name: '潮安县金石镇彩联五金制品厂' } as UTSJSONObject,
+		{ id: 40, lid: '10040', name: '工西九江华卓工贸有限公司' } as UTSJSONObject,
+		{ id: 41, lid: '10041', name: '深圳市分分印刷有限公司' } as UTSJSONObject,
+		{ id: 42, lid: '10042', name: '上海乐金化学有限公司' } as UTSJSONObject
+	])
+	const list2 = ref<UTSJSONObject[]>([])
+	const refresTop = ref(false)
+	const refresBottom = ref(false)
+
+	const refreshLoad = () => {
+		setTimeout(() => {
+			refresTop.value = false;
+			uni.showToast({ 'title': "刷新成功", 'icon': "none" })
+		}, 1500);
+	}
+
+	const refresBottomhLoad = () => {
+		setTimeout(() => {
+			refresBottom.value = false;
+			uni.showToast({ 'title': "触底成功", 'icon': "none" })
+		}, 1500);
+	}
+
+	const onSearch = (keyword : string) => {
+		list2.value = ([
+			{ "id": 1, "text": "北京" } as UTSJSONObject,
+			{ "id": 2, "text": "上海" } as UTSJSONObject,
+			{ "id": 3, "text": "广州" } as UTSJSONObject,
+			{ "id": 4, "text": "深圳" } as UTSJSONObject,
+			{ "id": 5, "text": "杭州" } as UTSJSONObject,
+			{ "id": 6, "text": "成都" } as UTSJSONObject,
+			{ "id": 7, "text": "重庆" } as UTSJSONObject,
+			{ "id": 8, "text": "武汉" } as UTSJSONObject,
+			{ "id": 9, "text": "南京" } as UTSJSONObject,
+			{ "id": 10, "text": "西安" } as UTSJSONObject,
+			{ "id": 11, "text": "长沙" } as UTSJSONObject,
+			{ "id": 12, "text": "青岛" } as UTSJSONObject,
+			{ "id": 13, "text": "大连" } as UTSJSONObject,
+			{ "id": 14, "text": "厦门" } as UTSJSONObject,
+			{ "id": 15, "text": "苏州" } as UTSJSONObject,
+			{ "id": 16, "text": "天津" } as UTSJSONObject,
+			{ "id": 17, "text": "沈阳" } as UTSJSONObject,
+			{ "id": 18, "text": "哈尔滨" } as UTSJSONObject,
+			{ "id": 19, "text": "福州" } as UTSJSONObject,
+			{ "id": 20, "text": "济南" } as UTSJSONObject
+		] as UTSJSONObject[])
+			.filter((el : UTSJSONObject) : boolean => {
+				return (el.getString('text')!).indexOf(keyword) > -1
+			})
+	}
+</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//350/241/250/345/215/225/347/273/204/344/273/266//346/225/260/345/255/227/351/224/256/347/233/230 xKeyboardNumber.md"

@@ -0,0 +1,154 @@
+# 数字键盘 xKeyboardNumber
+
+## 介绍
+
+数字键盘,如果你要密码键盘见x-keyboard
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ☑ | ☑ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.1.18 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-keyboard-number/x-keyboard-number.uvue
+```
+
+## 使用
+
+```ts
+<x-keyboard-number></x-keyboard-number>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| modelValue | `当前输入的值`<br> | `string` | `""` |
+| maxLen | `最大长度`<br> | `number` | `9` |
+| modelShow | `当前打开的状态。`<br>`等同v-model:model-show`<br> | `boolean` | `false` |
+| title | `顶部标题，默认：安全键盘请放心输入`<br> | `string` | `""` |
+| color | `主按钮色，空值取全局主题`<br> | `string` | `""` |
+| btnColor | `按钮背景,暗黑时会取二级inputDarkbg灰`<br> | `string` | `'transparent'` |
+| bgColor | `键盘背景`<br> | `string` | `'info'` |
+| fontColor | `文字颜色,暗黑是会取白。`<br> | `string` | `'#3b3b3b'` |
+| max | `输入的最大值`<br>`默认0表示不限制。`<br> | `number` | `0` |
+| digit | `是否显示小数及00填充`<br> | `boolean` | `true` |
+| mode | `模式`<br>`number 数字键盘`<br>`password 密码键盘,作为密码用，那就不会限制数字模式就当字符串使用。`<br> | `string` | `"number"` |
+| hold | `点击确认是否保持键盘不收起`<br> | `boolean` | `false` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| change | `value: string<br>` | 值变化时触发 |
+| update:modelShow | `-` | 变量控制打开状态<br>等同v-model:model-show |
+| confirm | `value: string<br>` | 确认时触发 |
+| cancel | `value: string<br>` | 关闭取消时触发 |
+| update:modelValue | `-` | - |
+
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| default | `插槽,默认触发打开选择器。你的默认布局可以放置在这里。` | show: boolean<br> |
+
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| - | - | - | - |
+
+## 示例文件路径
+
+```json
+/pages/biaodan/keyboard
+```
+
+## 示例源码
+
+```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">键盘 Keyboard</x-text>
+		<x-text color="#999999" >允许小数点，整数，最大长度的控制,可定制性强</x-text>
+		
+		<x-sheet dark-color="#333" :margin="['0','16']" color="#f5f5f5">
+			<x-text>输入的值：{{price}}</x-text>
+		</x-sheet>
+		<x-keyboard-number :max="100" v-model="price">
+			<x-button :block="true">打开默认键盘(控制最大100)</x-button>
+		</x-keyboard-number>
+		<x-keyboard-number :digit="false" :max="100" v-model="price">
+			<x-button class="mt-20" :block="true">整数键盘</x-button>
+		</x-keyboard-number>
+		
+	</x-sheet>
+	
+
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-24">通过属性定制不同样式键盘</x-text>
+		<x-keyboard-number btn-color="white" v-model="price">
+			<x-button  class="mb-24" color="info" darkColor="#333" :block="true">打开白色键盘</x-button>
+		</x-keyboard-number>
+		<x-keyboard-number bg-color="#111111" btn-color="#232323" font-color="#f0f0f0" v-model="price">
+			<x-button color='success' :block="true">打开黑色键盘</x-button>
+		</x-keyboard-number>
+	</x-sheet>
+	
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-24">密码键盘</x-text>
+		
+		<x-keyboard v-model="password">
+			<x-button darkColor="#333" color="info" :block="true">打开密码键盘</x-button>
+		</x-keyboard>
+		
+	</x-sheet>
+
+	
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-24">身份证键盘</x-text>
+		<x-keyboard-idcard>
+			<x-button darkColor="#333" :block="true">打开身份证键盘</x-button>
+		</x-keyboard-idcard>
+	</x-sheet>
+	
+	<x-sheet>
+		<x-text font-size="18" class=" text-weight-b mb-24">车牌键盘</x-text>
+		<x-keyboard-car>
+			<x-button darkColor="#333" :block="true">打开车牌键盘</x-button>
+		</x-keyboard-car>
+	</x-sheet>
+	
+	
+	<view style="height: 50px;"></view>
+
+</template>
+
+<script setup>
+	const price = ref("")
+	const password = ref("")
+	
+</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//350/241/250/345/215/225/347/273/204/344/273/266//346/226/207/344/273/266/351/200/211/346/213/251 xUploadFile.md"

@@ -0,0 +1,136 @@
+# 文件选择 xUploadFile
+
+## 介绍
+
+选择文件使用 x-chooseFile-s 插件。没有提供双向绑定，请根据 change 事件保存数据。微信端请保证小程序隐私政策中勾选了相关权限。
+
+## 平台兼容
+
+| Harmony | H5 | andriod | IOS | 小程序 | UTS | UNIAPP-X SDK | version |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ☑ | ☑ | ☑️ | ☑️ | ☑️ | ☑️ | 4.76+ | 1.1.18 |
+
+## 文件路径
+
+```ts
+@/uni_modules/tmx-ui/components/x-upload-file/x-upload-file.uvue
+```
+
+## 使用
+
+```ts
+<x-upload-file></x-upload-file>
+```
+
+## Props 属性
+
+| 名称 | 说明 | 类型 | 默认值 |
+| ------ | ---- | ---- | ---- |
+| defaultList | `提供的默认上传的文件列表`<br>`请确保要有以下三个字段：`<br>`1.name`<br>`2.type`<br>`3.request 你服务器自己构造的成功数据，例：{code,data,msg}`<br>`小心的是，如果你变动了此值，内部会把默认当前的列表数据清空，直接用此列表替换。这样你在表单加载数据更新编辑时`<br>`会很有用。`<br> | `Array` | `() : UTSJSONObject[] => ([] as UTSJSONObject[])` |
+| header | `头部数据`<br> | `union` | `() : UTSJSONObject   null => {     return null }` |
+| name | `文件上传的字段名称`<br> | `string` | `"file"` |
+| formData | `表单数据`<br> | `union` | `() : UTSJSONObject   null => {     return null }` |
+| url | `服务器上传地址`<br> | `string` | `"https://mockapi.eolink.com/LRViGGZ8e6c1e8b4a636cd82bca1eb15d2635ed8c74e774/admin/upload_pic/"` |
+| maxCount | `最大上传数量`<br>`-1表示不限制`<br> | `number` | `-1` |
+| multiple | `是否多选`<br> | `boolean` | `true` |
+| maxFileSize | `最大文件大小,单位字节`<br>`超过此大小的文件不会被上传。30*1024*1024`<br> | `number` | `30 * 1024 * 1024` |
+| loading | `当前是否在上传中`<br>`请使用v-model:loading来`<br>`不可更改此值。`<br> | `boolean` | `true` |
+| autoStart | `选择文件后自动上传`<br> | `boolean` | `true` |
+| statusCode | `服务正常返回的状态码如果为此值表示失败。`<br> | `number` | `200` |
+| disabled | `禁用上传功能`<br> | `boolean` | `false` |
+| uploadFileDisabledDel | `已上传的文件是否禁用删除`<br>`这个是某些特殊的erp系统中的需求需要。`<br> | `boolean` | `false` |
+| filter | `文件过滤器,不要动态修改。`<br>`空数组时为所有文件类型。`<br>`如:["jpg","docx","doc","webp"]，对应 x-chooseFile-s 的 extension。`<br> | `Array` | `() : string[] => [] as string[]` |
+| borderBottomColor | `底部线条颜色`<br> | `string` | `"#f5f5f5"` |
+| beforeUpload | `上传前执行的函数勾子,如果不会使用见demo`<br>`类型:(lsit:XUploadFileItem[]) => Promise<XUploadFileItem[]>`<br>`这里可以过滤不需要上传的文件.`<br> | `XFILESUPLOAD_BEFORE_CALLBACK` | `(list : XUploadFileItem[]) : Promise<XUploadFileItem[]> => {     return Promise.resolve(list) }` |
+
+
+## Events 事件
+
+| 名称 | 参数 | 说明 |
+| ------ | ---- | ---- |
+| change | `-` | 只有删除和上传完成时才会触发<br>并返回当前的文件列表。 |
+
+
+## Slots 插槽
+
+| 名称 | 说明 | 数据 |
+| ------ | ---- | ---- |
+| default | `触发文件选择的区域插槽` | - |
+| list | `-` | - |
+
+
+## Ref 方法
+
+| 名称 | 参数 | 返回值 | 说明 |
+| ------ | ---- | ---- | ---- |
+| start | - | `-` | 上传文件列表 |
+| clearCacheFiles | - | `-` | 清理已选文件的本地缓存 |
+
+
+## 示例文件路径
+
+```json
+/pages/biaodan/upload-file
+```
+
+## 示例源码
+
+```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">文件选择 xUploadFile</x-text>
+			<x-text color="#999999">选择文件使用 x-chooseFile-s 插件，安卓、iOS、鸿蒙、Web、微信小程序接口对齐。</x-text>
+			<x-text color="#999999">微信小程序使用前:请确保授权相关文件选择权限.</x-text>
+		</x-sheet>
+
+
+
+		<x-sheet>
+			<x-upload-file :before-upload="bef" :auto-start="true" ref='filse' @change="onchange"
+				:default-list="list"></x-upload-file>
+			<x-button @click="upl" :block="true" class="mt-20" skin="thin">手动上传</x-button>
+		</x-sheet>
+</template>
+
+<script setup>
+	import { XUploadFileItem } from "@/uni_modules/tmx-ui/components/x-upload-file/interface.uts"
+	// @ts-ignore
+	const filse = ref<XUploadFileComponentPublicInstance | null>(null)
+	const list = [
+		{ name: "测试文档.doc", type: "doc", id: "1", request: "{code:1,data:'11',msg:'成功'}" } as UTSJSONObject,
+		{ name: "测试服务默认文件22.mp4", type: "mp4", id: "2", request: "{code:1,data:'22',msg:'成功'}" } as UTSJSONObject,
+	] as UTSJSONObject[]
+
+	const onchange = (list : XUploadFileItem[]) => {
+		// console.log(list)
+		// uni.redirectTo({
+		// 	url:"/pages/index/upload-file"
+		// })
+	}
+
+	const upl = () => {
+		filse.value?.start?.()
+	}
+	const bef = (list : XUploadFileItem[]) : Promise<XUploadFileItem[]> => {
+		console.log(list)
+		// 处理或者过滤好list再返回来就可以过滤掉待要或者已经上传的文件.
+		return Promise.resolve(list)
+	}
+</script>
+
+<style>
+
+</style>
+```
+
+---
+
+## 版权
+
+@2026 tmui4x [https://xui.tmui.design](https://xui.tmui.design)