uview-pro 0.6.18 → 0.6.19

package/components/u-circle-progress/u-circle-progress.vue

@@ -1,299 +1,299 @@
-<template>
-    <view
-        class="u-circle-progress"
-        :class="customClass"
-        :style="
-            $u.toStyle(
-                {
-                    width: widthPx + 'px',
-                    height: widthPx + 'px',
-                    backgroundColor: bgColor
-                },
-                customStyle
-            )
-        "
-    >
-        <!-- 支付宝小程序不支持canvas-id属性，必须用id属性 -->
-        <!-- #ifdef MP-WEIXIN || MP-TOUTIAO -->
-        <canvas
-            class="u-canvas-bg"
-            type="2d"
-            :canvas-id="elBgId"
-            :id="elBgId"
-            :style="{
-                width: widthPx + 'px',
-                height: widthPx + 'px'
-            }"
-        ></canvas>
-        <canvas
-            class="u-canvas"
-            type="2d"
-            :canvas-id="elId"
-            :id="elId"
-            :style="{
-                width: widthPx + 'px',
-                height: widthPx + 'px'
-            }"
-        ></canvas>
-        <!-- #endif -->
-        <!-- #ifndef MP-WEIXIN || MP-TOUTIAO -->
-        <canvas
-            class="u-canvas-bg"
-            :canvas-id="elBgId"
-            :id="elBgId"
-            :style="{
-                width: widthPx + 'px',
-                height: widthPx + 'px'
-            }"
-        ></canvas>
-        <canvas
-            class="u-canvas"
-            :canvas-id="elId"
-            :id="elId"
-            :style="{
-                width: widthPx + 'px',
-                height: widthPx + 'px'
-            }"
-        ></canvas>
-        <!-- #endif -->
-        <slot></slot>
-    </view>
-</template>
-
-<script lang="ts">
-export default {
-    name: 'u-circle-progress',
-    options: {
-        addGlobalClass: true,
-        // #ifndef MP-TOUTIAO
-        virtualHost: true,
-        // #endif
-        styleIsolation: 'shared'
-    }
-};
-</script>
-
-<script setup lang="ts">
-import { ref, computed, watch, onMounted, getCurrentInstance, onBeforeMount } from 'vue';
-import { $u } from '../..';
-import { CircleProgressProps } from './types';
-// #ifdef MP-WEIXIN || MP-TOUTIAO
-import { canvas2d } from '../../libs/util/canvas-2d';
-// #endif
-
-/**
- * circleProgress 环形进度条
- * @description 展示操作或任务的当前进度，比如上传文件，是一个圆形的进度条。注意：此组件的percent值只能动态增加，不能动态减少。
- * @tutorial https://uviewpro.cn/zh/components/circleProgress.html
- * @property {String Number} percent 圆环进度百分比值，为数值类型，0-100
- * @property {String} inactive-color 圆环的底色，默认为灰色(该值无法动态变更)（默认var(--u-divider-color)）
- * @property {String} active-color 圆环激活部分的颜色(该值无法动态变更)（默认var(--u-type-success)）
- * @property {String Number} width 整个圆环组件的宽度，高度默认等于宽度值，单位rpx（默认200）
- * @property {String Number} border-width 圆环的边框宽度，单位rpx（默认14）
- * @property {String Number} duration 整个圆环执行一圈的时间，单位ms（默认呢1500）
- * @property {String} type 如设置，active-color值将会失效
- * @property {String} bg-color 整个组件背景颜色，默认为白色
- * @example <u-circle-progress active-color="var(--u-type-primary)" :percent="80"></u-circle-progress>
- */
-const props = defineProps(CircleProgressProps);
-
-let elBgId = $u.guid(); // 非微信端的时候，需用动态的id，否则一个页面多个圆形进度条组件数据会混乱
-let elId = $u.guid();
-// #ifdef MP-WEIXIN || MP-TOUTIAO
-// elBgId = 'uCircleProgressBgId'; // 微信小程序中不能使用$u.guid()形式动态生成id值，否则会报错
-// elId = 'uCircleProgressElId';
-// #endif
-const instance = getCurrentInstance();
-
-const pixelRatio = ref<number>(1); // 像素比
-
-// 存储 MP-WEIXIN 下通过 selectorQuery 获取到的 canvas node，方便在绘制前清空
-const canvasNodeMap = new Map<string, any>();
-
-const widthPx = computed(() =>
-    typeof uni !== 'undefined' && uni.upx2px ? uni.upx2px(Number(props.width)) : Number(props.width)
-);
-const borderWidthPx = computed(() =>
-    typeof uni !== 'undefined' && uni.upx2px ? uni.upx2px(Number(props.borderWidth)) : Number(props.borderWidth)
-);
-const startAngle = -Math.PI / 2; // canvas画圆的起始角度，默认为3点钟方向，定位到12点钟方向
-const progressContext = ref<any>(null); // 活动圆的canvas上下文
-const newPercent = ref(props.percent); // 当动态修改进度值的时候，保存进度值的变化前后值，用于比较用
-const oldPercent = ref(0); // 当动态修改进度值的时候，保存进度值的变化前后值，用于比较用
-
-/**
- * 有type主题时，优先起作用
- */
-const circleColor = computed(() => {
-    if (props.type && ['success', 'error', 'info', 'primary', 'warning'].includes(props.type)) {
-        return $u.color[props.type as keyof typeof $u.color] as string;
-    }
-    return props.activeColor;
-});
-
-onBeforeMount(() => {
-    pixelRatio.value = uni.getSystemInfoSync().pixelRatio;
-});
-
-// 监听percent变化，动态绘制进度
-watch(
-    () => props.percent,
-    (nVal, oVal = 0) => {
-        let next = nVal > 100 ? 100 : nVal;
-        let prev = oVal < 0 ? 0 : oVal;
-        newPercent.value = next;
-        oldPercent.value = prev;
-        setTimeout(() => {
-            // 无论是百分比值增加还是减少，需要操作还是原来的旧的百分比值
-            // 将此值减少或者新增到新的百分比值
-            drawCircleByProgress(prev);
-        }, 50);
-    }
-);
-
-onMounted(() => {
-    // 赋值，用于加载后第一个画圆使用
-    newPercent.value = props.percent;
-    oldPercent.value = 0;
-    // 在h5端，必须要做一点延时才起作用，this.$nextTick()无效(HX2.4.7)
-    setTimeout(() => {
-        drawProgressBg();
-        drawCircleByProgress(oldPercent.value);
-    }, 50);
-});
-
-/**
- * 获取canvas上下文
- */
-function getContext(canvasId: any) {
-    return new Promise<UniApp.CanvasContext>(resolve => {
-        let ctx = null;
-        // #ifndef MP-WEIXIN || MP-TOUTIAO
-        ctx = uni.createCanvasContext(canvasId, instance);
-        resolve(ctx);
-        // #endif
-        // #ifdef MP-WEIXIN || MP-TOUTIAO
-        uni.createSelectorQuery()
-            .in(instance?.proxy)
-            .select(`#${canvasId}`)
-            .node(res => {
-                if (res && res.node) {
-                    const canvas = res.node;
-                    ctx = canvas2d(canvas.getContext('2d') as CanvasRenderingContext2D);
-                    canvas.width = widthPx.value * pixelRatio.value;
-                    canvas.height = widthPx.value * pixelRatio.value;
-                    ctx.scale(pixelRatio.value, pixelRatio.value);
-                    // 存储 canvas node，后续绘制时用于清空画布
-                    canvasNodeMap.set(canvasId, canvas);
-                    resolve(ctx);
-                }
-            })
-            .exec();
-        // #endif
-    });
-}
-
-/**
- * 绘制底部灰色圆环
- */
-async function drawProgressBg() {
-    const ctx = await getContext(elBgId);
-    // #ifdef MP-WEIXIN || MP-TOUTIAO
-    // 清空背景画布（如果可用）以确保绘制一致性
-    try {
-        if (typeof ctx.clearRect === 'function') {
-            const node = canvasNodeMap.get(elBgId);
-            const w = node ? node.width : widthPx.value * pixelRatio.value;
-            const h = node ? node.height : widthPx.value * pixelRatio.value;
-            ctx.clearRect(0, 0, w, h);
-        }
-    } catch (e) {
-        // ignore
-    }
-    // #endif
-    ctx.setLineWidth(borderWidthPx.value); // 设置圆环宽度
-    ctx.setStrokeStyle(props.inactiveColor); // 线条颜色
-    ctx.beginPath(); // 开始描绘路径
-    const radius = widthPx.value / 2; // 设置一个原点(110,110)，半径为100的圆的路径到当前路径
-    ctx.arc(radius, radius, radius - borderWidthPx.value, 0, 2 * Math.PI, false);
-    ctx.stroke(); // 对路径进行描绘
-    ctx.draw();
-}
-
-/**
- * 绘制进度圆环
- * @param progress 当前进度
- */
-async function drawCircleByProgress(progress: number) {
-    // 第一次操作进度环时将上下文保存到了this.data中，直接使用即可
-    let ctx = progressContext.value;
-    if (!ctx) {
-        ctx = await getContext(elId);
-        progressContext.value = ctx;
-    }
-    // #ifdef MP-WEIXIN || MP-TOUTIAO
-    // 清空进度画布，避免旧的更大进度残留，导致无法降低的视觉错误
-    try {
-        if (typeof ctx.clearRect === 'function') {
-            const node = canvasNodeMap.get(elId);
-            const w = node ? node.width : widthPx.value * pixelRatio.value;
-            const h = node ? node.height : widthPx.value * pixelRatio.value;
-            ctx.clearRect(0, 0, w, h);
-        }
-    } catch (e) {
-        // ignore
-    }
-    // #endif
-    // 表示进度的两端为圆形
-    ctx.setLineCap('round');
-    // 设置线条的宽度和颜色
-    ctx.setLineWidth(borderWidthPx.value);
-    ctx.setStrokeStyle(circleColor.value);
-    // 将总过渡时间除以100，得出每修改百分之一进度所需的时间
-    let time = Math.floor(Number(props.duration) / 100);
-    // 结束角的计算依据为：将2π分为100份，乘以当前的进度值，得出终止点的弧度值，加起始角，为整个圆从默认的
-    // 3点钟方向开始画图，转为更好理解的12点钟方向开始作图，这需要起始角和终止角同时加上this.startAngle值
-    let endAngle = ((2 * Math.PI) / 100) * progress + startAngle;
-    ctx.beginPath();
-    // 半径为整个canvas宽度的一半
-    let radius = widthPx.value / 2;
-    ctx.arc(radius, radius, radius - borderWidthPx.value, startAngle, endAngle, false);
-    ctx.stroke();
-    ctx.draw();
-    // 如果变更后新值大于旧值，意味着增大了百分比
-    if (newPercent.value > oldPercent.value) {
-        // 每次递增百分之一
-        progress++;
-        // 如果新增后的值，大于需要设置的值百分比值，停止继续增加
-        if (progress > newPercent.value) return;
-    } else {
-        // 同理于上面
-        progress--;
-        if (progress < newPercent.value) return;
-    }
-    setTimeout(() => {
-        // 定时器，每次操作间隔为time值，为了让进度条有动画效果
-        drawCircleByProgress(progress);
-    }, time);
-}
-</script>
-
-<style lang="scss" scoped>
-@import '../../libs/css/style.components.scss';
-.u-circle-progress {
-    position: relative;
-    /* #ifndef APP-NVUE */
-    display: inline-flex;
-    /* #endif */
-    align-items: center;
-    justify-content: center;
-}
-
-.u-canvas-bg {
-    position: absolute;
-}
-
-.u-canvas {
-    position: absolute;
-}
-</style>
+<template>
+    <view
+        class="u-circle-progress"
+        :class="customClass"
+        :style="
+            $u.toStyle(
+                {
+                    width: widthPx + 'px',
+                    height: widthPx + 'px',
+                    backgroundColor: bgColor
+                },
+                customStyle
+            )
+        "
+    >
+        <!-- 支付宝小程序不支持canvas-id属性，必须用id属性 -->
+        <!-- #ifdef MP-WEIXIN || MP-TOUTIAO -->
+        <canvas
+            class="u-canvas-bg"
+            type="2d"
+            :canvas-id="elBgId"
+            :id="elBgId"
+            :style="{
+                width: widthPx + 'px',
+                height: widthPx + 'px'
+            }"
+        ></canvas>
+        <canvas
+            class="u-canvas"
+            type="2d"
+            :canvas-id="elId"
+            :id="elId"
+            :style="{
+                width: widthPx + 'px',
+                height: widthPx + 'px'
+            }"
+        ></canvas>
+        <!-- #endif -->
+        <!-- #ifndef MP-WEIXIN || MP-TOUTIAO -->
+        <canvas
+            class="u-canvas-bg"
+            :canvas-id="elBgId"
+            :id="elBgId"
+            :style="{
+                width: widthPx + 'px',
+                height: widthPx + 'px'
+            }"
+        ></canvas>
+        <canvas
+            class="u-canvas"
+            :canvas-id="elId"
+            :id="elId"
+            :style="{
+                width: widthPx + 'px',
+                height: widthPx + 'px'
+            }"
+        ></canvas>
+        <!-- #endif -->
+        <slot></slot>
+    </view>
+</template>
+
+<script lang="ts">
+export default {
+    name: 'u-circle-progress',
+    options: {
+        addGlobalClass: true,
+        // #ifndef MP-TOUTIAO
+        virtualHost: true,
+        // #endif
+        styleIsolation: 'shared'
+    }
+};
+</script>
+
+<script setup lang="ts">
+import { ref, computed, watch, onMounted, getCurrentInstance, onBeforeMount } from 'vue';
+import { $u } from '../..';
+import { CircleProgressProps } from './types';
+// #ifdef MP-WEIXIN || MP-TOUTIAO
+import { canvas2d } from '../../libs/util/canvas-2d';
+// #endif
+
+/**
+ * circleProgress 环形进度条
+ * @description 展示操作或任务的当前进度，比如上传文件，是一个圆形的进度条。注意：此组件的percent值只能动态增加，不能动态减少。
+ * @tutorial https://uviewpro.cn/zh/components/circleProgress.html
+ * @property {String Number} percent 圆环进度百分比值，为数值类型，0-100
+ * @property {String} inactive-color 圆环的底色，默认为灰色(该值无法动态变更)（默认var(--u-divider-color)）
+ * @property {String} active-color 圆环激活部分的颜色(该值无法动态变更)（默认var(--u-type-success)）
+ * @property {String Number} width 整个圆环组件的宽度，高度默认等于宽度值，单位rpx（默认200）
+ * @property {String Number} border-width 圆环的边框宽度，单位rpx（默认14）
+ * @property {String Number} duration 整个圆环执行一圈的时间，单位ms（默认呢1500）
+ * @property {String} type 如设置，active-color值将会失效
+ * @property {String} bg-color 整个组件背景颜色，默认为白色
+ * @example <u-circle-progress active-color="var(--u-type-primary)" :percent="80"></u-circle-progress>
+ */
+const props = defineProps(CircleProgressProps);
+
+let elBgId = $u.guid(); // 非微信端的时候，需用动态的id，否则一个页面多个圆形进度条组件数据会混乱
+let elId = $u.guid();
+// #ifdef MP-WEIXIN || MP-TOUTIAO
+// elBgId = 'uCircleProgressBgId'; // 微信小程序中不能使用$u.guid()形式动态生成id值，否则会报错
+// elId = 'uCircleProgressElId';
+// #endif
+const instance = getCurrentInstance();
+
+const pixelRatio = ref<number>(1); // 像素比
+
+// 存储 MP-WEIXIN 下通过 selectorQuery 获取到的 canvas node，方便在绘制前清空
+const canvasNodeMap = new Map<string, any>();
+
+const widthPx = computed(() =>
+    typeof uni !== 'undefined' && uni.upx2px ? uni.upx2px(Number(props.width)) : Number(props.width)
+);
+const borderWidthPx = computed(() =>
+    typeof uni !== 'undefined' && uni.upx2px ? uni.upx2px(Number(props.borderWidth)) : Number(props.borderWidth)
+);
+const startAngle = -Math.PI / 2; // canvas画圆的起始角度，默认为3点钟方向，定位到12点钟方向
+const progressContext = ref<any>(null); // 活动圆的canvas上下文
+const newPercent = ref(props.percent); // 当动态修改进度值的时候，保存进度值的变化前后值，用于比较用
+const oldPercent = ref(0); // 当动态修改进度值的时候，保存进度值的变化前后值，用于比较用
+
+/**
+ * 有type主题时，优先起作用
+ */
+const circleColor = computed(() => {
+    if (props.type && ['success', 'error', 'info', 'primary', 'warning'].includes(props.type)) {
+        return $u.color[props.type as keyof typeof $u.color] as string;
+    }
+    return props.activeColor;
+});
+
+onBeforeMount(() => {
+    pixelRatio.value = uni.getSystemInfoSync().pixelRatio;
+});
+
+// 监听percent变化，动态绘制进度
+watch(
+    () => props.percent,
+    (nVal, oVal = 0) => {
+        let next = nVal > 100 ? 100 : nVal;
+        let prev = oVal < 0 ? 0 : oVal;
+        newPercent.value = next;
+        oldPercent.value = prev;
+        setTimeout(() => {
+            // 无论是百分比值增加还是减少，需要操作还是原来的旧的百分比值
+            // 将此值减少或者新增到新的百分比值
+            drawCircleByProgress(prev);
+        }, 50);
+    }
+);
+
+onMounted(() => {
+    // 赋值，用于加载后第一个画圆使用
+    newPercent.value = props.percent;
+    oldPercent.value = 0;
+    // 在h5端，必须要做一点延时才起作用，this.$nextTick()无效(HX2.4.7)
+    setTimeout(() => {
+        drawProgressBg();
+        drawCircleByProgress(oldPercent.value);
+    }, 50);
+});
+
+/**
+ * 获取canvas上下文
+ */
+function getContext(canvasId: any) {
+    return new Promise<UniApp.CanvasContext>(resolve => {
+        let ctx = null;
+        // #ifndef MP-WEIXIN || MP-TOUTIAO
+        ctx = uni.createCanvasContext(canvasId, instance);
+        resolve(ctx);
+        // #endif
+        // #ifdef MP-WEIXIN || MP-TOUTIAO
+        uni.createSelectorQuery()
+            .in(instance?.proxy)
+            .select(`#${canvasId}`)
+            .node(res => {
+                if (res && res.node) {
+                    const canvas = res.node;
+                    ctx = canvas2d(canvas.getContext('2d') as CanvasRenderingContext2D);
+                    canvas.width = widthPx.value * pixelRatio.value;
+                    canvas.height = widthPx.value * pixelRatio.value;
+                    ctx.scale(pixelRatio.value, pixelRatio.value);
+                    // 存储 canvas node，后续绘制时用于清空画布
+                    canvasNodeMap.set(canvasId, canvas);
+                    resolve(ctx);
+                }
+            })
+            .exec();
+        // #endif
+    });
+}
+
+/**
+ * 绘制底部灰色圆环
+ */
+async function drawProgressBg() {
+    const ctx = await getContext(elBgId);
+    // #ifdef MP-WEIXIN || MP-TOUTIAO
+    // 清空背景画布（如果可用）以确保绘制一致性
+    try {
+        if (typeof ctx.clearRect === 'function') {
+            const node = canvasNodeMap.get(elBgId);
+            const w = node ? node.width : widthPx.value * pixelRatio.value;
+            const h = node ? node.height : widthPx.value * pixelRatio.value;
+            ctx.clearRect(0, 0, w, h);
+        }
+    } catch (e) {
+        // ignore
+    }
+    // #endif
+    ctx.setLineWidth(borderWidthPx.value); // 设置圆环宽度
+    ctx.setStrokeStyle(props.inactiveColor); // 线条颜色
+    ctx.beginPath(); // 开始描绘路径
+    const radius = widthPx.value / 2; // 设置一个原点(110,110)，半径为100的圆的路径到当前路径
+    ctx.arc(radius, radius, radius - borderWidthPx.value, 0, 2 * Math.PI, false);
+    ctx.stroke(); // 对路径进行描绘
+    ctx.draw();
+}
+
+/**
+ * 绘制进度圆环
+ * @param progress 当前进度
+ */
+async function drawCircleByProgress(progress: number) {
+    // 第一次操作进度环时将上下文保存到了this.data中，直接使用即可
+    let ctx = progressContext.value;
+    if (!ctx) {
+        ctx = await getContext(elId);
+        progressContext.value = ctx;
+    }
+    // #ifdef MP-WEIXIN || MP-TOUTIAO
+    // 清空进度画布，避免旧的更大进度残留，导致无法降低的视觉错误
+    try {
+        if (typeof ctx.clearRect === 'function') {
+            const node = canvasNodeMap.get(elId);
+            const w = node ? node.width : widthPx.value * pixelRatio.value;
+            const h = node ? node.height : widthPx.value * pixelRatio.value;
+            ctx.clearRect(0, 0, w, h);
+        }
+    } catch (e) {
+        // ignore
+    }
+    // #endif
+    // 表示进度的两端为圆形
+    ctx.setLineCap('round');
+    // 设置线条的宽度和颜色
+    ctx.setLineWidth(borderWidthPx.value);
+    ctx.setStrokeStyle(circleColor.value);
+    // 将总过渡时间除以100，得出每修改百分之一进度所需的时间
+    let time = Math.floor(Number(props.duration) / 100);
+    // 结束角的计算依据为：将2π分为100份，乘以当前的进度值，得出终止点的弧度值，加起始角，为整个圆从默认的
+    // 3点钟方向开始画图，转为更好理解的12点钟方向开始作图，这需要起始角和终止角同时加上this.startAngle值
+    let endAngle = ((2 * Math.PI) / 100) * progress + startAngle;
+    ctx.beginPath();
+    // 半径为整个canvas宽度的一半
+    let radius = widthPx.value / 2;
+    ctx.arc(radius, radius, radius - borderWidthPx.value, startAngle, endAngle, false);
+    ctx.stroke();
+    ctx.draw();
+    // 如果变更后新值大于旧值，意味着增大了百分比
+    if (newPercent.value > oldPercent.value) {
+        // 每次递增百分之一
+        progress++;
+        // 如果新增后的值，大于需要设置的值百分比值，停止继续增加
+        if (progress > newPercent.value) return;
+    } else {
+        // 同理于上面
+        progress--;
+        if (progress < newPercent.value) return;
+    }
+    setTimeout(() => {
+        // 定时器，每次操作间隔为time值，为了让进度条有动画效果
+        drawCircleByProgress(progress);
+    }, time);
+}
+</script>
+
+<style lang="scss" scoped>
+@import '../../libs/css/style.components.scss';
+.u-circle-progress {
+    position: relative;
+    /* #ifndef APP-NVUE */
+    display: inline-flex;
+    /* #endif */
+    align-items: center;
+    justify-content: center;
+}
+
+.u-canvas-bg {
+    position: absolute;
+}
+
+.u-canvas {
+    position: absolute;
+}
+</style>

package/components/u-city-select/types.ts

@@ -1,30 +1,30 @@
-import type { ExtractPropTypes, PropType } from 'vue';
-
-/**
- * u-city-select 城市选择器 Props
- * @description 用于选择省、市、区三级行政区域，支持回显和自定义初始值。
- */
-export const CitySelectProps = {
-    /** 自定义根节点样式 */
-    customStyle: {
-        type: [String, Object] as PropType<string | Record<string, any>>,
-        default: () => ({})
-    },
-    /** 自定义根节点样式类 */
-    customClass: {
-        type: String as unknown as PropType<string>,
-        default: ''
-    },
-    /** 控制弹窗显示与隐藏（v-model） */
-    modelValue: { type: Boolean, default: false },
-    /** 默认选中的省市区名称数组 */
-    defaultRegion: { type: Array as PropType<string[]>, default: () => [] },
-    /** 默认选中的省市区编码数组 */
-    areaCode: { type: Array as PropType<string[]>, default: () => [] },
-    /** 是否允许点击遮罩关闭弹窗 */
-    maskCloseAble: { type: Boolean, default: true },
-    /** 弹窗层级 */
-    zIndex: { type: [String, Number] as PropType<string | number>, default: 0 }
-};
-
-export type CitySelectProps = ExtractPropTypes<typeof CitySelectProps>;
+import type { ExtractPropTypes, PropType } from 'vue';
+
+/**
+ * u-city-select 城市选择器 Props
+ * @description 用于选择省、市、区三级行政区域，支持回显和自定义初始值。
+ */
+export const CitySelectProps = {
+    /** 自定义根节点样式 */
+    customStyle: {
+        type: [String, Object] as PropType<string | Record<string, any>>,
+        default: () => ({})
+    },
+    /** 自定义根节点样式类 */
+    customClass: {
+        type: String as unknown as PropType<string>,
+        default: ''
+    },
+    /** 控制弹窗显示与隐藏（v-model） */
+    modelValue: { type: Boolean, default: false },
+    /** 默认选中的省市区名称数组 */
+    defaultRegion: { type: Array as PropType<string[]>, default: () => [] },
+    /** 默认选中的省市区编码数组 */
+    areaCode: { type: Array as PropType<string[]>, default: () => [] },
+    /** 是否允许点击遮罩关闭弹窗 */
+    maskCloseAble: { type: Boolean, default: true },
+    /** 弹窗层级 */
+    zIndex: { type: [String, Number] as PropType<string | number>, default: 0 }
+};
+
+export type CitySelectProps = ExtractPropTypes<typeof CitySelectProps>;