看板

2026-03-25 14:54:15 +08:00
commit ab4646b43a
827 changed files with 123812 additions and 0 deletions
@@ -0,0 +1,38 @@
+import type { ExtractPropTypes, PropType } from 'vue';
+import type { BadgeSize, ThemeType } from '../../types/global';
+import { baseProps } from '../common/props';
+
+/**
+ * badge 角标类型定义
+ * @description 供 u-badge 组件 props 使用
+ */
+
+export const BadgeProps = {
+    ...baseProps,
+    /** 使用预设的背景颜色 primary,warning,success,error,info */
+    type: { type: String as PropType<ThemeType>, default: 'error' },
+    /** Badge的尺寸，default, mini */
+    size: { type: String as PropType<BadgeSize>, default: 'default' },
+    /** 是否是圆点 */
+    isDot: { type: Boolean, default: false },
+    /** 显示的数值内容 */
+    count: { type: [Number, String], default: undefined },
+    /** 展示封顶的数字值 */
+    overflowCount: { type: Number, default: 99 },
+    /** 当数值为 0 时，是否展示 Badge */
+    showZero: { type: Boolean, default: false },
+    /** 位置偏移 [number, number] */
+    offset: { type: Array as unknown as PropType<[number, number]>, default: () => [20, 20] },
+    /** 是否开启绝对定位，开启了offset才会起作用 */
+    absolute: { type: Boolean, default: true },
+    /** 字体大小 */
+    fontSize: { type: [String, Number], default: '24' },
+    /** 字体颜色 */
+    color: { type: String, default: 'var(--u-white-color)' },
+    /** badge的背景颜色 */
+    bgColor: { type: String, default: '' },
+    /** 是否让badge组件的中心点和父组件右上角重合，配置的话，offset将会失效 */
+    isCenter: { type: Boolean, default: false }
+};
+
+export type BadgeProps = ExtractPropTypes<typeof BadgeProps>;
@@ -0,0 +1,153 @@
+<template>
+    <view
+        v-if="show"
+        class="u-badge"
+        :class="[
+            isDot ? 'u-badge-dot' : '',
+            size === 'mini' ? 'u-badge-mini' : '',
+            type ? 'u-badge--bg--' + type : '',
+            customClass
+        ]"
+        :style="
+            $u.toStyle(
+                {
+                    top: (offset as number[])[0] + 'rpx',
+                    right: (offset as number[])[1] + 'rpx',
+                    fontSize: fontSize + 'rpx',
+                    position: absolute ? 'absolute' : 'static',
+                    color: color,
+                    backgroundColor: bgColor
+                },
+                boxStyle,
+                customStyle
+            )
+        "
+    >
+        {{ showText }}
+    </view>
+</template>
+
+<script lang="ts">
+export default {
+    name: 'u-badge',
+    options: {
+        addGlobalClass: true,
+        // #ifndef MP-TOUTIAO
+        virtualHost: true,
+        // #endif
+        styleIsolation: 'shared'
+    }
+};
+</script>
+
+<script setup lang="ts">
+import { computed } from 'vue';
+import { BadgeProps } from './types';
+import { $u } from '../..';
+
+/**
+ * badge 角标
+ * @description 本组件一般用于展示头像的地方，如个人中心，或者评论列表页的用户头像展示等场所。
+ * @tutorial https://uviewpro.cn/zh/components/badge.html
+ * @property {String|Number} count 展示的数字，大于 overflowCount 时显示为 ${overflowCount}+，为0且show-zero为false时隐藏
+ * @property {Boolean} is-dot 不展示数字，只有一个小点（默认false）
+ * @property {Boolean} absolute 组件是否绝对定位，为true时，offset参数才有效（默认true）
+ * @property {String|Number} overflow-count 展示封顶的数字值（默认99）
+ * @property {String} type 使用预设的背景颜色（默认error）
+ * @property {Boolean} show-zero 当数值为 0 时，是否展示 Badge（默认false）
+ * @property {String} size Badge的尺寸，设为mini会得到小一号的Badge（默认default）
+ * @property {Array} offset 设置badge的位置偏移，格式为 [x, y]，也即设置的为top和right的值，单位rpx。absolute为true时有效（默认[20, 20]）
+ * @property {String} color 字体颜色（默认var(--u-white-color)）
+ * @property {String} bgColor 背景颜色，优先级比type高，如设置，type参数会失效
+ * @property {Boolean} is-center 组件中心点是否和父组件右上角重合，优先级比offset高，如设置，offset参数会失效（默认false）
+ * @example <u-badge type="error" count="7"></u-badge>
+ */
+
+const props = defineProps(BadgeProps);
+
+/**
+ * 计算 badge 的定位和变换样式
+ */
+const boxStyle = computed(() => {
+    let style: Record<string, any> = {};
+    if (props.isCenter) {
+        style.top = 0;
+        style.right = 0;
+        // Y轴-50%，意味着badge向上移动了badge自身高度一半，X轴50%，意味着向右移动了自身宽度一半
+        style.transform = 'translateY(-50%) translateX(50%)';
+    } else {
+        style.top = (props.offset as number[])[0] + 'rpx';
+        style.right = (props.offset as number[])[1] + 'rpx';
+        style.transform = 'translateY(0) translateX(0)';
+    }
+    // 如果尺寸为mini，后接上scale()
+    if (props.size === 'mini') {
+        style.transform = style.transform + ' scale(0.8)';
+    }
+    return style;
+});
+
+/**
+ * 计算显示的文本内容
+ */
+const showText = computed(() => {
+    if (props.isDot) return '';
+    else {
+        if (Number(props.count) > props.overflowCount) return `${props.overflowCount}+`;
+        else return props.count;
+    }
+});
+
+/**
+ * 是否显示组件
+ */
+const show = computed(() => {
+    // 如果count的值为0，并且showZero设置为false，不显示组件
+    if (Number(props.count) === 0 && props.showZero === false) return false;
+    else return true;
+});
+</script>
+
+<style lang="scss" scoped>
+@import '../../libs/css/style.components.scss';
+
+.u-badge {
+    /* #ifndef APP-NVUE */
+    display: inline-flex;
+    /* #endif */
+    justify-content: center;
+    align-items: center;
+    line-height: 24rpx;
+    padding: 4rpx 8rpx;
+    border-radius: 100rpx;
+    z-index: 9;
+
+    &--bg--primary {
+        background-color: $u-type-primary;
+    }
+    &--bg--error {
+        background-color: $u-type-error;
+    }
+    &--bg--success {
+        background-color: $u-type-success;
+    }
+    &--bg--info {
+        background-color: $u-type-info;
+    }
+    &--bg--warning {
+        background-color: $u-type-warning;
+    }
+}
+
+.u-badge-dot {
+    height: 16rpx;
+    width: 16rpx;
+    border-radius: 100rpx;
+    line-height: 1;
+}
+
+.u-badge-mini {
+    transform: scale(0.8);
+    transform-origin: center center;
+}
+</style>