更新记录

1.0.0(2026-11-18) 下载此版本

初始版本:三栏聊天界面、会话切换、消息发送、搜索过滤、通讯录与个人中心、过渡动画、响应式布局。


平台兼容性

HbuilderX/cli最低兼容版本
3.1.0

本地静态聊天 UI 演示(chat-demo)

一款纯前端、零后端的聊天界面演示页面,仿主流 IM 三栏布局。所有会话与消息均为本地静态数据,无需 uniCloud、无需登录、无需申请地图或推送 key,打开即可查看与交互,适合用于 UI 演示、课程设计或二次开发起步。

功能特性

  • 三栏布局:宽屏下为「左侧导航栏 + 会话列表 + 聊天窗口」;窄屏(≤760px)下自动切换为单栏,点击会话进入聊天。
  • 会话切换:点击会话打开聊天窗口,自动清除该会话的未读角标。
  • 消息发送:输入内容后点击「发送」或回车,消息追加到当前会话并更新列表摘要与时间。
  • 搜索过滤:在消息页搜索框输入关键字,实时按会话名或最后一条消息过滤。
  • 通讯录 / 我的:左侧导航可切换通讯录列表与个人中心静态页。
  • 过渡动画:Tab 切换淡入淡出、窄屏聊天页侧滑进出、消息入场上滑、按钮按压反馈。
  • 纯本地:不发起任何网络请求,数据存于页面 data,刷新后重置。

平台兼容性

平台 支持情况
H5(浏览器) 支持,推荐用于本地预览
App(app-vue) 支持
微信小程序 支持(窄屏交互)

依赖组件:uni-icons(用于图标显示),请确保项目 uni_modules 中存在该组件。

快速开始

1. 引入页面

将 pages/chat-demo 目录整体复制到你的项目 pages 下。

2. 注册页面

在项目的 pages.json 中注册该页面。若希望作为启动页,请放在 pages 数组第一项:

{
  "pages": [
    {
      "path": "pages/chat-demo/chat-demo",
      "style": {
        "navigationBarTitleText": "消息",
        "navigationStyle": "custom"
      }
    }
  ]
}

说明:本页使用自定义导航栏(navigationStyle: custom)以实现全屏铺满,页面内部已自带标题栏。

3. 运行

在 HBuilderX 中运行到浏览器即可查看。宽屏窗口显示三栏;若使用设备模拟器(如 iPhone),将显示单栏,进入设备选择切换为「自适应」可查看三栏效果。

文件结构

pages/chat-demo/
├── chat-demo.vue    # 页面主体,包含模板、静态数据、交互逻辑与全部样式
└── README.md        # 本文档

数据与交互说明

会话数据

会话列表定义在页面 data 的 conversations 数组中,每个会话结构如下:

{
  id: 1,                    // 会话唯一标识
  name: '产品交流群',        // 会话名称
  color: '#5B8FF9',         // 头像背景色
  time: '10:42',            // 列表显示的时间
  unread: 3,                // 未读消息数
  lastMsg: '最后一条消息',   // 列表摘要
  messages: [               // 聊天记录
    { id: 1, from: 'other', text: '消息内容', time: '09:30' },
    { id: 2, from: 'me', text: '我发送的内容', time: '09:32' }
  ]
}

其中 from 取值为 me(自己)或 other(对方),分别对应右侧绿色气泡与左侧白色气泡。

主要方法

方法 说明
switchTab(tab) 切换左侧 Tab,tab 取值为 chat / contact / me
selectConv(id) 按会话 id 打开聊天窗口并清除未读
sendMsg() 发送当前输入框内容
openFromContact(id) 从通讯录进入会话

本地存储说明

本页面不写入本地存储,所有数据仅存在于内存中。如需持久化聊天记录,可在 sendMsg 方法中调用 uni.setStorageSync 保存,并在 onLoad 时读取。

自定义与扩展

  • 修改会话与消息:直接编辑 data 中的 conversations 数组即可。
  • 更换主题色:全局替换样式中的 #5fc08e(主色)与 #f0483e(未读角标红色)。
  • 接入真实数据:将 conversations 改为接口返回数据,并在 sendMsg 中调用后端发送接口,即可改造为真实聊天页。本演示本身不涉及任何后端逻辑。
  • 调整响应式断点:样式中 @media (max-width: 760px) 控制宽屏三栏与窄屏单栏的切换阈值,可按需要修改。

注意事项

  1. 本插件为纯 UI 演示,不具备真实即时通讯能力,不与 uni-im 等 IM 系统关联。
  2. 页面使用 position: fixed 铺满视口,并清除了 uni-app H5 外层容器(如 uni-page-body)的默认边距;如集成到已有项目出现样式冲突,请检查全局样式覆盖顺序。
  3. 消息发送后的自动滚动到底部逻辑在 H5 端通过 document.getElementById 实现,并使用 // #ifdef H5 条件编译包裹,其他端不会执行该段代码。
  4. 文档与代码均使用 UTF-8 编码,避免出现乱码。

更新日志

1.0.0

  • 初始版本:三栏聊天界面、会话切换、消息发送、搜索过滤、通讯录与个人中心、过渡动画、响应式布局。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。