uview-pro 0.0.1

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

@@ -0,0 +1,476 @@
+<template>
+    <view
+        class="u-form-item"
+        :class="{
+            'u-border-bottom': elBorderBottom,
+            'u-form-item__border-bottom--error': validateState === 'error' && showError('border-bottom')
+        }"
+    >
+        <view
+            class="u-form-item__body"
+            :style="{
+                flexDirection: elLabelPosition == 'left' ? 'row' : 'column'
+            }"
+        >
+            <!-- 微信小程序中，将一个参数设置空字符串，结果会变成字符串"true" -->
+            <view
+                class="u-form-item--left"
+                :style="{
+                    width: uLabelWidth,
+                    flex: `0 0 ${uLabelWidth}`,
+                    marginBottom: elLabelPosition == 'left' ? 0 : '10rpx'
+                }"
+            >
+                <!-- 为了块对齐 -->
+                <view class="u-form-item--left__content" v-if="required || leftIcon || label">
+                    <!-- nvue不支持伪元素before -->
+                    <text v-if="required" class="u-form-item--left__content--required">*</text>
+                    <view class="u-form-item--left__content__icon" v-if="leftIcon">
+                        <u-icon :name="leftIcon" :custom-style="leftIconStyle"></u-icon>
+                    </view>
+                    <view
+                        class="u-form-item--left__content__label"
+                        :style="[
+                            elLabelStyle,
+                            {
+                                'justify-content': elLabelAlign == 'left' ? 'flex-start' : elLabelAlign == 'center' ? 'center' : 'flex-end'
+                            }
+                        ]"
+                    >
+                        {{ label }}
+                    </view>
+                </view>
+            </view>
+            <view class="u-form-item--right u-flex">
+                <view class="u-form-item--right__content">
+                    <view class="u-form-item--right__content__slot">
+                        <slot />
+                    </view>
+                    <view class="u-form-item--right__content__icon u-flex" v-if="$slots.right || rightIcon">
+                        <u-icon :custom-style="rightIconStyle" v-if="rightIcon" :name="rightIcon"></u-icon>
+                        <slot name="right" />
+                    </view>
+                </view>
+            </view>
+        </view>
+        <view
+            class="u-form-item__message"
+            v-if="validateState === 'error' && showError('message')"
+            :style="{
+                paddingLeft: elLabelPosition == 'left' ? $u.addUnit(elLabelWidth) : '0'
+            }"
+            >{{ validateMessage }}</view
+        >
+    </view>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, inject, onMounted, onBeforeUnmount, watch, getCurrentInstance, nextTick } from 'vue';
+import { $u } from '../..';
+import { broadcast } from '../../libs/util/emitter';
+// @ts-ignore
+import schema from '../../libs/util/async-validator';
+// 去除警告信息
+schema.warning = function () {};
+
+defineOptions({
+    name: 'u-form-item'
+});
+
+/**
+ * form-item 表单item
+ * @description 此组件一般用于表单场景，可以配置Input输入框，Select弹出框，进行表单验证等。
+ * @tutorial http://uviewui.com/components/form.html
+ * @property {String} label 左侧提示文字
+ * @property {Object} prop 表单域model对象的属性名，在使用 validate、resetFields 方法的情况下，该属性是必填的
+ * @property {Boolean} border-bottom 是否显示表单域的下划线边框
+ * @property {String} label-position 表单域提示文字的位置，left-左侧，top-上方
+ * @property {String Number} label-width 提示文字的宽度，单位rpx（默认90）
+ * @property {Object} label-style lable的样式，对象形式
+ * @property {String} label-align lable的对齐方式
+ * @property {String} right-icon 右侧自定义字体图标(限uView内置图标)或图片地址
+ * @property {String} left-icon 左侧自定义字体图标(限uView内置图标)或图片地址
+ * @property {Object} left-icon-style 左侧图标的样式，对象形式
+ * @property {Object} right-icon-style 右侧图标的样式，对象形式
+ * @property {Boolean} required 是否显示左边的"*"号，这里仅起展示作用，如需校验必填，请通过rules配置必填规则(默认false)
+ * @example <u-form-item label="姓名"><u-input v-model="form.name" /></u-form-item>
+ */
+
+const props = defineProps({
+    /** input的label提示语 */
+    label: {
+        type: String,
+        default: ''
+    },
+    /** 绑定的值 */
+    prop: {
+        type: String,
+        default: ''
+    },
+    /** 是否显示表单域的下划线边框 */
+    borderBottom: {
+        type: [String, Boolean],
+        default: ''
+    },
+    /** label的位置，left-左边，top-上边 */
+    labelPosition: {
+        type: String,
+        default: ''
+    },
+    /** label的宽度，单位rpx */
+    labelWidth: {
+        type: [String, Number],
+        default: ''
+    },
+    /** lable的样式，对象形式 */
+    labelStyle: {
+        type: Object,
+        default: () => ({})
+    },
+    /** lable字体的对齐方式 */
+    labelAlign: {
+        type: String,
+        default: ''
+    },
+    /** 右侧图标 */
+    rightIcon: {
+        type: String,
+        default: ''
+    },
+    /** 左侧图标 */
+    leftIcon: {
+        type: String,
+        default: ''
+    },
+    /** 左侧图标的样式 */
+    leftIconStyle: {
+        type: Object,
+        default: () => ({})
+    },
+    /** 右侧图标的样式 */
+    rightIconStyle: {
+        type: Object,
+        default: () => ({})
+    },
+    /** 是否显示左边的必填星号，只作显示用，具体校验必填的逻辑，请在rules中配置 */
+    required: {
+        type: Boolean,
+        default: false
+    }
+});
+
+// inject 父表单实例
+const parent = inject<any>('u-form', null);
+const instance = getCurrentInstance();
+
+// 组件状态
+const initialValue = ref(''); // 存储初始值，用于重置
+const validateState = ref(''); // 校验状态 success/error/validating
+const validateMessage = ref(''); // 校验失败的提示语
+const errorType = ref<string[]>(['message']); // 错误提示方式，默认 message
+const fieldValue = ref(''); // 当前表单项的值
+const parentData = ref({
+    borderBottom: true, // 父表单下划线边框
+    labelWidth: 90, // 父表单 label 宽度
+    labelPosition: 'left', // 父表单 label 位置
+    labelStyle: {}, // 父表单 label 样式
+    labelAlign: 'left' // 父表单 label 对齐
+});
+
+// 监听校验状态和父表单 errorType 变化
+watch(validateState, () => {
+    broadcastInputError();
+});
+
+// 监听u-form组件的errorType的变化
+watch(
+    () => parent?.errorType,
+    val => {
+        if (val) errorType.value = val;
+        broadcastInputError();
+    },
+    { immediate: true }
+);
+
+// 计算属性
+const uLabelWidth = computed(() => {
+    // 如果用户设置label为空字符串(微信小程序空字符串最终会变成字符串的'true')，意味着要将label的位置宽度设置为auto
+    return elLabelPosition.value == 'left' ? (props.label === 'true' || props.label === '' ? 'auto' : $u.addUnit(elLabelWidth.value)) : '100%';
+});
+
+// 显示错误提示
+// errorType: ['message', 'toast', 'border-bottom', 'none']
+const showError = computed(() => (type: string) => {
+    // 如果errorType数组中含有none，或者toast提示类型
+    if (errorType.value.indexOf('none') >= 0) return false;
+    else if (errorType.value.indexOf(type) >= 0) return true;
+    else return false;
+});
+
+// label的宽度
+const elLabelWidth = computed(() => {
+    // label默认宽度为90，优先使用本组件的值，如果没有(如果设置为0，也算是配置了值，依然起效)，则用u-form的值
+    return props.labelWidth != 0 && props.labelWidth !== '' ? props.labelWidth : parentData.value.labelWidth ? parentData.value.labelWidth : 90;
+});
+
+// label的样式
+const elLabelStyle = computed(() => {
+    return Object.keys(props.labelStyle).length ? props.labelStyle : parentData.value.labelStyle ? parentData.value.labelStyle : {};
+});
+
+// label的位置，左侧或者上方
+const elLabelPosition = computed(() => {
+    return props.labelPosition ? props.labelPosition : parentData.value.labelPosition ? parentData.value.labelPosition : 'left';
+});
+
+// label的对齐方式
+const elLabelAlign = computed(() => {
+    return props.labelAlign ? props.labelAlign : parentData.value.labelAlign ? parentData.value.labelAlign : 'left';
+});
+
+// label的下划线
+const elBorderBottom = computed(() => {
+    // 子组件的borderBottom默认为空字符串，如果不等于空字符串，意味着子组件设置了值，优先使用子组件的值
+    return props.borderBottom !== '' ? props.borderBottom : parentData.value.borderBottom ? parentData.value.borderBottom : true;
+});
+
+// 事件派发/广播工具
+function broadcastInputError() {
+    // 子组件发出事件，第三个参数为true或者false，true代表有错误
+    if (instance) {
+        // 这里可用 emitter 工具库的 broadcast 方法
+        // 子组件发出事件，第三个参数为true或者false，true代表有错误
+        broadcast(instance, 'u-input', 'on-form-item-error', validateState.value === 'error' && showError.value('border'));
+    }
+}
+
+/**
+ * 添加表单校验事件监听
+ */
+function setRules() {
+    // 由于人性化考虑，必填"*"号通过props的required配置，不再通过rules的规则自动生成
+    // 从父组件u-form拿到当前u-form-item需要验证 的规则
+    // let rules = this.getRules();
+    // if (rules.length) {
+    // 	this.isRequired = rules.some(rule => {
+    // 		// 如果有必填项，就返回，没有的话，就是undefined
+    // 		return rule.required;
+    // 	});
+    // }
+    // // blur事件，失效了
+    // uni.$on('on-form-blur', onFieldBlur)
+    // // change事件，失效了
+    // uni.$on('on-form-change', onFieldChange)
+}
+
+/**
+ * 获取当前u-form-item的校验规则
+ */
+function getRules() {
+    // 父组件的所有规则
+    let rules = parent?.rules?.value || parent?.rules || {};
+    rules = rules ? rules[props.prop] : [];
+    // 保证返回的是一个数组形式
+    return [].concat(rules || []);
+}
+
+// blur事件时进行表单校验
+function onFieldBlur() {
+    validation('blur');
+}
+
+// change事件进行表单校验
+function onFieldChange() {
+    validation('change');
+}
+
+function onFormBlur() {
+    onFieldBlur();
+}
+
+function onFormChange() {
+    onFieldChange();
+}
+
+/**
+ * 过滤出符合要求的rule规则
+ * @param triggerType 触发类型
+ */
+function getFilteredRule(triggerType = '') {
+    // 获取所有规则
+    const rules = getRules();
+    // 整体验证表单时，triggerType为空字符串，此时返回所有规则进行验证
+    if (!triggerType) return rules;
+    // 历遍判断规则是否有对应的事件，比如blur，change触发等的事件
+    // 使用indexOf判断，是因为某些时候设置的验证规则的trigger属性可能为多个，比如['blur','change']
+    // 某些场景可能的判断规则，可能不存在trigger属性，故先判断是否存在此属性
+    return rules.filter((res: any) => res.trigger && res.trigger.indexOf(triggerType) !== -1);
+}
+
+/**
+ * 校验数据
+ * @param trigger 触发类型
+ * @param callback 校验回调
+ */
+function validation(trigger: string, callback: (msg: string) => void = () => {}) {
+    // 检验之前，先获取需要校验的值
+    fieldValue.value = parent?.model?.[props.prop];
+    // blur和change是否有当前方式的校验规则
+    let rules = getFilteredRule(trigger);
+    // 判断是否有验证规则，如果没有规则，也调用回调方法，否则父组件u-form会因为
+    // 对count变量的统计错误而无法进入上一层的回调
+    if (!rules || rules.length === 0) {
+        callback('');
+        return;
+    }
+    // 设置当前的状态，标识为校验中
+    validateState.value = 'validating';
+    // 调用async-validator的方法
+    let validator = new schema({ [props.prop]: rules });
+    validator.validate({ [props.prop]: fieldValue.value }, { firstFields: true }, (errors: any, fields: any) => {
+        // 记录状态和报错信息
+        validateState.value = !errors ? 'success' : 'error';
+        validateMessage.value = errors ? errors[0].message : '';
+        // 调用回调方法
+        callback(validateMessage.value);
+    });
+}
+
+/**
+ * 清空当前的u-form-item
+ */
+function resetField() {
+    if (parent?.model && props.prop) {
+        parent.model[props.prop] = initialValue.value;
+    }
+    // 设置为`success`状态，只是为了清空错误标记
+    validateState.value = 'success';
+}
+
+// 组件挂载时注册到父表单
+onMounted(() => {
+    // 兼容 provide/inject 及 $u.$parent
+    if (parent) {
+        // 继承父表单配置
+        // 历遍parentData中的属性，将parent中的同名属性赋值给parentData
+        Object.keys(parentData.value).forEach(key => {
+            // @ts-ignore
+            if (parent.props[key] !== undefined) parentData.value[key] = parent.props[key];
+        });
+        // 如果没有传入prop，或者uForm为空(如果u-form-input单独使用，就不会有uForm注入)，就不进行校验
+        if (props.prop) {
+            // 将本实例添加到父组件中
+            parent.addField &&
+                parent.addField({
+                    validation,
+                    resetField,
+                    prop: props.prop
+                });
+            errorType.value = parent.errorType || errorType.value;
+            // 设置初始值
+            fieldValue.value = parent.model?.[props.prop];
+            // 设置初始值
+            initialValue.value = fieldValue.value;
+            // 添加表单校验，这里必须要写在$nextTick中，因为u-form的rules是通过ref手动传入的
+            // 不在$nextTick中的话，可能会造成执行此处代码时，父组件还没通过ref把规则给u-form，导致规则为空
+            nextTick(() => {
+                setRules();
+            });
+        }
+    }
+});
+// 组件销毁前，将实例从u-form的缓存中移除
+onBeforeUnmount(() => {
+    // 如果当前没有prop的话表示当前不要进行删除（因为没有注入）
+    if (parent && props.prop) {
+        parent.removeField && parent.removeField({ prop: props.prop });
+    }
+});
+
+defineExpose({ validation, resetField, onFormBlur, onFormChange });
+</script>
+
+<style lang="scss" scoped>
+@import '../../libs/css/style.components.scss';
+
+.u-form-item {
+    @include vue-flex;
+    // align-items: flex-start;
+    padding: 20rpx 0;
+    font-size: 28rpx;
+    color: $u-main-color;
+    box-sizing: border-box;
+    line-height: $u-form-item-height;
+    flex-direction: column;
+
+    &__border-bottom--error:after {
+        border-color: $u-type-error;
+    }
+
+    &__body {
+        @include vue-flex;
+    }
+
+    &--left {
+        @include vue-flex;
+        align-items: center;
+
+        &__content {
+            position: relative;
+            @include vue-flex;
+            align-items: center;
+            padding-right: 10rpx;
+            flex: 1;
+
+            &__icon {
+                margin-right: 8rpx;
+            }
+
+            &--required {
+                position: absolute;
+                left: -16rpx;
+                vertical-align: middle;
+                color: $u-type-error;
+                padding-top: 6rpx;
+            }
+
+            &__label {
+                @include vue-flex;
+                align-items: center;
+                flex: 1;
+            }
+        }
+    }
+
+    &--right {
+        flex: 1;
+
+        &__content {
+            @include vue-flex;
+            align-items: center;
+            flex: 1;
+
+            &__slot {
+                flex: 1;
+                /* #ifndef MP */
+                @include vue-flex;
+                align-items: center;
+                /* #endif */
+            }
+
+            &__icon {
+                margin-left: 10rpx;
+                color: $u-light-color;
+                font-size: 30rpx;
+            }
+        }
+    }
+
+    &__message {
+        font-size: 24rpx;
+        line-height: 24rpx;
+        color: $u-type-error;
+        margin-top: 12rpx;
+    }
+}
+</style>

package/components/u-full-screen/u-full-screen.vue

@@ -0,0 +1,80 @@
+<template>
+    <u-modal v-model="show" :show-cancel-button="true" confirm-text="升级" title="发现新版本" @cancel="cancel" @confirm="confirm">
+        <view class="u-update-content">
+            <rich-text :nodes="content"></rich-text>
+        </view>
+    </u-modal>
+</template>
+
+<script setup lang="ts">
+import { ref, onMounted } from 'vue';
+
+defineOptions({ name: 'u-full-screen' });
+
+/**
+ * 压窗屏升级弹窗组件
+ * @description 用于APP弹窗遮盖导航栏和底部tabbar，提示新版本升级内容
+ * @property {boolean} show 是否显示弹窗
+ * @property {string} content 升级内容，支持富文本
+ */
+
+/**
+ * 是否显示弹窗
+ */
+const show = ref(false);
+/**
+ * 升级内容，支持富文本
+ */
+const content = ref<string>(`
+  1. 修复badge组件的size参数无效问题<br>
+  2. 新增Modal模态框组件<br>
+  3. 新增压窗屏组件，可以在APP上以弹窗的形式遮盖导航栏和底部tabbar<br>
+  4. 修复键盘组件在微信小程序上遮罩无效的问题
+`);
+
+/**
+ * 页面加载完成后自动显示弹窗
+ */
+onMounted(() => {
+    show.value = true;
+});
+
+/**
+ * 取消按钮点击事件
+ * @description 关闭弹窗并返回上一页
+ */
+function cancel() {
+    closeModal();
+}
+
+/**
+ * 升级按钮点击事件
+ * @description 关闭弹窗并返回上一页
+ */
+function confirm() {
+    closeModal();
+}
+
+/**
+ * 关闭弹窗方法
+ * @description 返回上一页
+ */
+function closeModal() {
+    uni.navigateBack();
+}
+</script>
+
+<style scoped lang="scss">
+@import '../../libs/css/style.components.scss';
+
+.u-full-content {
+    background-color: #00c777;
+}
+
+.u-update-content {
+    font-size: 26rpx;
+    color: $u-content-color;
+    line-height: 1.7;
+    padding: 30rpx;
+}
+</style>

package/components/u-gap/u-gap.vue

@@ -0,0 +1,48 @@
+<template>
+    <view class="u-gap" :style="gapStyle"></view>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue';
+
+defineOptions({
+    name: 'u-gap'
+});
+
+/**
+ * gap 间隔槽
+ * @description 该组件一般用于内容块之间的用一个灰色块隔开的场景，方便用户风格统一，减少工作量
+ * @tutorial https://www.uviewui.com/components/gap.html
+ * @property {String} bg-color 背景颜色（默认#f3f4f6）
+ * @property {String Number} height 分割槽高度，单位rpx（默认30）
+ * @property {String Number} margin-top 与前一个组件的距离，单位rpx（默认0）
+ * @property {String Number} margin-bottom 与后一个组件的距离，单位rpx（0）
+ * @example <u-gap height="80" bg-color="#bbb"></u-gap>
+ */
+const props = defineProps({
+    /** 背景颜色 */
+    bgColor: { type: String, default: 'transparent' },
+    /** 高度 */
+    height: { type: [String, Number], default: 30 },
+    /** 与上一个组件的距离 */
+    marginTop: { type: [String, Number], default: 0 },
+    /** 与下一个组件的距离 */
+    marginBottom: { type: [String, Number], default: 0 }
+});
+
+/**
+ * 间隔槽样式
+ */
+const gapStyle = computed(() => {
+    return {
+        backgroundColor: props.bgColor,
+        height: props.height + 'rpx',
+        marginTop: props.marginTop + 'rpx',
+        marginBottom: props.marginBottom + 'rpx'
+    };
+});
+</script>
+
+<style lang="scss" scoped>
+@import '../../libs/css/style.components.scss';
+</style>

package/components/u-grid/u-grid.vue

@@ -0,0 +1,101 @@
+<template>
+    <view class="u-grid" :class="{ 'u-border-top u-border-left': border }" :style="[gridStyle]">
+        <slot />
+    </view>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, watch } from 'vue';
+defineOptions({ name: 'u-grid' });
+
+/**
+ * grid 宫格布局
+ * @description 宫格组件一般用于同时展示多个同类项目的场景，可以给宫格的项目设置徽标组件(badge)，或者图标等，也可以扩展为左右滑动的轮播形式。
+ * @tutorial https://www.uviewui.com/components/grid.html
+ * @property {String|Number} col 宫格的列数（默认3）
+ * @property {Boolean} border 是否显示宫格的边框（默认true）
+ * @property {Boolean} hover-class 点击宫格的时候，是否显示按下的灰色背景（默认false）
+ * @event {Function} click 点击宫格触发
+ * @example <u-grid :col="3" @click="click"></u-grid>
+ */
+
+const props = defineProps({
+    /** 分成几列 */
+    col: { type: [Number, String], default: 3 },
+    /** 是否显示边框 */
+    border: { type: Boolean, default: true },
+    /** 宫格对齐方式，表现为数量少的时候，靠左，居中，还是靠右 */
+    align: { type: String, default: 'left' },
+    /** 宫格按压时的样式类，"none"为无效果 */
+    hoverClass: { type: String, default: 'u-hover-class' }
+});
+
+// emits 定义
+const emit = defineEmits(['click']);
+
+// 当前 grid 的子项集合
+const children = ref<any[]>([]);
+
+// 计算父组件的值是否发生变化
+const parentData = computed(() => [props.hoverClass, props.col, props.border, props.align]);
+
+// 宫格对齐方式
+const gridStyle = computed(() => {
+    const style: Record<string, string> = {};
+    switch (props.align) {
+        case 'left':
+            style.justifyContent = 'flex-start';
+            break;
+        case 'center':
+            style.justifyContent = 'center';
+            break;
+        case 'right':
+            style.justifyContent = 'flex-end';
+            break;
+        default:
+            style.justifyContent = 'flex-start';
+    }
+    return style;
+});
+
+// 监听父参数变化，通知子组件
+watch(parentData, () => {
+    if (children.value.length) {
+        children.value.forEach(child => {
+            child.exposed.updateParentData();
+        });
+    }
+});
+
+// 兼容原 created 钩子
+children.value = [];
+
+/**
+ * 点击宫格
+ * @param index 子项索引
+ */
+function click(index: number) {
+    emit('click', index);
+}
+
+defineExpose({ click, children, props });
+</script>
+
+<style scoped lang="scss">
+@import '../../libs/css/style.components.scss';
+
+.u-grid {
+    width: 100%;
+    /* #ifdef MP */
+    position: relative;
+    box-sizing: border-box;
+    overflow: hidden;
+    /* #endif */
+
+    /* #ifndef MP */
+    @include vue-flex;
+    flex-wrap: wrap;
+    align-items: center;
+    /* #endif */
+}
+</style>