# Obsidian-Dataviewjs

**Repository Path**: devqiaoyu/obsidian-dataviewjs

## Basic Information

- **Project Name**: Obsidian-Dataviewjs
- **Description**: 在 Obsidian 中用来展示数据的一些 dataviewjs 脚本。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Obsidian DataviewJS 视图库

这是一个为 Obsidian 设计的 DataviewJS 视图库集合，包含了多个实用的视图组件，帮助用户更好地组织和可视化笔记数据。

## 组件介绍

### 1. Habits (习惯追踪)

用于追踪日常习惯的视图组件。

- **主要功能**：显示指定日期范围内的习惯完成情况
- **配置选项**：
  - `dir`: 指定笔记目录
  - `subpath`: 标题
  - `mode`: 显示模式（today|week|month|year|all）
  - `show`: 显示方式（content|yesorno）
  - `dateHeader`: 日期字段名称
  - `yesorno`: 三种标记符号（默认：['✅', '❌', '❔']）

### 2. Heatmap (热力图)

以热力图形式展示笔记或任务的分布情况。

- **主要功能**：可视化展示笔记创建、更新或任务完成的频率
- **支持类型**：
  - `cday`: 笔记创建日期
  - `mday`: 笔记更新日期
  - `created`: 笔记 frontmatter 中的 created 字段
  - `updated`: 笔记 frontmatter 中的 updated 字段
  - `name`: 笔记名称
  - `task`: 任务完成日期

### 3. Month-View (月视图)

月历视图，用于显示指定月份的笔记和任务情况。

- **主要功能**：以月历形式展示每日笔记状态和任务完成情况
- **特性**：
  - 显示农历日期和节日
  - 标记有任务的日期
  - 支持自定义任务标记颜色

### 4. Year-View (年视图)

年历视图，提供全年概览。

- **主要功能**：以年为单位展示所有月份的笔记和任务情况
- **特性**：
  - 显示全年12个月份
  - 标记有任务的日期
  - 响应式设计，适配不同屏幕尺寸

### 5. dida365TaskTable (滴答清单任务表)

用于展示滴答清单任务的表格视图。

- **主要功能**：以表格形式展示任务信息
- **特性**：
  - 支持自定义筛选条件
  - 显示任务优先级、时间范围、状态等信息
  - 可自定义优先级和状态的显示图标

### 6. notionView (Notion风格视图)

模仿 Notion 的多种视图展示方式。

- **支持视图**：
  - Table (表格视图)
  - Board (看板视图)
  - Gallery (画廊视图)
- **特性**：
  - 可自定义分组字段
  - 支持排序和筛选
  - 响应式设计

### 7. tasksCalendar (任务日历)

功能强大的任务日历视图。

- **支持视图**：
  - Month (月视图)
  - Week (周视图)
  - List (列表视图)
- **特性**：
  - 显示多种任务状态（待办、已完成、逾期等）
  - 支持优先级标记
  - 多种样式可选
  - 统计功能

### 8. tasksTimeline (任务时间线)

以时间线形式展示任务和笔记。

- **主要功能**：按时间顺序展示任务和重要笔记
- **特性**：
  - 显示任务的不同状态（待办、逾期、进行中等）
  - 支持优先级和重复任务标记
  - 今日概览和统计信息
  - 可聚焦查看特定类型的任务

## 使用方法

1. 将对应的视图文件夹复制到您的 Obsidian vault 中
2. 在需要使用视图的笔记中使用 DataviewJS 代码块：

\`\`\`dataviewjs
dv.view('view-folder-name', { /* 配置选项 */ })
\`\`\`

3. 根据具体视图的文档配置相应的参数

## 注意事项

- 需要安装并启用 Obsidian 的 Dataview 插件
- 部分视图可能需要特定的笔记结构或 frontmatter 字段
- 某些视图支持自定义 CSS 样式，可根据需要进行调整

## 贡献

如果您有任何改进建议或发现了 bug，请提交 issue 或 pull request。