feat: 新增多个组件并优化优惠券相关功能

- 新增 AppLinkSelectDialog 组件，用于选择 APP 链接- 新增 NavigationBarCellProperty组件，用于导航栏单元格属性设置 - 新增 CombinationShowcase 和 CombinationTableSelect 组件，用于拼团活动展示和选择- 优化优惠券相关组件，导出所有优惠券相关组件 - 新增 ComponentContainer 组件，用于包裹和样式化 DIY 组件
2025-08-04 09:09:39 +08:00
parent 38daaa2934
commit 2166ce3e4e
123 changed files with 11829 additions and 21 deletions
--- a/apps/web-ele/src/views/mall/promotion/point/components/point-showcase.vue
+++ b/apps/web-ele/src/views/mall/promotion/point/components/point-showcase.vue
@@ -0,0 +1,176 @@
+<script lang="ts" setup>
+import type { MallPointActivityApi } from '#/api/mall/promotion/point';
+
+import { computed, ref, watch } from 'vue';
+
+import * as PointActivityApi from '#/api/mall/promotion/point';
+
+import PointTableSelect from './point-table-select.vue';
+
+// 活动橱窗，一般用于装修时使用
+// 提供功能：展示活动列表、添加活动、删除活动
+defineOptions({ name: 'PointShowcase' });
+
+const props = defineProps({
+  modelValue: {
+    type: [Number, Array],
+    required: true,
+  },
+  // 限制数量：默认不限制
+  limit: {
+    type: Number,
+    default: Number.MAX_VALUE,
+  },
+  disabled: {
+    type: Boolean,
+    default: false,
+  },
+});
+
+const emit = defineEmits(['update:modelValue', 'change']);
+
+// 计算是否可以添加
+const canAdd = computed(() => {
+  // 情况一：禁用时不可以添加
+  if (props.disabled) return false;
+  // 情况二：未指定限制数量时，可以添加
+  if (!props.limit) return true;
+  // 情况三：检查已添加数量是否小于限制数量
+  return pointActivityList.value.length < props.limit;
+});
+
+// 拼团活动列表
+const pointActivityList = ref<MallPointActivityApi.PointActivity[]>([]);
+
+watch(
+  () => props.modelValue,
+  async () => {
+    let ids;
+    if (Array.isArray(props.modelValue)) {
+      ids = props.modelValue;
+    } else {
+      ids = props.modelValue ? [props.modelValue] : [];
+    }
+
+    // 不需要返显
+    if (ids.length === 0) {
+      pointActivityList.value = [];
+      return;
+    }
+    // 只有活动发生变化之后，才会查询活动
+    if (
+      pointActivityList.value.length === 0 ||
+      pointActivityList.value.some(
+        (pointActivity) => !ids.includes(pointActivity.id!),
+      )
+    ) {
+      pointActivityList.value =
+        await PointActivityApi.getPointActivityListByIds(ids as number[]);
+    }
+  },
+  { immediate: true },
+);
+
+/** 活动表格选择对话框 */
+const pointActivityTableSelectRef = ref();
+// 打开对话框
+const openSeckillActivityTableSelect = () => {
+  pointActivityTableSelectRef.value.open(pointActivityList.value);
+};
+
+/**
+ * 选择活动后触发
+ * @param activityList 选中的活动列表
+ */
+const handleActivitySelected = (
+  activityList:
+    | MallPointActivityApi.PointActivity
+    | MallPointActivityApi.PointActivity[],
+) => {
+  pointActivityList.value = Array.isArray(activityList)
+    ? activityList
+    : [activityList];
+  emitActivityChange();
+};
+
+/**
+ * 删除活动
+ * @param index 活动索引
+ */
+const handleRemoveActivity = (index: number) => {
+  pointActivityList.value.splice(index, 1);
+  emitActivityChange();
+};
+const emitActivityChange = () => {
+  if (props.limit === 1) {
+    const pointActivity =
+      pointActivityList.value.length > 0 ? pointActivityList.value[0] : null;
+    emit('update:modelValue', pointActivity?.id || 0);
+    emit('change', pointActivity);
+  } else {
+    emit(
+      'update:modelValue',
+      pointActivityList.value.map((pointActivity) => pointActivity.id),
+    );
+    emit('change', pointActivityList.value);
+  }
+};
+</script>
+<template>
+  <div class="gap-8px flex flex-wrap items-center">
+    <div
+      v-for="(pointActivity, index) in pointActivityList"
+      :key="pointActivity.id"
+      class="select-box spu-pic"
+    >
+      <el-tooltip :content="pointActivity.spuName">
+        <div class="relative h-full w-full">
+          <el-image :src="pointActivity.picUrl" class="h-full w-full" />
+          <Icon
+            v-show="!disabled"
+            class="del-icon"
+            icon="ep:circle-close-filled"
+            @click="handleRemoveActivity(index)"
+          />
+        </div>
+      </el-tooltip>
+    </div>
+    <el-tooltip v-if="canAdd" content="选择活动">
+      <div class="select-box" @click="openSeckillActivityTableSelect">
+        <Icon icon="ep:plus" />
+      </div>
+    </el-tooltip>
+  </div>
+  <!-- 拼团活动选择对话框（表格形式） -->
+  <PointTableSelect
+    ref="pointActivityTableSelectRef"
+    :multiple="limit !== 1"
+    @change="handleActivitySelected"
+  />
+</template>
+
+<style lang="scss" scoped>
+.select-box {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 60px;
+  height: 60px;
+  cursor: pointer;
+  border: 1px dashed var(--el-border-color-darker);
+  border-radius: 8px;
+}
+
+.spu-pic {
+  position: relative;
+}
+
+.del-icon {
+  position: absolute;
+  top: -10px;
+  right: -10px;
+  z-index: 1;
+  width: 20px !important;
+  height: 20px !important;
+}
+</style>
--- a/apps/web-ele/src/views/mall/promotion/point/components/point-table-select.vue
+++ b/apps/web-ele/src/views/mall/promotion/point/components/point-table-select.vue
@@ -0,0 +1,351 @@
+<script lang="ts" setup>
+import type { MallPointActivityApi } from '#/api/mall/promotion/point';
+
+import { computed, ref } from 'vue';
+
+import { dateFormatter, fenToYuanFormat } from '@vben/utils';
+
+import { CHANGE_EVENT } from 'element-plus';
+
+import * as PointActivityApi from '#/api/mall/promotion/point';
+import { DICT_TYPE, getIntDictOptions } from '#/utils/dict';
+
+/**
+ * 活动表格选择对话框
+ * 1. 单选模式：
+ *    1.1 点击表格左侧的单选框时，结束选择，并关闭对话框
+ *    1.2 再次打开时，保持选中状态
+ * 2. 多选模式：
+ *    2.1 点击表格左侧的多选框时，记录选中的活动
+ *    2.2 切换分页时，保持活动的选中状态
+ *    2.3 点击右下角的确定按钮时，结束选择，关闭对话框
+ *    2.4 再次打开时，保持选中状态
+ */
+defineOptions({ name: 'PointTableSelect' });
+
+defineProps({
+  // 多选模式
+  multiple: {
+    type: Boolean,
+    default: false,
+  },
+});
+
+/** 确认选择时的触发事件 */
+const emits = defineEmits<{
+  (
+    e: 'change',
+    v:
+      | any
+      | MallPointActivityApi.PointActivity
+      | MallPointActivityApi.PointActivity[],
+  ): void;
+}>();
+// 列表的总页数
+const total = ref(0);
+// 列表的数据
+const list = ref<MallPointActivityApi.PointActivity[]>([]);
+// 列表的加载中
+const loading = ref(false);
+// 弹窗的是否展示
+const dialogVisible = ref(false);
+// 查询参数
+const queryParams = ref({
+  pageNo: 1,
+  pageSize: 10,
+  name: null,
+  status: undefined,
+});
+const getRedeemedQuantity = computed(
+  () => (row: any) => (row.totalStock || 0) - (row.stock || 0),
+); // 获得商品已兑换数量
+/** 打开弹窗 */
+const open = (pointList?: MallPointActivityApi.PointActivity[]) => {
+  // 重置
+  checkedActivities.value = [];
+  checkedStatus.value = {};
+  isCheckAll.value = false;
+  isIndeterminate.value = false;
+
+  // 处理已选中
+  if (pointList && pointList.length > 0) {
+    checkedActivities.value = [...pointList];
+    checkedStatus.value = Object.fromEntries(
+      pointList.map((activityVO) => [activityVO.id, true]),
+    );
+  }
+
+  dialogVisible.value = true;
+  resetQuery();
+};
+// 提供 open 方法，用于打开弹窗
+defineExpose({ open });
+
+/** 查询列表 */
+const getList = async () => {
+  loading.value = true;
+  try {
+    const data = await PointActivityApi.getPointActivityPage(queryParams.value);
+    list.value = data.list;
+    total.value = data.total;
+    // checkbox绑定undefined会有问题，需要给一个bool值
+    list.value.forEach(
+      (activityVO) =>
+        (checkedStatus.value[activityVO.id] =
+          checkedStatus.value[activityVO.id] || false),
+    );
+    // 计算全选框状态
+    calculateIsCheckAll();
+  } finally {
+    loading.value = false;
+  }
+};
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  queryParams.value.pageNo = 1;
+  getList();
+};
+
+/** 重置按钮操作 */
+const resetQuery = () => {
+  queryParams.value = {
+    pageNo: 1,
+    pageSize: 10,
+    name: null,
+    status: undefined,
+  };
+  getList();
+};
+
+// 是否全选
+const isCheckAll = ref(false);
+// 全选框是否处于中间状态：不是全部选中 && 任意一个选中
+const isIndeterminate = ref(false);
+// 选中的活动
+const checkedActivities = ref<MallPointActivityApi.PointActivity[]>([]);
+// 选中状态：key为活动ID，value为是否选中
+const checkedStatus = ref<Record<string, boolean>>({});
+
+// 选中的活动 activityId
+const selectedActivityId = ref();
+/** 单选中时触发 */
+const handleSingleSelected = (
+  pointActivityVO: MallPointActivityApi.PointActivity,
+) => {
+  emits(CHANGE_EVENT, pointActivityVO);
+  // 关闭弹窗
+  dialogVisible.value = false;
+  // 记住上次选择的ID
+  selectedActivityId.value = pointActivityVO.id;
+};
+
+/** 多选完成 */
+const handleEmitChange = () => {
+  // 关闭弹窗
+  dialogVisible.value = false;
+  emits(CHANGE_EVENT, [...checkedActivities.value]);
+};
+
+/** 全选/全不选 */
+const handleCheckAll = (checked: boolean) => {
+  isCheckAll.value = checked;
+  isIndeterminate.value = false;
+
+  list.value.forEach((pointActivity) =>
+    handleCheckOne(checked, pointActivity, false),
+  );
+};
+
+/**
+ * 选中一行
+ * @param checked 是否选中
+ * @param pointActivity 活动
+ * @param isCalcCheckAll 是否计算全选
+ */
+const handleCheckOne = (
+  checked: boolean,
+  pointActivity: MallPointActivityApi.PointActivity,
+  isCalcCheckAll: boolean,
+) => {
+  if (checked) {
+    checkedActivities.value.push(pointActivity);
+    checkedStatus.value[pointActivity.id] = true;
+  } else {
+    const index = findCheckedIndex(pointActivity);
+    if (index > -1) {
+      checkedActivities.value.splice(index, 1);
+      checkedStatus.value[pointActivity.id] = false;
+      isCheckAll.value = false;
+    }
+  }
+
+  // 计算全选框状态
+  if (isCalcCheckAll) {
+    calculateIsCheckAll();
+  }
+};
+
+// 查找活动在已选中活动列表中的索引
+const findCheckedIndex = (activityVO: MallPointActivityApi.PointActivity) =>
+  checkedActivities.value.findIndex((item) => item.id === activityVO.id);
+
+// 计算全选框状态
+const calculateIsCheckAll = () => {
+  isCheckAll.value = list.value.every(
+    (activityVO) => checkedStatus.value[activityVO.id],
+  );
+  // 计算中间状态：不是全部选中 && 任意一个选中
+  isIndeterminate.value =
+    !isCheckAll.value &&
+    list.value.some((activityVO) => checkedStatus.value[activityVO.id]);
+};
+</script>
+
+<template>
+  <Dialog
+    v-model="dialogVisible"
+    :append-to-body="true"
+    title="选择活动"
+    width="70%"
+  >
+    <ContentWrap>
+      <!-- 搜索工作栏 -->
+      <el-form
+        :inline="true"
+        :model="queryParams"
+        class="-mb-15px"
+        label-width="68px"
+      >
+        <el-form-item label="活动状态" prop="status">
+          <el-select
+            v-model="queryParams.status"
+            class="!w-240px"
+            clearable
+            placeholder="请选择活动状态"
+          >
+            <el-option
+              v-for="dict in getIntDictOptions(DICT_TYPE.COMMON_STATUS)"
+              :key="dict.value"
+              :label="dict.label"
+              :value="dict.value"
+            />
+          </el-select>
+        </el-form-item>
+        <el-form-item>
+          <el-button @click="handleQuery">
+            <Icon class="mr-5px" icon="ep:search" />
+            搜索
+          </el-button>
+          <el-button @click="resetQuery">
+            <Icon class="mr-5px" icon="ep:refresh" />
+            重置
+          </el-button>
+        </el-form-item>
+      </el-form>
+      <el-table v-loading="loading" :data="list" show-overflow-tooltip>
+        <!-- 1. 多选模式（不能使用type="selection"，Element会忽略Header插槽） -->
+        <el-table-column v-if="multiple" width="55">
+          <template #header>
+            <el-checkbox
+              v-model="isCheckAll"
+              :indeterminate="isIndeterminate"
+              @change="handleCheckAll"
+            />
+          </template>
+          <template #default="{ row }">
+            <el-checkbox
+              v-model="checkedStatus[row.id]"
+              @change="(checked: boolean) => handleCheckOne(checked, row, true)"
+            />
+          </template>
+        </el-table-column>
+        <!-- 2. 单选模式 -->
+        <el-table-column v-else label="#" width="55">
+          <template #default="{ row }">
+            <el-radio
+              v-model="selectedActivityId"
+              :value="row.id"
+              @change="handleSingleSelected(row)"
+            >
+              <!-- 空格不能省略，是为了让单选框不显示label，如果不指定label不会有选中的效果 -->
+              &nbsp;
+            </el-radio>
+          </template>
+        </el-table-column>
+        <el-table-column label="活动编号" min-width="80" prop="id" />
+        <el-table-column label="商品图片" min-width="80" prop="spuName">
+          <template #default="scope">
+            <el-image
+              :preview-src-list="[scope.row.picUrl]"
+              :src="scope.row.picUrl"
+              class="h-40px w-40px"
+              preview-teleported
+            />
+          </template>
+        </el-table-column>
+        <el-table-column label="商品标题" min-width="300" prop="spuName" />
+        <el-table-column
+          :formatter="fenToYuanFormat"
+          label="原价"
+          min-width="100"
+          prop="marketPrice"
+        />
+        <el-table-column label="原价" min-width="100" prop="marketPrice" />
+        <el-table-column
+          align="center"
+          label="活动状态"
+          min-width="100"
+          prop="status"
+        >
+          <template #default="scope">
+            <dict-tag
+              :type="DICT_TYPE.COMMON_STATUS"
+              :value="scope.row.status"
+            />
+          </template>
+        </el-table-column>
+        <el-table-column
+          align="center"
+          label="库存"
+          min-width="80"
+          prop="stock"
+        />
+        <el-table-column
+          align="center"
+          label="总库存"
+          min-width="80"
+          prop="totalStock"
+        />
+        <el-table-column
+          align="center"
+          label="已兑换数量"
+          min-width="100"
+          prop="redeemedQuantity"
+        >
+          <template #default="{ row }">
+            {{ getRedeemedQuantity(row) }}
+          </template>
+        </el-table-column>
+        <el-table-column
+          :formatter="dateFormatter"
+          align="center"
+          label="创建时间"
+          prop="createTime"
+          width="180px"
+        />
+      </el-table>
+      <!-- 分页 -->
+      <Pagination
+        v-model:limit="queryParams.pageSize"
+        v-model:page="queryParams.pageNo"
+        :total="total"
+        @pagination="getList"
+      />
+    </ContentWrap>
+    <template v-if="multiple" #footer>
+      <el-button type="primary" @click="handleEmitChange">确 定</el-button>
+      <el-button @click="dialogVisible = false">取 消</el-button>
+    </template>
+  </Dialog>
+</template>