uview-pro 0.0.1

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

@@ -0,0 +1,136 @@
+<template>
+    <view
+        class="u-grid-item"
+        :hover-class="parentData.hoverClass"
+        :hover-stay-time="200"
+        @tap="click"
+        :style="{
+            background: bgColor,
+            width: width
+        }"
+    >
+        <view class="u-grid-item-box" :style="[customStyle]" :class="[parentData.border ? 'u-border-right u-border-bottom' : '']">
+            <slot />
+        </view>
+    </view>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, getCurrentInstance, onMounted } from 'vue';
+import { $u } from '../..';
+
+defineOptions({ name: 'u-grid-item' });
+
+/**
+ * gridItem 宫格项
+ * @description 宫格组件一般用于同时展示多个同类项目的场景，可以给宫格的项目设置徽标组件(badge)，或者图标等，也可以扩展为左右滑动的轮播形式。搭配u-grid使用
+ * @tutorial https://www.uviewui.com/components/grid.html
+ * @property {String} bg-color 宫格的背景颜色（默认#ffffff）
+ * @property {String|Number} index 点击宫格时，返回的值
+ * @property {Object} custom-style 自定义样式，对象形式
+ * @event {Function} click 点击宫格触发
+ * @example <u-grid-item></u-grid-item>
+ */
+
+// props 定义，保留参数注释
+const props = defineProps({
+    /** 背景颜色 */
+    bgColor: { type: String, default: '#ffffff' },
+    /** 点击时返回的index */
+    index: { type: [Number, String], default: '' },
+    /** 自定义样式，对象形式 */
+    customStyle: { type: Object, default: () => ({ padding: '30rpx 0' }) }
+});
+
+// emits 定义
+const emit = defineEmits(['click']);
+
+const instance = getCurrentInstance();
+
+// 父组件参数
+const parentData = ref({
+    hoverClass: '',
+    col: 3,
+    border: true
+});
+
+// 计算每个grid-item的宽度
+const width = computed(() => 100 / Number(parentData.value.col) + '%');
+
+// 获取父组件参数
+function updateParentData() {
+    if (!instance) return;
+    const parent = $u.parentData('u-grid', instance);
+    if (parent) {
+        parentData.value.hoverClass = parent.props.hoverClass;
+        parentData.value.col = parent.props.col;
+        parentData.value.border = parent.props.border;
+        // 注册到父组件children
+        if (Array.isArray(parent.children.value)) {
+            const exist = parent.children.value.find((val: any) => val === instance);
+            if (!exist) parent.children.value.push(instance);
+        }
+    }
+}
+
+/**
+ * 点击宫格
+ */
+function click() {
+    emit('click', props.index);
+    const parent = $u.parentData('u-grid', instance);
+    if (parent && typeof parent.click === 'function') parent.click(props.index);
+}
+
+onMounted(() => {
+    updateParentData();
+});
+
+defineExpose({ updateParentData, click });
+</script>
+
+<style scoped lang="scss">
+@import '../../libs/css/style.components.scss';
+
+.u-grid-item {
+    box-sizing: border-box;
+    background: #fff;
+    @include vue-flex;
+    align-items: center;
+    justify-content: center;
+    position: relative;
+    flex-direction: column;
+
+    /* #ifdef MP */
+    position: relative;
+    float: left;
+    /* #endif */
+}
+
+.u-grid-item-hover {
+    background: #f7f7f7 !important;
+}
+
+.u-grid-marker-box {
+    position: absolute;
+    /* #ifndef APP-NVUE */
+    display: inline-flex;
+    /* #endif */
+    line-height: 0;
+}
+
+.u-grid-marker-wrap {
+    position: absolute;
+}
+
+.u-grid-item-box {
+    padding: 30rpx 0;
+    @include vue-flex;
+    align-items: center;
+    justify-content: center;
+    flex-direction: column;
+    flex: 1;
+    width: 100%;
+    height: 100%;
+}
+</style>

package/components/u-icon/u-icon.vue

@@ -0,0 +1,389 @@
+<template>
+    <view :style="[customStyle]" class="u-icon" @tap="onClick" :class="['u-icon--' + labelPos]">
+        <image class="u-icon__img" v-if="isImg" :src="name" :mode="imgMode" :style="[imgStyle]" />
+        <text v-else class="u-icon__icon" :class="customClass" :style="[iconStyle]" :hover-class="hoverClass" @touchstart="onTouchstart">
+            <text v-if="showDecimalIcon" :style="[decimalIconStyle]" :class="decimalIconClass" :hover-class="hoverClass" class="u-icon__decimal"></text>
+        </text>
+        <text v-if="label !== ''" class="u-icon__label" :style="labelStyle">
+            {{ label }}
+        </text>
+    </view>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue';
+import { $u } from '../..';
+
+defineOptions({
+    name: 'u-icon'
+});
+
+/**
+ * icon 图标
+ * @description 基于字体的图标集，包含了大多数常见场景的图标。
+ * @tutorial https://www.uviewui.com/components/icon.html
+ * @property {String} name 图标名称，见示例图标集
+ * @property {String} color 图标颜色（默认inherit）
+ * @property {String | Number} size 图标字体大小，单位rpx（默认32）
+ * @property {String | Number} label-size label字体大小，单位rpx（默认28）
+ * @property {String} label 图标右侧的label文字（默认28）
+ * @property {String} label-pos label文字相对于图标的位置，只能right或bottom（默认right）
+ * @property {String} label-color label字体颜色（默认#606266）
+ * @property {Object} custom-style icon的样式，对象形式
+ * @property {String} custom-prefix 自定义字体图标库时，需要写上此值
+ * @property {String | Number} margin-left label在右侧时与图标的距离，单位rpx（默认6）
+ * @property {String | Number} margin-top label在下方时与图标的距离，单位rpx（默认6）
+ * @property {String | Number} margin-bottom label在上方时与图标的距离，单位rpx（默认6）
+ * @property {String | Number} margin-right label在左侧时与图标的距离，单位rpx（默认6）
+ * @property {String} index 一个用于区分多个图标的值，点击图标时通过click事件传出
+ * @property {String} hover-class 图标按下去的样式类，用法同uni的view组件的hover-class参数，详情见官网
+ * @property {String} width 显示图片小图标时的宽度
+ * @property {String} height 显示图片小图标时的高度
+ * @property {String | Number} top 图标在垂直方向上的定位
+ * @property {Boolean} show-decimal-icon 是否为DecimalIcon
+ * @property {String} inactive-color 背景颜色，可接受主题色，仅Decimal时有效
+ * @property {String | Number} percent 显示的百分比，仅Decimal时有效
+ * @event {Function} click 点击图标时触发
+ * @event {Function} touchstart 图标触摸时触发
+ * @example <u-icon name="photo" color="#2979ff" size="28"></u-icon>
+ */
+
+const emit = defineEmits<{
+    (e: 'click', index: string | number): void;
+    (e: 'touchstart', index: string | number): void;
+}>();
+
+const props = defineProps({
+    /**
+     * 图标名称，见示例图标集
+     * @default ''
+     */
+    name: { type: String, default: '' },
+    /**
+     * 图标颜色，可接受主题色
+     * @default ''
+     */
+    color: { type: String, default: '' },
+    /**
+     * 字体大小，单位rpx（默认32）
+     * @default 'inherit'
+     */
+    size: { type: [Number, String], default: 'inherit' },
+    /**
+     * 是否显示粗体
+     * @default false
+     */
+    bold: { type: Boolean, default: false },
+    /**
+     * 点击图标的时候传递事件出去的index（用于区分点击了哪一个）
+     * @default ''
+     */
+    index: { type: [Number, String], default: '' },
+    /**
+     * 触摸图标时的类名
+     * @default ''
+     */
+    hoverClass: { type: String, default: '' },
+    /**
+     * 自定义扩展前缀，方便用户扩展自己的图标库
+     * @default 'uicon'
+     */
+    customPrefix: { type: String, default: 'uicon' },
+    /**
+     * 图标右边或者下面的文字
+     * @default ''
+     */
+    label: { type: [String, Number], default: '' },
+    /**
+     * label的位置，只能右边或者下边
+     * @default 'right'
+     * @values 'right' | 'bottom'
+     */
+    labelPos: { type: String, default: 'right' },
+    /**
+     * label的大小，单位rpx（默认28）
+     * @default '28'
+     */
+    labelSize: { type: [String, Number], default: '28' },
+    /**
+     * label的颜色
+     * @default '#606266'
+     */
+    labelColor: { type: String, default: '#606266' },
+    /**
+     * label与图标的距离(横向排列)，单位rpx（默认6）
+     * @default '6'
+     */
+    marginLeft: { type: [String, Number], default: '6' },
+    /**
+     * label与图标的距离(竖向排列)，单位rpx（默认6）
+     * @default '6'
+     */
+    marginTop: { type: [String, Number], default: '6' },
+    /**
+     * label与图标的距离(竖向排列)，单位rpx（默认6）
+     * @default '6'
+     */
+    marginRight: { type: [String, Number], default: '6' },
+    /**
+     * label与图标的距离(竖向排列)，单位rpx（默认6）
+     * @default '6'
+     */
+    marginBottom: { type: [String, Number], default: '6' },
+    /**
+     * 图片的mode，参考uni-app image组件
+     * @default 'widthFix'
+     */
+    imgMode: { type: String, default: 'widthFix' },
+    /**
+     * 自定义样式，对象形式
+     * @default {}
+     */
+    customStyle: { type: Object as () => Record<string, any>, default: () => ({}) },
+    /**
+     * 用于显示图片小图标时，图片的宽度，单位rpx
+     * @default ''
+     */
+    width: { type: [String, Number], default: '' },
+    /**
+     * 用于显示图片小图标时，图片的高度，单位rpx
+     * @default ''
+     */
+    height: { type: [String, Number], default: '' },
+    /**
+     * 用于解决某些情况下，让图标垂直居中的用途，单位rpx
+     * @default 0
+     */
+    top: { type: [String, Number], default: 0 },
+    /**
+     * 是否为DecimalIcon
+     * @default false
+     */
+    showDecimalIcon: { type: Boolean, default: false },
+    /**
+     * 背景颜色，可接受主题色，仅Decimal时有效
+     * @default '#ececec'
+     */
+    inactiveColor: { type: String, default: '#ececec' },
+    /**
+     * 显示的百分比，仅Decimal时有效
+     * @default '50'
+     */
+    percent: { type: [Number, String], default: '50' }
+});
+
+/**
+ * 计算图标的类名集合
+ * @returns {string[]}
+ */
+const customClass = computed(() => {
+    let classes: string[] | string = [];
+    classes.push(props.customPrefix + '-' + props.name);
+    // uView的自定义图标类名为u-iconfont
+    if (props.customPrefix === 'uicon') {
+        classes.push('u-iconfont');
+    } else {
+        classes.push(props.customPrefix);
+    }
+    // 主题色，通过类配置
+    if (props.showDecimalIcon && props.inactiveColor && $u.config.type.includes(props.inactiveColor)) {
+        classes.push('u-icon__icon--' + props.inactiveColor);
+    } else if (props.color && $u.config.type.includes(props.color)) {
+        classes.push('u-icon__icon--' + props.color);
+    }
+    // 阿里，头条，百度小程序通过数组绑定类名时，无法直接使用[a, b, c]的形式，否则无法识别
+    // 故需将其拆成一个字符串的形式，通过空格隔开各个类名
+    // #ifdef MP-ALIPAY || MP-TOUTIAO || MP-BAIDU
+    classes = (classes as string[]).join(' ');
+    // #endif
+    return classes;
+});
+
+/**
+ * 计算图标的样式
+ * @returns {CSSProperties}
+ */
+const iconStyle = computed(() => {
+    const style: Record<string, any> = {
+        fontSize: props.size === 'inherit' ? 'inherit' : $u.addUnit(props.size),
+        fontWeight: props.bold ? 'bold' : 'normal',
+        // 某些特殊情况需要设置一个到顶部的距离，才能更好的垂直居中
+        top: $u.addUnit(props.top)
+    };
+    // 非主题色值时，才当作颜色值
+    if (props.showDecimalIcon && props.inactiveColor && !$u.config.type.includes(props.inactiveColor)) {
+        style.color = props.inactiveColor;
+    } else if (props.color && !$u.config.type.includes(props.color)) {
+        style.color = props.color;
+    }
+    return style;
+});
+
+/**
+ * 判断传入的name属性是否为图片路径
+ * @returns {boolean}
+ */
+const isImg = computed(() => {
+    return props.name.indexOf('/') !== -1;
+});
+
+/**
+ * 计算图片图标的样式
+ * @returns {any}
+ */
+const imgStyle = computed(() => {
+    // 如果设置width和height属性，则优先使用，否则使用size属性
+    const style: any = {
+        width: props.width ? $u.addUnit(props.width) : $u.addUnit(props.size),
+        height: props.height ? $u.addUnit(props.height) : $u.addUnit(props.size)
+    };
+    return style;
+});
+
+/**
+ * 计算小数图标的样式，仅DecimalIcon时有效
+ * @returns {CSSProperties}
+ */
+const decimalIconStyle = computed(() => {
+    const style: any = {
+        fontSize: props.size === 'inherit' ? 'inherit' : $u.addUnit(props.size),
+        fontWeight: props.bold ? 'bold' : 'normal',
+        // 某些特殊情况需要设置一个到顶部的距离，才能更好的垂直居中
+        top: $u.addUnit(props.top),
+        width: props.percent + '%'
+    };
+    // 非主题色值时，才当作颜色值
+    if (props.color && !$u.config.type.includes(props.color)) {
+        style.color = props.color;
+    }
+    return style;
+});
+
+/**
+ * 计算小数图标的类名，仅DecimalIcon时有效
+ * @returns {string | string[]}
+ */
+const decimalIconClass = computed(() => {
+    let classes: string[] | string = [];
+    classes.push(props.customPrefix + '-' + props.name);
+    // uView的自定义图标类名为u-iconfont
+    if (props.customPrefix === 'uicon') {
+        classes.push('u-iconfont');
+    } else {
+        classes.push(props.customPrefix);
+    }
+    if (props.color && $u.config.type.includes(props.color)) {
+        classes.push('u-icon__icon--' + props.color);
+    } else {
+        classes.push('u-icon__icon--primary');
+    }
+    // 阿里，头条，百度小程序通过数组绑定类名时，无法直接使用[a, b, c]的形式，否则无法识别
+    // 故需将其拆成一个字符串的形式，通过空格隔开各个类名
+    // #ifdef MP-ALIPAY || MP-TOUTIAO || MP-BAIDU
+    classes = (classes as string[]).join(' ');
+    // #endif
+    return classes;
+});
+
+/**
+ * 计算label的样式
+ * @returns {any}
+ */
+const labelStyle = computed(() => {
+    return {
+        color: props.labelColor,
+        fontSize: $u.addUnit(props.labelSize),
+        marginLeft: props.labelPos === 'right' ? $u.addUnit(props.marginLeft) : 0,
+        marginTop: props.labelPos === 'bottom' ? $u.addUnit(props.marginTop) : 0,
+        marginRight: props.labelPos === 'left' ? $u.addUnit(props.marginRight) : 0,
+        marginBottom: props.labelPos === 'top' ? $u.addUnit(props.marginBottom) : 0
+    };
+});
+
+/**
+ * 点击图标时触发
+ * @emits click(index)
+ */
+function onClick() {
+    emit('click', props.index);
+}
+
+/**
+ * 图标触摸时触发
+ * @emits touchstart(index)
+ */
+function onTouchstart() {
+    emit('touchstart', props.index);
+}
+</script>
+
+<style scoped lang="scss">
+@import '../../libs/css/style.components.scss';
+@import '../../iconfont.css';
+
+.u-icon {
+    display: inline-flex;
+    align-items: center;
+
+    &--left {
+        flex-direction: row-reverse;
+        align-items: center;
+    }
+
+    &--right {
+        flex-direction: row;
+        align-items: center;
+    }
+
+    &--top {
+        flex-direction: column-reverse;
+        justify-content: center;
+    }
+
+    &--bottom {
+        flex-direction: column;
+        justify-content: center;
+    }
+
+    &__icon {
+        position: relative;
+
+        &--primary {
+            color: $u-type-primary;
+        }
+
+        &--success {
+            color: $u-type-success;
+        }
+
+        &--error {
+            color: $u-type-error;
+        }
+
+        &--warning {
+            color: $u-type-warning;
+        }
+
+        &--info {
+            color: $u-type-info;
+        }
+    }
+
+    &__decimal {
+        position: absolute;
+        top: 0;
+        left: 0;
+        display: inline-block;
+        overflow: hidden;
+    }
+
+    &__img {
+        height: auto;
+        will-change: transform;
+    }
+
+    &__label {
+        line-height: 1;
+    }
+}
+</style>

package/components/u-image/types.ts

@@ -0,0 +1,48 @@
+import { type ComponentPublicInstance, type ExtractPropTypes } from 'vue'
+
+// 定义 ImageProps 的类型
+export const ImageProps = {
+  /** 图片地址 */
+  src: { type: String, default: '' },
+  /** 裁剪模式 */
+  mode: { type: String, default: 'aspectFill' },
+  /** 宽度，单位任意，如果为数值，则为rpx单位（默认100%） */
+  width: { type: [String, Number], default: '100%' },
+  /** 高度，单位任意，如果为数值，则为rpx单位（默认 auto） */
+  height: { type: [String, Number], default: 'auto' },
+  /** 图片形状，circle-圆形，square-方形（默认square） */
+  shape: { type: String, default: 'square' },
+  /** 圆角值，单位任意，如果为数值，则为rpx单位（默认 0） */
+  borderRadius: { type: [String, Number], default: 0 },
+  /** 是否懒加载，仅微信小程序、App、百度小程序、字节跳动小程序有效（默认 true） */
+  lazyLoad: { type: Boolean, default: true },
+  /** 是否开启长按图片显示识别小程序码菜单，仅微信小程序有效（默认 true） */
+  showMenuByLongpress: { type: Boolean, default: true },
+  /** 加载中的图标，或者小图片（默认 photo） */
+  loadingIcon: { type: String, default: 'photo' },
+  /** 加载失败的图标，或者小图片（默认 error-circle） */
+  errorIcon: { type: String, default: 'error-circle' },
+  /** 是否显示加载中的图标或者自定义的slot（默认 true） */
+  showLoading: { type: Boolean, default: true },
+  /** 是否显示加载错误的图标或者自定义的slot（默认 true） */
+  showError: { type: Boolean, default: true },
+  /** 是否需要淡入效果（默认 true） */
+  fade: { type: Boolean, default: true },
+  /** 只支持网络资源，只对微信小程序有效（默认 false） */
+  webp: { type: Boolean, default: false },
+  /** 搭配fade参数的过渡时间，单位ms（默认 500） */
+  duration: { type: [String, Number], default: 500 },
+  /** 背景颜色，用于深色页面加载图片时，为了和背景色融合（默认 #f3f4f6） */
+  bgColor: { type: String, default: '#f3f4f6' }
+}
+
+// 将 ImageProps 转换为类型
+export type ImageProps = ExtractPropTypes<typeof ImageProps>
+
+// 暴露的组件实例方法
+export type ImageExpose = {
+  changeStatus: (status: 'loading' | 'error' | 'normal') => void
+}
+
+// 组件实例类型
+export type ImageInstance = ComponentPublicInstance<ImageProps, ImageExpose>