更新记录

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 即可

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议

暂无用户评论。