uview-pro 0.0.1

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

@@ -0,0 +1,245 @@
+<template>
+    <view
+        @tap="onClick"
+        class="u-cell"
+        :class="{
+            'u-border-bottom': borderBottom,
+            'u-border-top': borderTop,
+            'u-col-center': center,
+            'u-cell--required': required
+        }"
+        hover-stay-time="150"
+        :hover-class="hoverClass"
+        :style="{ backgroundColor: bgColor }"
+    >
+        <u-icon :size="iconSize" :name="icon" v-if="icon" :custom-style="iconStyle" class="u-cell__left-icon-wrap"></u-icon>
+        <view class="u-flex" v-else>
+            <slot name="icon"></slot>
+        </view>
+        <view class="u-cell_title" :style="[{ width: titleWidth ? titleWidth + 'rpx' : 'auto' }, titleStyle]">
+            <template v-if="title !== ''">{{ title }}</template>
+            <slot name="title" v-else></slot>
+            <view class="u-cell__label" v-if="label || $slots.label" :style="[labelStyle]">
+                <template v-if="label !== ''">{{ label }}</template>
+                <slot name="label" v-else></slot>
+            </view>
+        </view>
+        <view class="u-cell__value" :style="[valueStyle]">
+            <template v-if="value !== ''">{{ value }}</template>
+            <slot v-else></slot>
+        </view>
+        <view class="u-flex u-cell_right" v-if="$slots['right-icon']">
+            <slot name="right-icon"></slot>
+        </view>
+        <u-icon v-if="arrow" name="arrow-right" :style="[arrowStyle]" class="u-icon-wrap u-cell__right-icon-wrap"></u-icon>
+    </view>
+</template>
+
+<script setup lang="ts">
+import { computed, useSlots } from 'vue';
+
+defineOptions({
+    name: 'u-cell-item'
+});
+
+/**
+ * cellItem 单元格Item
+ * @description cell单元格一般用于一组列表的情况，比如个人中心页，设置页等。搭配u-cell-group使用
+ * @tutorial https://www.uviewui.com/components/cell.html
+ * @property {String} title 左侧标题
+ * @property {String} icon 左侧图标名，只支持uView内置图标，见Icon 图标
+ * @property {Object} icon-style 左边图标的样式，对象形式
+ * @property {String} value 右侧内容
+ * @property {String} label 标题下方的描述信息
+ * @property {Boolean} border-bottom 是否显示cell的下边框（默认true）
+ * @property {Boolean} border-top 是否显示cell的上边框（默认false）
+ * @property {Boolean} center 是否使内容垂直居中（默认false）
+ * @property {String} hover-class 是否开启点击反馈，none为无效果（默认true）
+ * // @property {Boolean} border-gap border-bottom为true时，Cell列表中间的条目的下边框是否与左边有一个间隔（默认true）
+ * @property {Boolean} arrow 是否显示右侧箭头（默认true）
+ * @property {Boolean} required 箭头方向，可选值（默认right）
+ * @property {Boolean} arrow-direction 是否显示左边表示必填的星号（默认false）
+ * @property {Object} title-style 标题样式，对象形式
+ * @property {Object} value-style 右侧内容样式，对象形式
+ * @property {Object} label-style 标题下方描述信息的样式，对象形式
+ * @property {String} bg-color 背景颜色（默认transparent）
+ * @property {String|Number} index 用于在click事件回调中返回，标识当前是第几个Item
+ * @property {String|Number} title-width 标题的宽度，单位rpx
+ * @example <u-cell-item icon="integral-fill" title="会员等级" value="新版本"></u-cell-item>
+ */
+
+const emit = defineEmits<{ (e: 'click', index: string | number): void }>();
+
+const props = defineProps({
+    /** 左侧图标名称(只能uView内置图标)，或者图标src */
+    icon: { type: String, default: '' },
+    /** 左侧标题 */
+    title: { type: [String, Number], default: '' },
+    /** 右侧内容 */
+    value: { type: [String, Number], default: '' },
+    /** 标题下方的描述信息 */
+    label: { type: [String, Number], default: '' },
+    /** 是否显示下边框 */
+    borderBottom: { type: Boolean, default: true },
+    /** 是否显示上边框 */
+    borderTop: { type: Boolean, default: false },
+    /**多个cell中，中间的cell显示下划线时，下划线是否给一个到左边的距离 */
+    /* 1.4.0版本废除此参数，默认边框由border-top和border-bottom提供，此参数会造成干扰 */
+    //  borderGap: { type: Boolean, default: true },
+    /** 是否开启点击反馈，即点击时cell背景为灰色，none为无效果 */
+    hoverClass: { type: String, default: 'u-cell-hover' },
+    /** 是否显示右侧箭头 */
+    arrow: { type: Boolean, default: true },
+    /** 内容是否垂直居中 */
+    center: { type: Boolean, default: false },
+    /** 是否显示左边表示必填的星号 */
+    required: { type: Boolean, default: false },
+    /** 标题的宽度，单位rpx */
+    titleWidth: { type: [Number, String], default: '' },
+    /** 右侧箭头方向，可选值：right|up|down，默认为right */
+    arrowDirection: { type: String, default: 'right' },
+    /** 控制标题的样式 */
+    titleStyle: { type: Object as () => Record<string, any>, default: () => ({}) },
+    /** 右侧显示内容的样式 */
+    valueStyle: { type: Object as () => Record<string, any>, default: () => ({}) },
+    /** 描述信息的样式 */
+    labelStyle: { type: Object as () => Record<string, any>, default: () => ({}) },
+    /** 背景颜色 */
+    bgColor: { type: String, default: 'transparent' },
+    /** 用于识别被点击的是第几个cell */
+    index: { type: [String, Number], default: '' },
+    /** 是否使用label插槽 */
+    useLabelSlot: { type: Boolean, default: false },
+    /** 左边图标的大小，单位rpx，只对传入icon字段时有效 */
+    iconSize: { type: [Number, String], default: 34 },
+    /** 左边图标的样式，对象形式 */
+    iconStyle: { type: Object as () => Record<string, any>, default: () => ({}) }
+});
+
+const $slots = useSlots();
+
+/**
+ * 箭头样式
+ */
+const arrowStyle = computed(() => {
+    let style: Record<string, any> = {};
+    if (props.arrowDirection === 'up') style.transform = 'rotate(-90deg)';
+    else if (props.arrowDirection === 'down') style.transform = 'rotate(90deg)';
+    else style.transform = 'rotate(0deg)';
+    return style;
+});
+
+/**
+ * 点击事件
+ */
+function onClick() {
+    emit('click', props.index);
+}
+</script>
+
+<style lang="scss" scoped>
+@import '../../libs/css/style.components.scss';
+.u-cell {
+    @include vue-flex;
+    align-items: center;
+    position: relative;
+    /* #ifndef APP-NVUE */
+    box-sizing: border-box;
+    /* #endif */
+    width: 100%;
+    padding: 26rpx 32rpx;
+    font-size: 28rpx;
+    line-height: 54rpx;
+    color: $u-content-color;
+    background-color: #fff;
+    text-align: left;
+}
+
+.u-cell_title {
+    font-size: 28rpx;
+}
+
+.u-cell__left-icon-wrap {
+    margin-right: 10rpx;
+    font-size: 32rpx;
+}
+
+.u-cell__right-icon-wrap {
+    margin-left: 10rpx;
+    color: #969799;
+    font-size: 28rpx;
+}
+
+.u-cell__left-icon-wrap,
+.u-cell__right-icon-wrap {
+    @include vue-flex;
+    align-items: center;
+    height: 48rpx;
+}
+
+.u-cell-border:after {
+    position: absolute;
+    /* #ifndef APP-NVUE */
+    box-sizing: border-box;
+    content: ' ';
+    pointer-events: none;
+    border-bottom: 1px solid $u-border-color;
+    /* #endif */
+    right: 0;
+    left: 0;
+    top: 0;
+    transform: scaleY(0.5);
+}
+
+.u-cell-border {
+    position: relative;
+}
+
+.u-cell__label {
+    margin-top: 6rpx;
+    font-size: 26rpx;
+    line-height: 36rpx;
+    color: $u-tips-color;
+    /* #ifndef APP-NVUE */
+    word-wrap: break-word;
+    /* #endif */
+}
+
+.u-cell__value {
+    overflow: hidden;
+    text-align: right;
+    /* #ifndef APP-NVUE */
+    vertical-align: middle;
+    /* #endif */
+    color: $u-tips-color;
+    font-size: 26rpx;
+}
+
+.u-cell__title,
+.u-cell__value {
+    flex: 1;
+}
+
+.u-cell--required {
+    /* #ifndef APP-NVUE */
+    overflow: visible;
+    /* #endif */
+    @include vue-flex;
+    align-items: center;
+}
+
+.u-cell--required:before {
+    position: absolute;
+    /* #ifndef APP-NVUE */
+    content: '*';
+    /* #endif */
+    left: 8px;
+    margin-top: 4rpx;
+    font-size: 14px;
+    color: $u-type-error;
+}
+
+.u-cell_right {
+    line-height: 1;
+}
+</style>

package/components/u-checkbox/u-checkbox.vue

@@ -0,0 +1,310 @@
+<template>
+    <view class="u-checkbox" :style="[checkboxStyle]">
+        <view class="u-checkbox__icon-wrap" @tap="toggle" :class="[iconClass]" :style="[iconStyle]">
+            <u-icon class="u-checkbox__icon-wrap__icon" name="checkbox-mark" :size="checkboxIconSize" :color="iconColor" />
+        </view>
+        <view
+            class="u-checkbox__label"
+            @tap="onClickLabel"
+            :style="{
+                fontSize: $u.addUnit(labelSize)
+            }"
+        >
+            <slot />
+        </view>
+    </view>
+</template>
+
+<script setup lang="ts">
+import { computed, inject, getCurrentInstance, onMounted } from 'vue';
+import { $u } from '../..';
+
+defineOptions({
+    name: 'u-checkbox'
+});
+
+/**
+ * checkbox 复选框
+ * @description 该组件需要搭配checkboxGroup组件使用，以便用户进行操作时，获得当前复选框组的选中情况。
+ * @tutorial https://www.uviewui.com/components/checkbox.html
+ * @property {String Number} icon-size 图标大小，单位rpx（默认20）
+ * @property {String Number} label-size label字体大小，单位rpx（默认28）
+ * @property {String Number} name checkbox组件的标示符
+ * @property {String} shape 形状，见官网说明（默认circle）
+ * @property {Boolean} disabled 是否禁用
+ * @property {Boolean} label-disabled 是否禁止点击文本操作checkbox
+ * @property {String} active-color 选中时的颜色，如设置CheckboxGroup的active-color将失效
+ * @event {Function} change 某个checkbox状态发生变化时触发，回调为一个对象
+ * @example <u-checkbox v-model="checked" :disabled="false">天涯</u-checkbox>
+ */
+
+const props = defineProps({
+    /** checkbox的名称 */
+    name: {
+        type: [String, Number],
+        default: ''
+    },
+    /** 形状，square为方形，circle为原型 */
+    shape: {
+        type: String,
+        default: ''
+    },
+    /** 是否为选中状态 */
+    modelValue: {
+        type: Boolean,
+        default: false
+    },
+    /** 是否禁用 */
+    disabled: {
+        type: [String, Boolean],
+        default: ''
+    },
+    /** 是否禁止点击提示语选中复选框 */
+    labelDisabled: {
+        type: [String, Boolean],
+        default: ''
+    },
+    /** 选中状态下的颜色，如设置此值，将会覆盖checkboxGroup的activeColor值 */
+    activeColor: {
+        type: String,
+        default: ''
+    },
+    /** 图标的大小，单位rpx */
+    iconSize: {
+        type: [String, Number],
+        default: ''
+    },
+    /** label的字体大小，rpx单位 */
+    labelSize: {
+        type: [String, Number],
+        default: ''
+    },
+    /** 组件的整体大小 */
+    size: {
+        type: [String, Number],
+        default: ''
+    }
+});
+
+const emit = defineEmits(['change', 'update:modelValue']);
+
+// 父组件 group 注入
+// 支付宝小程序不支持provide/inject？
+const parent = inject<any>('u-checkbox-group', null);
+
+// 组件注册到 group
+onMounted(() => {
+    // 如果存在u-checkbox-group，将本组件的实例塞进父组件的children中
+    if (parent && parent.children && !parent.children.value.includes(instanceProxy)) {
+        parent.children.value.push(instanceProxy);
+    }
+});
+
+const instance = getCurrentInstance();
+const instanceProxy = instance?.proxy;
+
+// 是否禁用，如果父组件u-checkbox-group禁用的话，将会忽略子组件的配置
+const isDisabled = computed(() => {
+    return props.disabled !== '' ? props.disabled : parent ? parent.props.disabled : false;
+});
+// 是否禁用label点击
+const isLabelDisabled = computed(() => {
+    return props.labelDisabled !== '' ? props.labelDisabled : parent ? parent.props.labelDisabled : false;
+});
+// 组件尺寸，对应size的值，默认值为34rpx
+const checkboxSize = computed(() => {
+    return props.size ? props.size : parent ? parent.props.size : 34;
+});
+// 组件的勾选图标的尺寸，默认20
+const checkboxIconSize = computed(() => {
+    return props.iconSize ? props.iconSize : parent ? parent.props.iconSize : 20;
+});
+// 组件选中激活时的颜色
+const elActiveColor = computed(() => {
+    return props.activeColor ? props.activeColor : parent ? parent.props.activeColor : 'primary';
+});
+// 组件的形状
+const elShape = computed(() => {
+    return props.shape ? props.shape : parent ? parent.props.shape : 'square';
+});
+// 图标样式
+const iconStyle = computed(() => {
+    let style: Record<string, string> = {};
+    // 既要判断是否手动禁用，还要判断用户v-model绑定的值，如果绑定为false，那么也无法选中
+    if (elActiveColor.value && props.modelValue && !isDisabled.value) {
+        style.borderColor = elActiveColor.value;
+        style.backgroundColor = elActiveColor.value;
+    }
+    style.width = $u.addUnit(checkboxSize.value);
+    style.height = $u.addUnit(checkboxSize.value);
+    return style;
+});
+// checkbox内部的勾选图标，如果选中状态，为白色，否则为透明色即可
+const iconColor = computed(() => {
+    return props.modelValue ? '#ffffff' : 'transparent';
+});
+const iconClass = computed(() => {
+    let classes: string[] = [];
+    classes.push('u-checkbox__icon-wrap--' + elShape.value);
+    if (props.modelValue == true) classes.push('u-checkbox__icon-wrap--checked');
+    if (isDisabled.value) classes.push('u-checkbox__icon-wrap--disabled');
+    if (props.modelValue && isDisabled.value) classes.push('u-checkbox__icon-wrap--disabled--checked');
+    // 支付宝小程序无法动态绑定一个数组类名，否则解析出来的结果会带有","，而导致失效
+    return classes.join(' ');
+});
+const checkboxStyle = computed(() => {
+    let style: Record<string, string> = {};
+    if (parent && parent.props.width) {
+        style.width = parent.props.width;
+        // #ifdef MP
+        // 各家小程序因为它们特殊的编译结构，使用float布局
+        style.float = 'left';
+        // #endif
+        // #ifndef MP
+        // H5和APP使用flex布局
+        style.flex = `0 0 ${parent.props.width}`;
+        // #endif
+    }
+    if (parent && parent.props.wrap) {
+        style.width = '100%';
+        // #ifndef MP
+        // H5和APP使用flex布局，将宽度设置100%，即可自动换行
+        style.flex = '0 0 100%';
+        // #endif
+    }
+    return style;
+});
+
+/**
+ * 点击label
+ */
+function onClickLabel() {
+    if (!isLabelDisabled.value && !isDisabled.value) {
+        setValue();
+    }
+}
+/**
+ * 点击icon
+ */
+function toggle() {
+    if (!isDisabled.value) {
+        setValue();
+    }
+}
+/**
+ * 触发change事件
+ */
+function emitEvent() {
+    emit('change', {
+        value: !props.modelValue,
+        name: props.name
+    });
+    // 执行父组件u-checkbox-group的事件方法
+    // 等待下一个周期再执行，因为emit('input')作用于父组件，再反馈到子组件内部，需要时间
+    setTimeout(() => {
+        if (parent && parent.children && parent.children.value && parent.children.value.includes(instanceProxy) && parent.emitEvent) parent.emitEvent();
+    }, 80);
+}
+/**
+ * 设置input的值，这里通过input事件，设置通过v-model绑定的组件的值
+ */
+function setValue() {
+    // 判断是否超过了可选的最大数量
+    let checkedNum = 0;
+    if (parent && parent.children && parent.children.value) {
+        // 只要父组件的某一个子元素的value为true，就加1(已有的选中数量)
+        parent.children.value.forEach((val: any) => {
+            if (val.value) checkedNum++;
+        });
+    }
+    // 如果原来为选中状态，那么可以取消
+    if (props.modelValue == true) {
+        emitEvent();
+        emit('update:modelValue', !props.modelValue);
+    } else {
+        // 如果超出最多可选项，提示
+        if (parent && checkedNum >= parent.props.max) {
+            return $u.toast(`最多可选${parent.props.max}项`);
+        }
+        // 如果原来为未选中状态，需要选中的数量少于父组件中设置的max值，才可以选中
+        emitEvent();
+        emit('update:modelValue', !props.modelValue);
+    }
+}
+
+defineExpose({ setValue, emitEvent });
+</script>
+
+<style lang="scss" scoped>
+@import '../../libs/css/style.components.scss';
+
+.u-checkbox {
+    /* #ifndef APP-NVUE */
+    display: inline-flex;
+    /* #endif */
+    align-items: center;
+    overflow: hidden;
+    user-select: none;
+    line-height: 1.8;
+
+    &__icon-wrap {
+        color: $u-content-color;
+        flex: none;
+        display: -webkit-flex;
+        @include vue-flex;
+        align-items: center;
+        justify-content: center;
+        box-sizing: border-box;
+        width: 42rpx;
+        height: 42rpx;
+        color: transparent;
+        text-align: center;
+        transition-property: color, border-color, background-color;
+        font-size: 20px;
+        border: 1px solid #c8c9cc;
+        transition-duration: 0.2s;
+
+        /* #ifdef MP-TOUTIAO */
+        // 头条小程序兼容性问题，需要设置行高为0，否则图标偏下
+        &__icon {
+            line-height: 0;
+        }
+        /* #endif */
+
+        &--circle {
+            border-radius: 100%;
+        }
+
+        &--square {
+            border-radius: 6rpx;
+        }
+
+        &--checked {
+            color: #fff;
+            background-color: $u-type-primary;
+            border-color: $u-type-primary;
+        }
+
+        &--disabled {
+            background-color: #ebedf0;
+            border-color: #c8c9cc;
+        }
+
+        &--disabled--checked {
+            color: #c8c9cc !important;
+        }
+    }
+
+    &__label {
+        word-wrap: break-word;
+        margin-left: 10rpx;
+        margin-right: 24rpx;
+        color: $u-content-color;
+        font-size: 30rpx;
+
+        &--disabled {
+            color: #c8c9cc;
+        }
+    }
+}
+</style>

package/components/u-checkbox-group/u-checkbox-group.vue

@@ -0,0 +1,134 @@
+<template>
+    <view class="u-checkbox-group u-clearfix">
+        <slot></slot>
+    </view>
+</template>
+
+<script setup lang="ts">
+import { ref, getCurrentInstance, provide } from 'vue';
+import { $u } from '../..';
+
+defineOptions({
+    name: 'u-checkbox-group'
+});
+
+/**
+ * checkboxGroup 开关选择器父组件Group
+ * @description 复选框组件一般用于需要多个选择的场景，该组件功能完整，使用方便
+ * @tutorial https://www.uviewui.com/components/checkbox.html
+ * @property {String Number} max 最多能选中多少个checkbox（默认999）
+ * @property {String Number} size 组件整体的大小，单位rpx（默认40）
+ * @property {Boolean} disabled 是否禁用所有checkbox（默认false）
+ * @property {String Number} icon-size 图标大小，单位rpx（默认20）
+ * @property {Boolean} label-disabled 是否禁止点击文本操作checkbox(默认false)
+ * @property {String} width 宽度，需带单位
+ * @property {String} shape 外观形状，shape-方形，circle-圆形(默认circle)
+ * @property {Boolean} wrap 是否每个checkbox都换行（默认false）
+ * @property {String} active-color 选中时的颜色，应用到所有子Checkbox组件（默认#2979ff）
+ * @event {Function} change 任一个checkbox状态发生变化时触发，回调为一个对象
+ * @example <u-checkbox-group></u-checkbox-group>
+ */
+
+const props = defineProps({
+    /** 最多能选中多少个checkbox */
+    max: {
+        type: [Number, String],
+        default: 999
+    },
+    // /** 所有选中项的 name */
+    // value: {
+    //   default: Array,
+    //   default: () => []
+    // },
+    /** 是否禁用所有复选框 */
+    disabled: {
+        type: Boolean,
+        default: false
+    },
+    /** 在表单内提交时的标识符 */
+    name: {
+        type: [Boolean, String],
+        default: ''
+    },
+    /** 是否禁止点击提示语选中复选框 */
+    labelDisabled: {
+        type: Boolean,
+        default: false
+    },
+    /** 形状，square为方形，circle为原型 */
+    shape: {
+        type: String,
+        default: 'square'
+    },
+    /** 选中状态下的颜色 */
+    activeColor: {
+        type: String,
+        default: '#2979ff'
+    },
+    /** 组件的整体大小 */
+    size: {
+        type: [String, Number],
+        default: 34
+    },
+    /** 每个checkbox占u-checkbox-group的宽度 */
+    width: {
+        type: String,
+        default: 'auto'
+    },
+    /** 是否每个checkbox都换行 */
+    wrap: {
+        type: Boolean,
+        default: false
+    },
+    /** 图标的大小，单位rpx */
+    iconSize: {
+        type: [String, Number],
+        default: 20
+    }
+});
+
+const emit = defineEmits(['change']);
+
+// 复选框子项集合
+const children = ref<any[]>([]); // 用于存储所有子checkbox实例
+
+// 向子组件 provide 本 group 实例
+provide('u-checkbox-group', {
+    props,
+    emitEvent,
+    children
+});
+
+const instance = getCurrentInstance();
+
+/**
+ * 派发 change 事件和表单校验
+ */
+function emitEvent() {
+    // 收集所有选中的 name
+    let values: any[] = [];
+    children.value.forEach(val => {
+        if (val.modelValue) values.push(val.name);
+    });
+    emit('change', values);
+    // 发出事件，用于在表单组件中嵌入checkbox的情况，进行验证
+    // 由于头条小程序执行迟钝，故需要用几十毫秒的延时
+    setTimeout(() => {
+        // 将当前的值发送到 u-form-item 进行校验
+        $u.dispatch(instance, 'u-form-item', 'on-form-change', values);
+    }, 60);
+}
+
+defineExpose({ emitEvent, children, props });
+</script>
+
+<style lang="scss" scoped>
+@import '../../libs/css/style.components.scss';
+
+.u-checkbox-group {
+    /* #ifndef MP || APP-NVUE */
+    display: inline-flex;
+    flex-wrap: wrap;
+    /* #endif */
+}
+</style>