diff --git a/MEMORIAL_HALL_USAGE.md b/MEMORIAL_HALL_USAGE.md new file mode 100644 index 0000000..932b18d --- /dev/null +++ b/MEMORIAL_HALL_USAGE.md @@ -0,0 +1,95 @@ +# 往生殿功能使用说明 + +## 功能概述 +往生殿页面展示往生者信息,支持动态数据加载、搜索功能和下拉刷新。 + +## 主要功能 + +### 1. 动态数据加载 +- 页面加载时自动获取往生殿详情和往生者列表 +- 支持从路由参数获取往生殿ID +- 完善的加载状态和错误处理 + +### 2. 往生殿信息显示 +- **往生殿名称**: 动态显示从API获取的往生殿名称 +- **联系人信息**: 动态显示联系人和联系电话 +- **地址信息**: 动态显示往生殿地址 + +### 3. 往生者信息展示 +- 显示往生者的尊称和姓名 +- 显示出生日期(年月日) +- 显示逝世日期(年月日),如果数据为空则显示"吉"或"吉利" + +### 4. 搜索功能 +- 支持按姓名或分区搜索往生者 +- 实时更新搜索结果 +- 支持清空搜索条件 + +### 5. 下拉刷新 +- 支持下拉刷新数据 +- 同时刷新往生殿详情和往生者列表 +- 显示刷新成功/失败提示 + +## API接口 + +### 获取往生殿详情 +- **接口**: `/app/memorial/{id}` +- **方法**: GET +- **参数**: `id` - 往生殿ID +- **响应示例**: +```json +{ + "msg": "操作成功", + "code": 200, + "data": { + "id": "16", + "name": "牌位名字", + "contactPhone": "13768722834", + "contactName": "黄绍春", + "address": "广西壮族自治区南宁市西乡塘区" + } +} +``` + +### 获取往生者列表 +- **接口**: `/app/deceased/list` +- **方法**: GET +- **参数**: + - `memorialId`: 往生殿ID + - `pageNum`: 页码(可选) + - `pageSize`: 每页数量(可选) + - `keyword`: 搜索关键词(可选) + +## 使用方法 + +### 1. 页面跳转 +```javascript +// 跳转到往生殿页面 +uni.navigateTo({ + url: `/pages/memorial/memorialHall?id=16` +}) +``` + +### 2. 数据刷新 +- 下拉页面即可刷新数据 +- 或调用 `refreshData()` 方法 + +### 3. 搜索功能 +- 在搜索框中输入姓名或分区关键词 +- 点击搜索按钮或按回车键进行搜索 + +## 错误处理 +- 网络请求失败时显示友好提示 +- API返回错误时显示具体错误信息 +- 数据为空时显示"暂无往生者信息" + +## 样式特性 +- 响应式设计,适配不同屏幕尺寸 +- 加载状态和空数据状态的友好提示 +- 统一的视觉风格和交互体验 + +## 注意事项 +1. 确保网络连接正常 +2. 往生殿ID必须有效 +3. 搜索功能需要后端支持 +4. 下拉刷新功能需要页面配置支持 \ No newline at end of file diff --git a/pages/memorial/memorialHall.vue b/pages/memorial/memorialHall.vue index 554a41d..5560c00 100644 --- a/pages/memorial/memorialHall.vue +++ b/pages/memorial/memorialHall.vue @@ -20,15 +20,21 @@ - 中875 东10-29 + {{ memorialDetail ? memorialDetail.name : '加载中...' }} 收藏牌位 刻铭 + + + 加载中... + + + + + 暂无往生者信息 + + - 联系人:陈惠玲(13356989666) - 地址:福建省泉州市惠安县平山是旧路256号 + + 联系人:{{ memorialDetail.contactName || '暂无' }}({{ memorialDetail.contactPhone || '暂无' }}) + + + 地址:{{ memorialDetail.address }} + + + 联系人:暂无联系信息 + @@ -87,7 +105,7 @@