# Canvas Timeline

**Repository Path**: BANPAI82/canvas-timeline

## Basic Information

- **Project Name**: Canvas Timeline
- **Description**: 画布绘制的时间轴
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-11
- **Last Updated**: 2025-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Canvas 时间轴 (canvas-timeline)

这是一个基于 Canvas 的时间轴组件，适用于需要可视化时间线的应用场景，例如日程安排、任务计划等。该组件支持自定义样式和交互操作，具有良好的可扩展性和适配性。

## 功能特性

- 支持自定义时间轴样式（颜色、尺寸等）
- 支持多种时间单位（小时、天、周等）
- 提供交互事件（点击、滑动等）
- 适配多种屏幕尺寸和分辨率

## 技术栈

- 使用 ETS（Enhanced TypeScript）开发
- 基于 OpenHarmony 的 ArkUI 框架
- 使用 JSON 配置资源文件（颜色、字体、图片等）

## 目录结构

```
entry/
├── src/
│   ├── main/
│   │   ├── ets/
│   │   │   ├── entryability/       # 应用入口能力
│   │   │   ├── entrybackupability/ # 备份能力
│   │   │   ├── pages/              # 页面组件
│   │   │       ├── Index.ets       # 主页面
│   │   │       ├── TimerShaftApi.ets # 时间轴 API 定义
│   │   │       └── TimerShaftMode.ets # 时间轴模式定义
│   │   ├── resources/              # 资源文件
│   │       ├── base/               # 基础资源
│   │       └── dark/               # 暗色主题资源
│   ├── test/                       # 单元测试
│   └── ohosTest/                  # OpenHarmony 测试
├── build-profile.json5             # 构建配置
├── hvigorfile.ts                   # 构建脚本
└── oh-package.json5                # 包管理配置
```

## 安装与运行

### 环境准备

- 安装 [OpenHarmony 开发环境](https://developer.harmonyos.com/)
- 安装 [DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio)

### 构建项目

```bash
# 使用 hvigor 构建
cd entry
hvigor build
```

### 运行项目

1. 打开 DevEco Studio
2. 导入项目
3. 点击运行按钮或使用快捷键 `Shift + F10`

## 使用说明

在 `Index.ets` 中，你可以看到时间轴组件的基本使用方式。你可以通过修改 `TimerShaftMode.ets` 和 `TimerShaftApi.ets` 来自定义时间轴的行为和样式。

## 贡献指南

欢迎贡献代码和改进文档。请遵循以下步骤：

1. Fork 项目
2. 创建新分支
3. 提交 Pull Request

## 许可证

本项目采用 [MIT License](https://opensource.org/licenses/MIT)。详情请查看项目根目录下的 LICENSE 文件。