buddhism/MEMORIAL_HALL_USAGE.md

往生殿功能使用说明

功能概述

往生殿页面展示往生者信息，支持动态数据加载、搜索功能和下拉刷新。

主要功能

1. 动态数据加载

• 页面加载时自动获取往生殿详情和往生者列表
• 支持从路由参数获取往生殿ID
• 完善的加载状态和错误处理

2. 往生殿信息显示

• 往生殿名称: 动态显示从API获取的往生殿名称
• 联系人信息: 动态显示联系人和联系电话
• 地址信息: 动态显示往生殿地址

3. 往生者信息展示

• 显示往生者的尊称和姓名
• 显示出生日期（年月日）
• 显示逝世日期（年月日），如果数据为空则显示"吉"或"吉利"

4. 搜索功能

• 支持按姓名或分区搜索往生者
• 实时更新搜索结果
• 支持清空搜索条件

5. 下拉刷新

• 支持下拉刷新数据
• 同时刷新往生殿详情和往生者列表
• 显示刷新成功/失败提示

API接口

获取往生殿详情

• 接口: /app/memorial/{id}
• 方法: GET
• 参数: id - 往生殿ID
• 响应示例:

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "id": "16",
    "name": "牌位名字",
    "contactPhone": "13768722834",
    "contactName": "黄绍春",
    "address": "广西壮族自治区南宁市西乡塘区"
  }
}

获取往生者列表

• 接口: /app/deceased/list
• 方法: GET
• 参数:
  • memorialId: 往生殿ID
  • pageNum: 页码（可选）
  • pageSize: 每页数量（可选）
  • keyword: 搜索关键词（可选）

使用方法

1. 页面跳转

// 跳转到往生殿页面
uni.navigateTo({
  url: `/pages/memorial/memorialHall?id=16`,
})

2. 数据刷新

• 下拉页面即可刷新数据
• 或调用 refreshData() 方法

3. 搜索功能

• 在搜索框中输入姓名或分区关键词
• 点击搜索按钮或按回车键进行搜索

错误处理

• 网络请求失败时显示友好提示
• API返回错误时显示具体错误信息
• 数据为空时显示"暂无往生者信息"

样式特性

• 响应式设计，适配不同屏幕尺寸
• 加载状态和空数据状态的友好提示
• 统一的视觉风格和交互体验

注意事项

1. 确保网络连接正常
2. 往生殿ID必须有效
3. 搜索功能需要后端支持
4. 下拉刷新功能需要页面配置支持