refactor: code structure of the single page data list (#4220)

#### What type of PR is this?

/area console
/kind improvement
/milestone 2.8.x

#### What this PR does / why we need it:

重构 Console 端页面管理列表的代码结构，封装列表项为单个组件。

#### Special notes for your reviewer:

需要测试页面管理的功能是否正常。

#### Does this PR introduce a user-facing change?

```release-note
None
```

console/src/modules/contents/pages/SinglePageList.vue

@@ -2,11 +2,8 @@
 import {
   IconArrowLeft,
   IconArrowRight,
-  IconEye,
-  IconEyeOff,
   IconAddCircle,
   IconRefreshLine,
-  IconExternalLinkLine,
   IconPages,
   VButton,
   VCard,
@@ -14,31 +11,23 @@ import {
   VSpace,
   Dialog,
   VEmpty,
-  VAvatar,
-  VStatusDot,
-  VEntity,
-  VEntityField,
   VLoading,
   VPageHeader,
   Toast,
-  VDropdownItem,
-  VDropdownDivider,
 } from "@halo-dev/components";
 import SinglePageSettingModal from "./components/SinglePageSettingModal.vue";
 import { computed, ref, watch } from "vue";
 import type { ListedSinglePage, SinglePage } from "@halo-dev/api-client";
 import { apiClient } from "@/utils/api-client";
-import { formatDatetime } from "@/utils/date";
-import { RouterLink } from "vue-router";
-import cloneDeep from "lodash.clonedeep";
-import { usePermission } from "@/utils/permission";
 import { singlePageLabels } from "@/constants/labels";
-import { useMutation, useQuery } from "@tanstack/vue-query";
+import { useQuery } from "@tanstack/vue-query";
 import { useI18n } from "vue-i18n";
 import UserFilterDropdown from "@/components/filter/UserFilterDropdown.vue";
+import SinglePageListItem from "./components/SinglePageListItem.vue";
+import { provide } from "vue";
+import type { Ref } from "vue";
 import { useRouteQuery } from "@vueuse/router";
 
-const { currentUserHasPermission } = usePermission();
 const { t } = useI18n();
 
 const settingModal = ref(false);
@@ -46,6 +35,8 @@ const selectedSinglePage = ref<SinglePage>();
 const selectedPageNames = ref<string[]>([]);
 const checkedAll = ref(false);
 
+provide<Ref<string[]>>("selectedPageNames", selectedPageNames);
+
 // Filters
 const selectedContributor = useRouteQuery<string | undefined>("contributor");
 const selectedVisible = useRouteQuery<
@@ -233,29 +224,6 @@ const handleCheckAllChange = (e: Event) => {
   }
 };
 
-const handleDelete = async (singlePage: SinglePage) => {
-  Dialog.warning({
-    title: t("core.page.operations.delete.title"),
-    description: t("core.page.operations.delete.description"),
-    confirmType: "danger",
-    confirmText: t("core.common.buttons.confirm"),
-    cancelText: t("core.common.buttons.cancel"),
-    onConfirm: async () => {
-      const singlePageToUpdate = cloneDeep(singlePage);
-      singlePageToUpdate.spec.deleted = true;
-      await apiClient.extension.singlePage.updatecontentHaloRunV1alpha1SinglePage(
-        {
-          name: singlePage.metadata.name,
-          singlePage: singlePageToUpdate,
-        }
-      );
-      await refetch();
-
-      Toast.success(t("core.common.toast.delete_success"));
-    },
-  });
-};
-
 const handleDeleteInBatch = async () => {
   Dialog.warning({
     title: t("core.page.operations.delete_in_batch.title"),
@@ -296,59 +264,9 @@ const handleDeleteInBatch = async () => {
   });
 };
 
-const getPublishStatus = (singlePage: SinglePage) => {
-  const { labels } = singlePage.metadata;
-  return labels?.[singlePageLabels.PUBLISHED] === "true"
-    ? t("core.page.filters.status.items.published")
-    : t("core.page.filters.status.items.draft");
-};
-
-const isPublishing = (singlePage: SinglePage) => {
-  const { spec, status, metadata } = singlePage;
-  return (
-    (spec.publish &&
-      metadata.labels?.[singlePageLabels.PUBLISHED] !== "true") ||
-    (spec.releaseSnapshot === spec.headSnapshot && status?.inProgress)
-  );
-};
-
 watch(selectedPageNames, (newValue) => {
   checkedAll.value = newValue.length === singlePages.value?.length;
 });
-
-const { mutate: changeVisibleMutation } = useMutation({
-  mutationFn: async (singlePage: SinglePage) => {
-    const { data } =
-      await apiClient.extension.singlePage.getcontentHaloRunV1alpha1SinglePage({
-        name: singlePage.metadata.name,
-      });
-    data.spec.visible = data.spec.visible === "PRIVATE" ? "PUBLIC" : "PRIVATE";
-    await apiClient.extension.singlePage.updatecontentHaloRunV1alpha1SinglePage(
-      {
-        name: singlePage.metadata.name,
-        singlePage: data,
-      },
-      {
-        mute: true,
-      }
-    );
-    await refetch();
-  },
-  retry: 3,
-  onSuccess: () => {
-    Toast.success(t("core.common.toast.operation_success"));
-  },
-  onError: () => {
-    Toast.error(t("core.common.toast.operation_failed"));
-  },
-});
-
-const getExternalUrl = (singlePage: SinglePage) => {
-  if (singlePage.metadata.labels?.[singlePageLabels.PUBLISHED] === "true") {
-    return singlePage.status?.permalink;
-  }
-  return `/preview/singlepages/${singlePage.metadata.name}`;
-};
 </script>
 
 <template>
@@ -540,164 +458,15 @@ const getExternalUrl = (singlePage: SinglePage) => {
           class="box-border h-full w-full divide-y divide-gray-100"
           role="list"
         >
-          <li v-for="(singlePage, index) in singlePages" :key="index">
+          <li
-            <VEntity :is-selected="checkSelection(singlePage.page)">
+            v-for="singlePage in singlePages"
-              <template
+            :key="singlePage.page.metadata.name"
-                v-if="currentUserHasPermission(['system:singlepages:manage'])"
-                #checkbox
           >
-                <input
+            <SinglePageListItem
-                  v-model="selectedPageNames"
+              :single-page="singlePage"
-                  :value="singlePage.page.metadata.name"
+              :is-selected="checkSelection(singlePage.page)"
-                  class="h-4 w-4 rounded border-gray-300 text-indigo-600"
+              @open-setting-modal="handleOpenSettingModal"
-                  type="checkbox"
             />
-              </template>
-              <template #start>
-                <VEntityField
-                  :title="singlePage.page.spec.title"
-                  :route="{
-                    name: 'SinglePageEditor',
-                    query: { name: singlePage.page.metadata.name },
-                  }"
-                >
-                  <template #extra>
-                    <VSpace>
-                      <RouterLink
-                        v-if="singlePage.page.status?.inProgress"
-                        v-tooltip="
-                          $t('core.common.tooltips.unpublished_content_tip')
-                        "
-                        :to="{
-                          name: 'SinglePageEditor',
-                          query: { name: singlePage.page.metadata.name },
-                        }"
-                        class="flex items-center"
-                      >
-                        <VStatusDot state="success" animate />
-                      </RouterLink>
-                      <a
-                        target="_blank"
-                        :href="getExternalUrl(singlePage.page)"
-                        class="hidden text-gray-600 transition-all hover:text-gray-900 group-hover:inline-block"
-                      >
-                        <IconExternalLinkLine class="h-3.5 w-3.5" />
-                      </a>
-                    </VSpace>
-                  </template>
-                  <template #description>
-                    <div class="flex w-full flex-col gap-1">
-                      <VSpace class="w-full">
-                        <span class="text-xs text-gray-500">
-                          {{
-                            $t("core.page.list.fields.visits", {
-                              visits: singlePage.stats.visit || 0,
-                            })
-                          }}
-                        </span>
-                        <span class="text-xs text-gray-500">
-                          {{
-                            $t("core.page.list.fields.comments", {
-                              comments: singlePage.stats.totalComment || 0,
-                            })
-                          }}
-                        </span>
-                      </VSpace>
-                    </div>
-                  </template>
-                </VEntityField>
-              </template>
-              <template #end>
-                <VEntityField>
-                  <template #description>
-                    <RouterLink
-                      v-for="(
-                        contributor, contributorIndex
-                      ) in singlePage.contributors"
-                      :key="contributorIndex"
-                      :to="{
-                        name: 'UserDetail',
-                        params: { name: contributor.name },
-                      }"
-                      class="flex items-center"
-                    >
-                      <VAvatar
-                        v-tooltip="contributor.displayName"
-                        size="xs"
-                        :src="contributor.avatar"
-                        :alt="contributor.displayName"
-                        circle
-                      ></VAvatar>
-                    </RouterLink>
-                  </template>
-                </VEntityField>
-                <VEntityField :description="getPublishStatus(singlePage.page)">
-                  <template v-if="isPublishing(singlePage.page)" #description>
-                    <VStatusDot
-                      :text="$t('core.common.tooltips.publishing')"
-                      animate
-                    />
-                  </template>
-                </VEntityField>
-                <VEntityField>
-                  <template #description>
-                    <IconEye
-                      v-if="singlePage.page.spec.visible === 'PUBLIC'"
-                      v-tooltip="$t('core.page.filters.visible.items.public')"
-                      class="cursor-pointer text-sm transition-all hover:text-blue-600"
-                      @click="changeVisibleMutation(singlePage.page)"
-                    />
-                    <IconEyeOff
-                      v-if="singlePage.page.spec.visible === 'PRIVATE'"
-                      v-tooltip="$t('core.page.filters.visible.items.private')"
-                      class="cursor-pointer text-sm transition-all hover:text-blue-600"
-                      @click="changeVisibleMutation(singlePage.page)"
-                    />
-                  </template>
-                </VEntityField>
-                <VEntityField v-if="singlePage?.page?.spec.deleted">
-                  <template #description>
-                    <VStatusDot
-                      v-tooltip="$t('core.common.status.deleting')"
-                      state="warning"
-                      animate
-                    />
-                  </template>
-                </VEntityField>
-                <VEntityField>
-                  <template #description>
-                    <span class="truncate text-xs tabular-nums text-gray-500">
-                      {{ formatDatetime(singlePage.page.spec.publishTime) }}
-                    </span>
-                  </template>
-                </VEntityField>
-              </template>
-              <template
-                v-if="currentUserHasPermission(['system:singlepages:manage'])"
-                #dropdownItems
-              >
-                <VDropdownItem
-                  @click="
-                    $router.push({
-                      name: 'SinglePageEditor',
-                      query: { name: singlePage.page.metadata.name },
-                    })
-                  "
-                >
-                  {{ $t("core.common.buttons.edit") }}
-                </VDropdownItem>
-                <VDropdownItem @click="handleOpenSettingModal(singlePage.page)">
-                  {{ $t("core.common.buttons.setting") }}
-                </VDropdownItem>
-                <VDropdownDivider />
-                <VDropdownItem
-                  type="danger"
-                  @click="handleDelete(singlePage.page)"
-                >
-                  {{ $t("core.common.buttons.delete") }}
-                </VDropdownItem>
-              </template>
-            </VEntity>
           </li>
         </ul>
       </Transition>

console/src/modules/contents/pages/components/SinglePageListItem.vue

@@ -0,0 +1,272 @@
+<script lang="ts" setup>
+import {
+  IconEye,
+  IconEyeOff,
+  IconExternalLinkLine,
+  VSpace,
+  Dialog,
+  VAvatar,
+  VStatusDot,
+  VEntity,
+  VEntityField,
+  Toast,
+  VDropdownItem,
+  VDropdownDivider,
+} from "@halo-dev/components";
+import { computed, ref } from "vue";
+import type { ListedSinglePage, SinglePage } from "@halo-dev/api-client";
+import { apiClient } from "@/utils/api-client";
+import { formatDatetime } from "@/utils/date";
+import { RouterLink } from "vue-router";
+import cloneDeep from "lodash.clonedeep";
+import { usePermission } from "@/utils/permission";
+import { singlePageLabels } from "@/constants/labels";
+import { useMutation, useQueryClient } from "@tanstack/vue-query";
+import { useI18n } from "vue-i18n";
+import { inject } from "vue";
+import type { Ref } from "vue";
+
+const { currentUserHasPermission } = usePermission();
+const { t } = useI18n();
+const queryClient = useQueryClient();
+
+const props = withDefaults(
+  defineProps<{
+    singlePage: ListedSinglePage;
+    isSelected?: boolean;
+  }>(),
+  {
+    isSelected: false,
+  }
+);
+
+const emit = defineEmits<{
+  (event: "open-setting-modal", post: SinglePage): void;
+}>();
+
+const selectedPageNames = inject<Ref<string[]>>("selectedPageNames", ref([]));
+
+const externalUrl = computed(() => {
+  const { metadata, status } = props.singlePage.page;
+  if (metadata.labels?.[singlePageLabels.PUBLISHED] === "true") {
+    return status?.permalink;
+  }
+  return `/preview/singlepages/${metadata.name}`;
+});
+
+const publishStatus = computed(() => {
+  const { labels } = props.singlePage.page.metadata;
+  return labels?.[singlePageLabels.PUBLISHED] === "true"
+    ? t("core.page.filters.status.items.published")
+    : t("core.page.filters.status.items.draft");
+});
+
+const isPublishing = computed(() => {
+  const { spec, status, metadata } = props.singlePage.page;
+  return (
+    (spec.publish &&
+      metadata.labels?.[singlePageLabels.PUBLISHED] !== "true") ||
+    (spec.releaseSnapshot === spec.headSnapshot && status?.inProgress)
+  );
+});
+
+const { mutate: changeVisibleMutation } = useMutation({
+  mutationFn: async (singlePage: SinglePage) => {
+    const { data } =
+      await apiClient.extension.singlePage.getcontentHaloRunV1alpha1SinglePage({
+        name: singlePage.metadata.name,
+      });
+    data.spec.visible = data.spec.visible === "PRIVATE" ? "PUBLIC" : "PRIVATE";
+    await apiClient.extension.singlePage.updatecontentHaloRunV1alpha1SinglePage(
+      {
+        name: singlePage.metadata.name,
+        singlePage: data,
+      },
+      {
+        mute: true,
+      }
+    );
+    await queryClient.invalidateQueries({ queryKey: ["singlePages"] });
+  },
+  retry: 3,
+  onSuccess: () => {
+    Toast.success(t("core.common.toast.operation_success"));
+  },
+  onError: () => {
+    Toast.error(t("core.common.toast.operation_failed"));
+  },
+});
+
+const handleDelete = async () => {
+  Dialog.warning({
+    title: t("core.page.operations.delete.title"),
+    description: t("core.page.operations.delete.description"),
+    confirmType: "danger",
+    confirmText: t("core.common.buttons.confirm"),
+    cancelText: t("core.common.buttons.cancel"),
+    onConfirm: async () => {
+      const singlePageToUpdate = cloneDeep(props.singlePage.page);
+      singlePageToUpdate.spec.deleted = true;
+      await apiClient.extension.singlePage.updatecontentHaloRunV1alpha1SinglePage(
+        {
+          name: props.singlePage.page.metadata.name,
+          singlePage: singlePageToUpdate,
+        }
+      );
+      await queryClient.invalidateQueries({ queryKey: ["singlePages"] });
+
+      Toast.success(t("core.common.toast.delete_success"));
+    },
+  });
+};
+</script>
+
+<template>
+  <VEntity :is-selected="isSelected">
+    <template
+      v-if="currentUserHasPermission(['system:singlepages:manage'])"
+      #checkbox
+    >
+      <input
+        v-model="selectedPageNames"
+        :value="singlePage.page.metadata.name"
+        class="h-4 w-4 rounded border-gray-300 text-indigo-600"
+        type="checkbox"
+      />
+    </template>
+    <template #start>
+      <VEntityField
+        :title="singlePage.page.spec.title"
+        :route="{
+          name: 'SinglePageEditor',
+          query: { name: singlePage.page.metadata.name },
+        }"
+      >
+        <template #extra>
+          <VSpace>
+            <RouterLink
+              v-if="singlePage.page.status?.inProgress"
+              v-tooltip="$t('core.common.tooltips.unpublished_content_tip')"
+              :to="{
+                name: 'SinglePageEditor',
+                query: { name: singlePage.page.metadata.name },
+              }"
+              class="flex items-center"
+            >
+              <VStatusDot state="success" animate />
+            </RouterLink>
+            <a
+              target="_blank"
+              :href="externalUrl"
+              class="hidden text-gray-600 transition-all hover:text-gray-900 group-hover:inline-block"
+            >
+              <IconExternalLinkLine class="h-3.5 w-3.5" />
+            </a>
+          </VSpace>
+        </template>
+        <template #description>
+          <div class="flex w-full flex-col gap-1">
+            <VSpace class="w-full">
+              <span class="text-xs text-gray-500">
+                {{
+                  $t("core.page.list.fields.visits", {
+                    visits: singlePage.stats.visit || 0,
+                  })
+                }}
+              </span>
+              <span class="text-xs text-gray-500">
+                {{
+                  $t("core.page.list.fields.comments", {
+                    comments: singlePage.stats.totalComment || 0,
+                  })
+                }}
+              </span>
+            </VSpace>
+          </div>
+        </template>
+      </VEntityField>
+    </template>
+    <template #end>
+      <VEntityField>
+        <template #description>
+          <RouterLink
+            v-for="(contributor, contributorIndex) in singlePage.contributors"
+            :key="contributorIndex"
+            :to="{
+              name: 'UserDetail',
+              params: { name: contributor.name },
+            }"
+            class="flex items-center"
+          >
+            <VAvatar
+              v-tooltip="contributor.displayName"
+              size="xs"
+              :src="contributor.avatar"
+              :alt="contributor.displayName"
+              circle
+            ></VAvatar>
+          </RouterLink>
+        </template>
+      </VEntityField>
+      <VEntityField :description="publishStatus">
+        <template v-if="isPublishing" #description>
+          <VStatusDot :text="$t('core.common.tooltips.publishing')" animate />
+        </template>
+      </VEntityField>
+      <VEntityField>
+        <template #description>
+          <IconEye
+            v-if="singlePage.page.spec.visible === 'PUBLIC'"
+            v-tooltip="$t('core.page.filters.visible.items.public')"
+            class="cursor-pointer text-sm transition-all hover:text-blue-600"
+            @click="changeVisibleMutation(singlePage.page)"
+          />
+          <IconEyeOff
+            v-if="singlePage.page.spec.visible === 'PRIVATE'"
+            v-tooltip="$t('core.page.filters.visible.items.private')"
+            class="cursor-pointer text-sm transition-all hover:text-blue-600"
+            @click="changeVisibleMutation(singlePage.page)"
+          />
+        </template>
+      </VEntityField>
+      <VEntityField v-if="singlePage?.page?.spec.deleted">
+        <template #description>
+          <VStatusDot
+            v-tooltip="$t('core.common.status.deleting')"
+            state="warning"
+            animate
+          />
+        </template>
+      </VEntityField>
+      <VEntityField>
+        <template #description>
+          <span class="truncate text-xs tabular-nums text-gray-500">
+            {{ formatDatetime(singlePage.page.spec.publishTime) }}
+          </span>
+        </template>
+      </VEntityField>
+    </template>
+    <template
+      v-if="currentUserHasPermission(['system:singlepages:manage'])"
+      #dropdownItems
+    >
+      <VDropdownItem
+        @click="
+          $router.push({
+            name: 'SinglePageEditor',
+            query: { name: singlePage.page.metadata.name },
+          })
+        "
+      >
+        {{ $t("core.common.buttons.edit") }}
+      </VDropdownItem>
+      <VDropdownItem @click="emit('open-setting-modal', singlePage.page)">
+        {{ $t("core.common.buttons.setting") }}
+      </VDropdownItem>
+      <VDropdownDivider />
+      <VDropdownItem type="danger" @click="handleDelete">
+        {{ $t("core.common.buttons.delete") }}
+      </VDropdownItem>
+    </template>
+  </VEntity>
+</template>