我在鸿蒙【生态市场】发布的活跃预览组件上架了

Activity Overview Component

https://developer.huawei.com/consumer/cn/market/prod-detail/28529adcf9b743128c8a3b7baa89ec7d/ad5e4b6a3925429b8dad78363063436a

简介

activity_overview 是一个类似于 GitHub 贡献图(Contribution Graph)的动态预览组件。它能够以热力图的形式直观展示用户在一段时间内的活动频率或贡献情况。

功能特性

  • 动态数据展示:支持传入日期和贡献数量的数据数组。
  • 完全自定义样式 :
    • 支持自定义色块颜色等级(colors)。
    • 支持自定义贡献数阈值(thresholds)。
    • 支持设置色块尺寸(blockSize)和间距(blockSpace)。
  • 时间范围控制 :支持设置显示过去多少周的数据(weeks)。
  • 交互支持:支持点击色块触发回调函数,返回日期和贡献数。

快速开始

安装组件

bash 复制代码
ohpm install @ohmos/activity_overview

引入组件

typescript 复制代码
import { ActivityCalendar, ContributionItem } from '@ohmos/activity_overview';

基础用法

typescript 复制代码
@Entry
@Component
struct MyComponent {
  @State contributions: ContributionItem[] = [
    { date: '2023-10-01', count: 5 },
    { date: '2023-10-02', count: 12 },
    // ... 更多数据
  ];

  build() {
    Column() {
      ActivityCalendar({
        contributions: this.contributions,
        weeks: 52, // 显示过去52周
        onBlockClick: (date, count) => {
          console.info(`Clicked: ${date}, Count: ${count}`);
        }
      })
    }
  }
}

API 参考

ActivityCalendar 组件属性

属性名 类型 默认值 说明
contributions ContributionItem[] [] 贡献数据列表,包含日期和数量。
weeks number 52 显示的周数,从当前日期向前推算。
blockSize number 10 每个色块的宽度和高度(单位:vp)。
blockSpace number 2 色块之间的间距(单位:vp)。
colors string[] ['#ebedf0', '#9be9a8', '#40c463', '#30a14e', '#216e39'] 颜色数组。第一个颜色为背景色(0贡献),后续颜色对应不同等级。
thresholds number[] [1, 3, 6, 10] 阈值数组。用于决定贡献数对应哪个颜色等级。
onBlockClick (date: string, count: number) => void - 点击色块时的回调函数。

ContributionItem 接口

typescript 复制代码
interface ContributionItem {
  date: string; // 日期格式 'YYYY-MM-DD'
  count: number; // 贡献数量
}

联系方式

如有问题或建议,请联系维护团队。

相关推荐
爱写Bug的浮游2 小时前
初识仓颉:5 分钟看懂核心语法
harmonyos·编程语言
羽落•无痕(苏晗默)4 小时前
华为数通IA——14、网络服务与应用:TCP/UDP 传输层协议与 FTP、Telnet、SSH 实践
网络·网络协议·tcp/ip·网络安全·华为·udp·信息与通信
程序猿追15 小时前
鸿蒙 PC 的 Ionic 工单有两个错误,按下生成后光标该去哪儿
华为·harmonyos
KevinChaos19 小时前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji1 天前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207411 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白1 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方2 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追2 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追2 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos