uview-pro 0.0.1

package/components/u-dropdown/u-dropdown.vue

@@ -0,0 +1,311 @@
+<template>
+    <view class="u-dropdown">
+        <view class="u-dropdown__menu" :style="{ height: $u.addUnit(height) }" :class="{ 'u-border-bottom': borderBottom }">
+            <view class="u-dropdown__menu__item" v-for="(item, index) in menuList" :key="index" @tap.stop="menuClick(index)">
+                <view class="u-flex">
+                    <text
+                        class="u-dropdown__menu__item__text"
+                        :style="{
+                            color: item.disabled ? '#c0c4cc' : index === current || highlightIndex == index ? activeColor : inactiveColor,
+                            fontSize: $u.addUnit(titleSize)
+                        }"
+                        >{{ item.title }}</text
+                    >
+                    <view
+                        class="u-dropdown__menu__item__arrow"
+                        :class="{
+                            'u-dropdown__menu__item__arrow--rotate': index === current
+                        }"
+                    >
+                        <u-icon
+                            :custom-style="{ display: 'flex' }"
+                            :name="menuIcon"
+                            :size="$u.addUnit(menuIconSize)"
+                            :color="index === current || highlightIndex == index ? activeColor : '#c0c4cc'"
+                        ></u-icon>
+                    </view>
+                </view>
+            </view>
+        </view>
+        <view
+            class="u-dropdown__content"
+            :style="[
+                contentStyle,
+                {
+                    transition: `opacity ${Number(duration) / 1000}s linear`,
+                    top: $u.addUnit(height),
+                    height: contentHeight + 'px'
+                }
+            ]"
+            @tap="maskClick"
+            @touchmove.stop.prevent
+        >
+            <view @tap.stop.prevent class="u-dropdown__content__popup" :style="[popupStyle]">
+                <slot></slot>
+            </view>
+            <view class="u-dropdown__content__mask"></view>
+        </view>
+    </view>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, onMounted, getCurrentInstance } from 'vue';
+import { $u } from '../..';
+
+defineOptions({ name: 'u-dropdown' });
+
+/**
+ * dropdown 下拉菜单
+ * @description 该组件一般用于向下展开菜单，同时可切换多个选项卡的场景
+ * @tutorial http://uviewui.com/components/dropdown.html
+ * @property {String} active-color 标题和选项卡选中的颜色（默认#2979ff）
+ * @property {String} inactive-color 标题和选项卡未选中的颜色（默认#606266）
+ * @property {Boolean} close-on-click-mask 点击遮罩是否关闭菜单（默认true）
+ * @property {Boolean} close-on-click-self 点击当前激活项标题是否关闭菜单（默认true）
+ * @property {String | Number} duration 选项卡展开和收起的过渡时间，单位ms（默认300）
+ * @property {String | Number} height 标题菜单的高度，单位任意（默认80）
+ * @property {String | Number} border-radius 菜单展开内容下方的圆角值，单位任意（默认0）
+ * @property {Boolean} border-bottom 标题菜单是否显示下边框（默认false）
+ * @property {String | Number} title-size 标题的字体大小，单位任意，数值默认为rpx单位（默认28）
+ * @event {Function} open 下拉菜单被打开时触发
+ * @event {Function} close 下拉菜单被关闭时触发
+ * @example <u-dropdown></u-dropdown>
+ */
+
+const props = defineProps({
+    /** 菜单标题和选项的激活态颜色 */
+    activeColor: { type: String, default: '#2979ff' },
+    /** 菜单标题和选项的未激活态颜色 */
+    inactiveColor: { type: String, default: '#606266' },
+    /** 点击遮罩是否关闭菜单 */
+    closeOnClickMask: { type: Boolean, default: true },
+    /** 点击当前激活项标题是否关闭菜单 */
+    closeOnClickSelf: { type: Boolean, default: true },
+    /** 过渡时间 */
+    duration: { type: [Number, String], default: 300 },
+    /** 标题菜单的高度，单位任意，数值默认为rpx单位 */
+    height: { type: [Number, String], default: 80 },
+    /** 是否显示下边框 */
+    borderBottom: { type: Boolean, default: false },
+    /** 标题的字体大小 */
+    titleSize: { type: [Number, String], default: 28 },
+    /** 下拉出来的内容部分的圆角值 */
+    borderRadius: { type: [Number, String], default: 0 },
+    /** 菜单右侧的icon图标 */
+    menuIcon: { type: String, default: 'arrow-down' },
+    /** 菜单右侧图标的大小 */
+    menuIconSize: { type: [Number, String], default: 26 }
+});
+
+// emits 定义
+const emit = defineEmits(['open', 'close']);
+
+// 菜单列表
+const menuList = ref<any[]>([]);
+// 是否打开下拉菜单
+const showDropdown = ref(true);
+// 下拉菜单的状态
+const active = ref(false);
+// 当前激活菜单索引
+// 当前是第几个菜单处于激活状态，小程序中此处不能写成false或者""，否则后续将current赋值为0，
+// 无能的TX没有使用===而是使用==判断，导致程序认为前后二者没有变化，从而不会触发视图更新
+const current = ref<number>(99999);
+// 外层内容样式
+const contentStyle = ref<any>({ zIndex: -1, opacity: 0 });
+// 高亮菜单索引
+const highlightIndex = ref<number>(99999);
+// 下拉内容高度
+const contentHeight = ref<number>(0);
+// 子组件引用
+// 引用所有子组件(u-dropdown-item)的this，不能在data中声明变量，否则在微信小程序会造成循环引用而报错
+const children = ref<any[]>([]);
+const instance = getCurrentInstance();
+
+// 下拉出来部分的样式
+const popupStyle = computed<any>(() => {
+    const style: any = {};
+    // 进行Y轴位移，展开状态时，恢复原位。收齐状态时，往上位移100%，进行隐藏
+    style.transform = `translateY(${active.value ? 0 : '-100%'})`;
+    style['transition-duration'] = Number(props.duration) / 1000 + 's';
+    style.borderRadius = `0 0 ${$u.addUnit(props.borderRadius)} ${$u.addUnit(props.borderRadius)}`;
+    return style;
+});
+
+// 生命周期
+onMounted(() => {
+    getContentHeight();
+});
+
+// 引用所有子组件(u-dropdown-item)的this，不能在data中声明变量，否则在微信小程序会造成循环引用而报错
+children.value = [];
+
+/**
+ * 初始化所有子组件
+ * 当某个子组件内容变化时，触发父组件的init，父组件再让每一个子组件重新初始化一遍
+ * 以保证数据的正确性
+ */
+function init() {
+    menuList.value = [];
+    children.value.forEach(child => {
+        child.init && child.init();
+    });
+}
+
+/**
+ * 点击菜单
+ * @param index 菜单索引
+ */
+function menuClick(index: number) {
+    // 判断是否被禁用
+    if (menuList.value[index]?.disabled) return;
+    // 如果点击时的索引和当前激活项索引相同，意味着点击了激活项，需要收起下拉菜单
+    if (index === current.value && props.closeOnClickSelf) {
+        close();
+        // 等动画结束后，再移除下拉菜单中的内容，否则直接移除，也就没有下拉菜单收起的效果了
+        setTimeout(() => {
+            if (children.value[index]) children.value[index].active = false;
+        }, Number(props.duration));
+        return;
+    }
+    open(index);
+}
+
+/**
+ * 打开下拉菜单
+ * @param index 菜单索引
+ */
+function open(index: number) {
+    // 嵌套popup使用时可能获取不到正确的高度，重新计算
+    if (contentHeight.value < 1) getContentHeight();
+    // 重置高亮索引，否则会造成多个菜单同时高亮
+    // highlightIndex.value = 9999;
+    // 展开时，设置下拉内容的样式
+    contentStyle.value = { zIndex: 11 };
+    // 标记展开状态以及当前展开项的索引
+    active.value = true;
+    current.value = index;
+    // 历遍所有的子元素，将索引匹配的项标记为激活状态，因为子元素是通过v-if控制切换的
+    // 之所以不是因display: none，是因为nvue没有display这个属性
+    children.value.forEach((val, idx) => {
+        val.exposed.setActive && val.exposed.setActive(index == idx ? true : false);
+    });
+    emit('open', current.value);
+}
+
+/**
+ * 设置下拉菜单处于收起状态
+ */
+function close() {
+    emit('close', current.value);
+    // 设置为收起状态，同时current归位，设置为空字符串
+    active.value = false;
+    current.value = 99999;
+    // 下拉内容的样式进行调整，不透明度设置为0
+    contentStyle.value = { zIndex: -1, opacity: 0 };
+}
+
+/**
+ * 点击遮罩
+ */
+function maskClick() {
+    // 如果不允许点击遮罩，直接返回
+    if (!props.closeOnClickMask) return;
+    close();
+}
+
+/**
+ * 外部手动设置某个菜单高亮
+ * @param index 菜单索引
+ */
+function highlight(index?: number) {
+    highlightIndex.value = index !== undefined ? index : 99999;
+}
+
+/**
+ * 获取下拉菜单内容的高度
+ * 这里的原理为，因为dropdown组件是相对定位的，它的下拉出来的内容，必须给定一个高度
+ * 才能让遮罩占满菜单一下，直到屏幕底部的高度
+ * this.$u.sys()为uView封装的获取设备信息的方法
+ */
+function getContentHeight() {
+    const windowHeight = $u.sys().windowHeight;
+
+    $u.getRect('.u-dropdown__menu', instance).then((res: any) => {
+        // 这里获取的是dropdown的尺寸，在H5上，uniapp获取尺寸是有bug的(以前提出修复过，后来又出现了此bug，目前hx2.8.11版本)
+        // H5端bug表现为元素尺寸的top值为导航栏底部到到元素的上边沿的距离，但是元素的bottom值确是导航栏顶部到元素底部的距离
+        // 二者是互相矛盾的，本质原因是H5端导航栏非原生，uni的开发者大意造成
+        // 这里取菜单栏的botton值合理的，不能用res.top，否则页面会造成滚动
+        contentHeight.value = windowHeight - res.bottom;
+    });
+}
+
+// 暴露方法
+defineExpose({ init, close, open, highlight, getContentHeight, children, menuList });
+</script>
+
+<style scoped lang="scss">
+@import '../../libs/css/style.components.scss';
+
+.u-dropdown {
+    flex: 1;
+    width: 100%;
+    position: relative;
+
+    &__menu {
+        @include vue-flex;
+        position: relative;
+        z-index: 11;
+        height: 80rpx;
+
+        &__item {
+            flex: 1;
+            @include vue-flex;
+            justify-content: center;
+            align-items: center;
+
+            &__text {
+                font-size: 28rpx;
+                color: $u-content-color;
+            }
+
+            &__arrow {
+                margin-left: 6rpx;
+                transition: transform 0.3s;
+                align-items: center;
+                @include vue-flex;
+
+                &--rotate {
+                    transform: rotate(180deg);
+                }
+            }
+        }
+    }
+
+    &__content {
+        position: absolute;
+        z-index: 8;
+        width: 100%;
+        left: 0px;
+        bottom: 0;
+        overflow: hidden;
+
+        &__mask {
+            position: absolute;
+            z-index: 9;
+            background: rgba(0, 0, 0, 0.3);
+            width: 100%;
+            left: 0;
+            top: 0;
+            bottom: 0;
+        }
+
+        &__popup {
+            position: relative;
+            z-index: 10;
+            transition: all 0.3s;
+            transform: translate3D(0, -100%, 0);
+            overflow: hidden;
+        }
+    }
+}
+</style>

package/components/u-dropdown-item/u-dropdown-item.vue

@@ -0,0 +1,135 @@
+<template>
+    <view class="u-dropdown-item" v-if="active" @touchmove.stop.prevent @tap.stop.prevent>
+        <block v-if="!slots.default && !slots.$default">
+            <scroll-view scroll-y="true" :style="{ height: $u.addUnit(height) }">
+                <view class="u-dropdown-item__options">
+                    <u-cell-group>
+                        <u-cell-item
+                            @click="cellClick(item.value)"
+                            :arrow="false"
+                            :title="item.label"
+                            v-for="(item, index) in options"
+                            :key="index"
+                            :title-style="{ color: modelValue == item.value ? activeColor : inactiveColor }"
+                        >
+                            <u-icon v-if="modelValue == item.value" name="checkbox-mark" :color="activeColor" size="32"></u-icon>
+                        </u-cell-item>
+                    </u-cell-group>
+                </view>
+            </scroll-view>
+        </block>
+        <slot v-else />
+    </view>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, onMounted, getCurrentInstance, useSlots, watch } from 'vue';
+import { $u } from '../..'; // 工具函数路径
+
+defineOptions({ name: 'u-dropdown-item' });
+
+/**
+ * dropdown-item 下拉菜单
+ * @description 该组件一般用于向下展开菜单，同时可切换多个选项卡的场景
+ * @tutorial http://uviewui.com/components/dropdown.html
+ * @property {String | Number} v-model 双向绑定选项卡选择值
+ * @property {String} title 菜单项标题
+ * @property {Array[Object]} options 选项数据，如果传入了默认slot，此参数无效
+ * @property {Boolean} disabled 是否禁用此选项卡（默认false）
+ * @property {String | Number} duration 选项卡展开和收起的过渡时间，单位ms（默认300）
+ * @property {String | Number} height 弹窗下拉内容的高度(内容超出将会滚动)（默认auto）
+ * @example <u-dropdown-item title="标题"></u-dropdown-item>
+ */
+
+type OptionType = { label: string; value: any };
+
+// props 定义，保留参数注释
+const props = defineProps({
+    /** 当前选中项的value值 */
+    modelValue: { type: [Number, String, Array], default: '' },
+    /** 菜单项标题 */
+    title: { type: [String, Number], default: '' },
+    /** 选项数据，如果传入了默认slot，此参数无效 */
+    options: { type: Array as () => OptionType[], default: () => [] },
+    /** 是否禁用此菜单项 */
+    disabled: { type: Boolean, default: false },
+    /** 下拉弹窗的高度 */
+    height: { type: [Number, String], default: 'auto' }
+});
+
+// emits 定义
+const emit = defineEmits(['update:modelValue', 'change']);
+
+// 插槽
+const slots = useSlots();
+
+// 当前项是否处于展开状态
+const active = ref(false);
+// 激活时左边文字和右边对勾图标的颜色
+const activeColor = ref<string>('#2979ff');
+// 未激活时左边文字和右边对勾图标的颜色
+const inactiveColor = ref<string>('#606266');
+// 父组件实例
+const parent = ref<any>(null);
+
+// 监听props变化，通知父组件重新初始化
+const propsChange = computed(() => `${props.title}-${props.disabled}`);
+
+// 监听propsChange变化，通知父组件重新init
+watch(propsChange, () => {
+    if (parent.value && parent.value.init) parent.value.init();
+});
+
+/**
+ * 初始化本组件，注册到父组件
+ */
+function init() {
+    // 获取父组件u-dropdown
+    const instance = getCurrentInstance();
+    if (!instance) return;
+    const parentComp = $u.$parent('u-dropdown');
+    if (parentComp && parentComp.proxy) {
+        const parentProxy = parentComp.proxy as any;
+        parent.value = parentComp;
+        // 继承父组件的激活/未激活颜色
+        activeColor.value = parentProxy.activeColor;
+        inactiveColor.value = parentProxy.inactiveColor;
+        // 注册到父组件children
+        // 将本组件的this，放入到父组件的children数组中，让父组件可以操作本(子)组件的方法和属性
+        // push进去前，显判断是否已经存在了本实例，因为在子组件内部数据变化时，会通过父组件重新初始化子组件
+        const exist = parentComp?.exposed?.children.value.find((val: any) => val === instance);
+        if (!exist) parentComp?.exposed?.children.value.push(instance);
+        if (parentComp?.exposed?.children.value.length === 1) active.value = true;
+        // 向父组件menuList注册本项
+        // 父组件无法监听children的变化，故将子组件的title，传入父组件的menuList数组中
+        parentComp?.exposed?.menuList.value.push({ title: props.title, disabled: props.disabled });
+    }
+}
+
+/**
+ * cell被点击
+ * @param value 选中值
+ */
+function cellClick(value: string | number | any) {
+    // 修改通过v-model绑定的值
+    emit('update:modelValue', value);
+    // 通知父组件(u-dropdown)收起菜单
+    parent.value?.exposed?.close();
+    // 发出事件，抛出当前勾选项的value
+    emit('change', value);
+}
+
+function setActive(value: boolean) {
+    active.value = value;
+}
+
+onMounted(() => {
+    init();
+});
+
+defineExpose({ init, cellClick, setActive });
+</script>
+
+<style scoped lang="scss">
+@import '../../libs/css/style.components.scss';
+</style>

package/components/u-empty/u-empty.vue

@@ -0,0 +1,111 @@
+<template>
+    <view class="u-empty" v-if="show" :style="{ marginTop: marginTop + 'rpx' }">
+        <u-icon
+            :name="src ? src : 'empty-' + mode"
+            :custom-style="iconStyle"
+            :label="text ? text : icons[mode]"
+            label-pos="bottom"
+            :label-color="color"
+            :label-size="fontSize"
+            :size="iconSize"
+            :color="iconColor"
+            margin-top="14"
+        ></u-icon>
+        <view class="u-slot-wrap">
+            <slot name="bottom"></slot>
+        </view>
+    </view>
+</template>
+
+<script setup lang="ts">
+defineOptions({
+    name: 'u-empty'
+});
+
+/**
+ * empty 内容为空
+ * @description 该组件用于需要加载内容，但是加载的第一页数据就为空，提示一个"没有内容"的场景， 我们精心挑选了十几个场景的图标，方便您使用。
+ * @tutorial https://www.uviewui.com/components/empty.html
+ * @property {String} color 文字颜色（默认#c0c4cc）
+ * @property {String} text 文字提示（默认“无内容”）
+ * @property {String} src 自定义图标路径，如定义，mode参数会失效
+ * @property {String Number} font-size 提示文字的大小，单位rpx（默认28）
+ * @property {String} mode 内置的图标，见官网说明（默认data）
+ * @property {String Number} img-width 图标的宽度，单位rpx（默认240）
+ * @property {String} img-height 图标的高度，单位rpx（默认auto）
+ * @property {String Number} margin-top 组件距离上一个元素之间的距离（默认0）
+ * @property {Boolean} show 是否显示组件（默认true）
+ * @event {Function} click 点击组件时触发
+ * @event {Function} close 点击关闭按钮时触发
+ * @example <u-empty text="所谓伊人，在水一方" mode="list"></u-empty>
+ */
+const props = defineProps({
+    /** 图标路径 */
+    src: { type: String, default: '' },
+    /** 提示文字 */
+    text: { type: String, default: '' },
+    /** 文字颜色 */
+    color: { type: String, default: '#c0c4cc' },
+    /** 图标的颜色 */
+    iconColor: { type: String, default: '#c0c4cc' },
+    /** 图标的大小 */
+    iconSize: { type: [String, Number], default: 120 },
+    /** 文字大小，单位rpx */
+    fontSize: { type: [String, Number], default: 26 },
+    /** 选择预置的图标类型 */
+    mode: { type: String, default: 'data' },
+    /** 图标宽度，单位rpx */
+    imgWidth: { type: [String, Number], default: 120 },
+    /** 图标高度，单位rpx */
+    imgHeight: { type: [String, Number], default: 'auto' },
+    /** 是否显示组件 */
+    show: { type: Boolean, default: true },
+    /** 组件距离上一个元素之间的距离 */
+    marginTop: { type: [String, Number], default: 0 },
+    /** 图标自定义样式 */
+    iconStyle: { type: Object, default: () => ({}) }
+});
+
+/**
+ * 预置图标对应的提示文字
+ */
+const icons: Record<string, string> = {
+    car: '购物车为空',
+    page: '页面不存在',
+    search: '没有搜索结果',
+    address: '没有收货地址',
+    wifi: '没有WiFi',
+    order: '订单为空',
+    coupon: '没有优惠券',
+    favor: '暂无收藏',
+    permission: '无权限',
+    history: '无历史记录',
+    news: '无新闻列表',
+    message: '消息列表为空',
+    list: '列表为空',
+    data: '数据为空'
+};
+</script>
+
+<style scoped lang="scss">
+@import '../../libs/css/style.components.scss';
+
+.u-empty {
+    @include vue-flex;
+    flex-direction: column;
+    justify-content: center;
+    align-items: center;
+    height: 100%;
+}
+
+.u-image {
+    margin-bottom: 20rpx;
+}
+
+.u-slot-wrap {
+    @include vue-flex;
+    justify-content: center;
+    align-items: center;
+    margin-top: 20rpx;
+}
+</style>