更新记录
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)控制宽屏三栏与窄屏单栏的切换阈值,可按需要修改。
注意事项
- 本插件为纯 UI 演示,不具备真实即时通讯能力,不与 uni-im 等 IM 系统关联。
- 页面使用
position: fixed铺满视口,并清除了 uni-app H5 外层容器(如uni-page-body)的默认边距;如集成到已有项目出现样式冲突,请检查全局样式覆盖顺序。 - 消息发送后的自动滚动到底部逻辑在 H5 端通过
document.getElementById实现,并使用// #ifdef H5条件编译包裹,其他端不会执行该段代码。 - 文档与代码均使用 UTF-8 编码,避免出现乱码。
更新日志
1.0.0
- 初始版本:三栏聊天界面、会话切换、消息发送、搜索过滤、通讯录与个人中心、过渡动画、响应式布局。

收藏人数:
下载插件并导入HBuilderX
下载插件ZIP
下载 0
赞赏 0
下载 12779591
赞赏 1960
赞赏
京公网安备:11010802035340号