111 lines
2.4 KiB
Markdown
111 lines
2.4 KiB
Markdown
# 往生殿功能使用说明
|
|
|
|
## 功能概述
|
|
|
|
往生殿页面展示往生者信息，支持动态数据加载、搜索功能和下拉刷新。
|
|
|
|
## 主要功能
|
|
|
|
### 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. 下拉刷新功能需要页面配置支持
|