更新记录
0.0.1(2026-11-19) 下载此版本
版本初发布
平台兼容性
uni-app(3.99)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| - | √ | - | - | - | - | - | - | - |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | - | - | - | - | - | - | - | - | - | - | - |
l-sleep-wave 睡眠波形图组件
基于 Canvas 绘制的睡眠分段波形图,支持点击查看时段详情、缩放与平移。兼容 H5 与小程序(小程序使用 2d canvas)。
引入方式
组件目录位于 src/pageA/components/l-sleep-wave/,按项目 easycom 约定可直接使用:
<l-sleep-wave :sleepData="sleepSegments" />
Props
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sleepData | SleepSegment[] |
是 | 睡眠分段数据,组件内部会拷贝一份,不会修改传入的数组 |
SleepSegment 结构:
type SleepSegment = {
startTime: string // 开始时间,格式 "yyyy-MM-dd HH:mm:ss"
endTime: string // 结束时间,格式同上
status: 'LEAVE' | 'AWAKE' | 'LIGHT' | 'DEEP' // 离床 / 清醒 / 浅睡 / 深睡
}
数据要求:
- 分段按时间先后排序,前一段的
endTime与后一段的startTime首尾相接 - 数据变化时组件会自动重置缩放窗口并重绘,可直接传接口异步获取的数组
交互说明
- 点击色块:选中对应睡眠段,显示顶部时段气泡(起止时间 + 状态)与竖向指示线
- 拖动左右滑块:缩放可视窗口(最小 10%)
- 拖动窗口或图表区:左右平移可视窗口(全程可见时无需平移)
- 拖动结束不会误触发选中
对外方法
通过 ref 调用:
| 方法 | 参数 | 说明 |
|---|---|---|
| handleCanvasTouch | (x: number) |
按 canvas 内 x 坐标选中睡眠段 |
const waveRef = ref()
waveRef.value.handleCanvasTouch(120)
使用示例
<template>
<l-sleep-wave :sleepData="sleepSegments" />
</template>
<script setup lang="ts">
import { ref } from 'vue'
const sleepSegments = ref([
{
startTime: '2024-09-18 23:35:42',
endTime: '2024-09-18 23:41:43',
status: 'LIGHT',
},
{
startTime: '2024-09-18 23:41:43',
endTime: '2024-09-18 23:44:43',
status: 'AWAKE',
},
])
</script>
注意事项
- 时间字符串解析已做 iOS 兼容(内部将空格替换为
T),无需自行处理 - 数据为空时画布自动清空,不报错
- 状态颜色与文案顺序:
离床(灰) / 清醒(黄) / 浅睡(绿) / 深睡(蓝),如需调整改组件内colors/status/STATUS_INDEX即可

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