huangzhenbao/medical-mall

Fork 0

Files

huangzhenbao 21f4a0fa96 修改页面结构

2026-02-02 20:07:37 +08:00

13 KiB

Raw Blame History

后台页面 AdminLayout 包装修改计划

本文档详细说明需要修改的所有文件及具体修改方案。

修改方案概览

方案 1：完全包装（类别 B - 36个文件）

问题：完全没有使用 AdminLayout 包装解决：使用 AdminLayout 包装整个页面内容，并添加正确的 currentPage prop

修改模板：

<!-- 修改前 -->
<template>
  <view class="Page">
    <!-- 内容 -->
  </view>
</template>

<!-- 修改后 -->
<template>
  <AdminLayout :currentPage="'current-page-id'">
    <view class="Page">
      <!-- 内容 -->
    </view>
  </AdminLayout>
</template>

<script setup lang="uts">
import AdminLayout from '@/layouts/admin/AdminLayout.uvue'
// ... 其他代码
</script>

方案 2：使用已导入的 AdminLayout（类别 A - 27个文件）

问题：已经导入 AdminLayout，但在模板中没有使用解决：在模板中使用 AdminLayout 包装，并添加 currentPage prop

修改模板：

<!-- 修改前 -->
<template>
  <view class="Page">
    <!-- 内容 -->
  </view>
</template>

<script setup lang="uts">
import AdminLayout from '@/layouts/admin/AdminLayout.uvue' // 已导入但未使用
</script>

<!-- 修改后 -->
<template>
  <AdminLayout :currentPage="'page-id'">
    <view class="Page">
      <!-- 内容 -->
    </view>
  </AdminLayout>
</template>

<script setup lang="uts">
import AdminLayout from '@/layouts/admin/AdminLayout.uvue'
</script>

方案 3：修复属性名和值（类别 C 的属性名问题）

问题：使用 current-page （kebab-case）而非 currentPage （camelCase），或值不正确解决：使用正确的属性名和值

修改示例 - design/index.uvue：

<!-- 修改前 -->
<AdminLayout current-page='design'>

<!-- 修改后 -->
<AdminLayout :currentPage="'design-home'">

修改示例 - customer-service/list.uvue：

<!-- 修改前 -->
<AdminLayout current-page='list'>

<!-- 修改后 -->
<AdminLayout :currentPage="'cs-list'">

方案 4：修复内层 currentPage（类别 C 的位置问题）

问题：currentPage 被放在了内层 view 上，而非 AdminLayout 上解决：将 currentPage 移到 AdminLayout 组件上

修改示例 - user-statistics.uvue：

<!-- 修改前 -->
<template>
  <AdminLayout>
      <view class="Page" currentPage='user'>
        <!-- 内容 -->
      </view>
  </AdminLayout>
</template>

<!-- 修改后 -->
<template>
  <AdminLayout :currentPage="'user'">
    <view class="Page">
      <!-- 内容 -->
    </view>
  </AdminLayout>
</template>

方案 5：动态 currentPage（类别 D - user-management.uvue）

现状：已正确使用动态 currentPage，根据路由查询参数动态变化行动：验证实现正确性，无需修改

<template>
  <AdminLayout :currentPage="currentPage">
    <!-- 内容 -->
  </AdminLayout>
</template>

<script setup lang="uts">
import { ref } from 'vue'
import { onLoad } from '@dcloudio/uni-app'
import AdminLayout from '@/layouts/admin/AdminLayout.uvue'

const currentPage = ref('user-list')

onLoad((options) => {
  const action = options?.action as string | undefined
  if (action == 'group') currentPage.value = 'user-group'
  else if (action == 'tag') currentPage.value = 'user-tag'
  else if (action == 'level') currentPage.value = 'user-level'
  else if (action == 'config') currentPage.value = 'user-config'
  else currentPage.value = 'user-list'
})
</script>

方案 6：处理多 tab 页面（order-management.uvue、marketing/points/index.uvue）

问题：页面根据 tab 查询参数显示不同内容，需要动态设置 currentPage 解决：根据 tab 参数动态设置 currentPage

修改示例 - order-management.uvue：

<template>
  <AdminLayout :currentPage="currentPage">
    <view class="Page">
      <!-- 内容 -->
    </view>
  </AdminLayout>
</template>

<script setup lang="uts">
import { ref } from 'vue'
import { onLoad } from '@dcloudio/uni-app'
import AdminLayout from '@/layouts/admin/AdminLayout.uvue'

const currentPage = ref('order-list')

onLoad((options) => {
  const tab = options?.tab as string | undefined
  switch (tab) {
    case 'stats':
      currentPage.value = 'order-stats'
      break
    case 'aftersale':
      currentPage.value = 'order-aftersale'
      break
    case 'cashier':
      currentPage.value = 'order-cashier'
      break
    case 'verify':
      currentPage.value = 'order-verify'
      break
    case 'config':
      currentPage.value = 'order-config'
      break
    default:
      currentPage.value = 'order-list'
  }
})
</script>

需要修改的文件详细清单

【类别 A】已导入但未在模板中使用（27个文件）

需要在模板中使用 AdminLayout 包装，并添加 currentPage prop。

商品管理（6个文件）

pages/mall/admin/product-classification.uvue → currentPage: product-classification
pages/mall/admin/product-specifications.uvue → currentPage: product-specifications
pages/mall/admin/product-parameters.uvue → currentPage: product-parameters
pages/mall/admin/product-labels.uvue → currentPage: product-labels
pages/mall/admin/product-protection.uvue → currentPage: product-protection
pages/mall/admin/product-reviews.uvue → currentPage: product-reviews

系统设置（8个文件）

pages/mall/admin/system/message-management.uvue → currentPage: sys-message
pages/mall/admin/system/agreement-settings.uvue → currentPage: sys-agreement
pages/mall/admin/system/receipt-settings.uvue → currentPage: sys-receipt
pages/mall/admin/system/permission/role.uvue → currentPage: sys-role
pages/mall/admin/system/permission/admin-list.uvue → currentPage: sys-admin
pages/mall/admin/system/permission/permission-setting.uvue → currentPage: sys-perm-setting
pages/mall/admin/system/api/yht/page.uvue → currentPage: api-yht-page
pages/mall/admin/system/api/yht/config.uvue → currentPage: api-yht-config

系统 API 配置（6个文件）

pages/mall/admin/system/api/storage.uvue → currentPage: api-storage
pages/mall/admin/system/api/collect.uvue → currentPage: api-collect
pages/mall/admin/system/api/logistics.uvue → currentPage: api-logistics
pages/mall/admin/system/api/waybill.uvue → currentPage: api-waybill
pages/mall/admin/system/api/sms.uvue → currentPage: api-sms
pages/mall/admin/system/api/pay.uvue → currentPage: api-pay

维护管理 - 开发配置（5个文件）

pages/mall/admin/maintain/dev-config/combination-data.uvue → currentPage: dev-config-combo
pages/mall/admin/maintain/dev-config/cron-job.uvue → currentPage: dev-config-cron
pages/mall/admin/maintain/dev-config/permission.uvue → currentPage: dev-config-permission
pages/mall/admin/maintain/dev-config/module-config.uvue → currentPage: dev-config-module
pages/mall/admin/maintain/dev-config/custom-event.uvue → currentPage: dev-config-event

维护管理 - 安全维护（3个文件）

pages/mall/admin/maintain/security/refresh-cache.uvue → currentPage: security-refresh-cache
pages/mall/admin/maintain/security/system-log.uvue → currentPage: security-system-log
pages/mall/admin/maintain/security/online-upgrade.uvue → currentPage: security-online-upgrade

【类别 B】完全未使用 AdminLayout（36个文件）

需要完全重新包装和导入，并添加 currentPage prop。

商品与订单管理（2个文件）

pages/mall/admin/product-management.uvue → currentPage: product-list
pages/mall/admin/order-management.uvue → currentPage: 根据 tab 参数动态设置

营销管理（7个文件）

pages/mall/admin/marketing/coupon/list.uvue → currentPage: coupon-list
pages/mall/admin/marketing/coupon/receive.uvue → currentPage: coupon-receive
pages/mall/admin/marketing/points/index.uvue → currentPage: 根据 tab 参数动态设置
pages/mall/admin/marketing/signin/rule.uvue → currentPage: signin-rule
pages/mall/admin/marketing/signin/record.uvue → currentPage: signin-record

客服管理（4个文件）

pages/mall/admin/customer-service/script.uvue → currentPage: cs-script
pages/mall/admin/customer-service/messages.uvue → currentPage: cs-message
pages/mall/admin/customer-service/auto-reply.uvue → currentPage: cs-auto-reply
pages/mall/admin/customer-service/config.uvue → currentPage: cs-config

系统 - 发货设置（4个文件）

pages/mall/admin/system/shipping/courier.uvue → currentPage: ship-courier
pages/mall/admin/system/shipping/pickup/points.uvue → currentPage: pickup-points
pages/mall/admin/system/shipping/pickup/verifiers.uvue → currentPage: pickup-verifier
pages/mall/admin/system/shipping/freight-template.uvue → currentPage: ship-freight

维护 - 数据维护（3个文件）

pages/mall/admin/maintain/data/logistics-company.uvue → currentPage: data-logistics-company
pages/mall/admin/maintain/data/city-data.uvue → currentPage: data-city-data
pages/mall/admin/maintain/data/clear-data.uvue → currentPage: data-clear-data

维护 - 对外接口（1个文件）

pages/mall/admin/maintain/external/account.uvue → currentPage: external-account

维护 - 语言设置（4个文件）

pages/mall/admin/maintain/i18n/language-list.uvue → currentPage: i18n-language-list
pages/mall/admin/maintain/i18n/language-detail.uvue → currentPage: i18n-language-detail
pages/mall/admin/maintain/i18n/region-list.uvue → currentPage: i18n-region-list
pages/mall/admin/maintain/i18n/translate-config.uvue → currentPage: i18n-translate-config

维护 - 开发工具（5个文件）

pages/mall/admin/maintain/dev-tools/database.uvue → currentPage: dev-tools-db
pages/mall/admin/maintain/dev-tools/file.uvue → currentPage: dev-tools-file
pages/mall/admin/maintain/dev-tools/api.uvue → currentPage: dev-tools-api
pages/mall/admin/maintain/dev-tools/codegen.uvue → currentPage: dev-tools-codegen
pages/mall/admin/maintain/dev-tools/data-dict.uvue → currentPage: dev-tools-dict

【类别 C】需要修复 currentPage（7个文件）

修复属性名（2个文件）

pages/mall/admin/design/index.uvue
- 修改前：<AdminLayout current-page='design'>
- 修改后：<AdminLayout :currentPage="'design-home'">
pages/mall/admin/customer-service/list.uvue
- 修改前：<AdminLayout current-page='list'>
- 修改后：<AdminLayout :currentPage="'cs-list'">

修复位置和属性名（1个文件）

pages/mall/admin/user-statistics.uvue

修改前：

<AdminLayout>
  <view class="Page" currentPage='user'>

修改后：

<AdminLayout :currentPage="'user'">
  <view class="Page">

添加 currentPage（3个文件）

pages/mall/admin/content/index.uvue → 添加 currentPage: content-list
pages/mall/admin/system-settings.uvue → 添加 currentPage: sys-basic
pages/mall/admin/maintain/dev-config/category.uvue → 添加 currentPage: dev-config-category
pages/mall/admin/maintain/system-info.uvue → 添加 currentPage: system-info

【类别 D】动态 currentPage（已正确 - 需验证）

pages/mall/admin/user-management.uvue ✅
- 已正确实现根据 action 参数动态设置 currentPage
- 无需修改

修改优先级建议

🔴 优先级 1 - 高危（15个文件 - 必须修改）

这些文件完全没有 AdminLayout，会导致页面无法正确显示导航和布局：

product-management.uvue
order-management.uvue
marketing/coupon/list.uvue
marketing/coupon/receive.uvue
marketing/points/index.uvue
marketing/signin/rule.uvue
marketing/signin/record.uvue
customer-service/*.uvue (4个文件)
system/shipping/*.uvue (4个文件)

🟡 优先级 2 - 中等（20个文件 - 应该修改）

这些文件已导入 AdminLayout 但未使用，或属性不正确：

product-*.uvue (6个文件)
system/api/*.uvue (8个文件)
maintain/dev-config/*.uvue (5个)
design/index.uvue, user-statistics.uvue, 等

🟢 优先级 3 - 低（验证阶段）

user-management.uvue (已正确实现)

实施建议

分批修改：按优先级分批修改，每批10-15个文件
验证方法：修改后在浏览器中访问每个页面，检查是否正确显示 AdminLayout
检查清单：
- 左侧导航菜单是否显示
- 正确的菜单项是否高亮
- 顶部面包屑导航是否正确
- 页面内容是否正确显示

文档生成时间：2026年1月30日

13 KiB Raw Blame History Unescape Escape