Obsidian Dataview插件如何实现文件的条件筛选与排序？

Question

在使用Obsidian Dataview插件时，如何根据特定条件筛选文件并进行排序是一个常见的技术问题。例如，当笔记中包含“任务”字段和“优先级”字段时，如何仅显示“任务”为“未完成”的文件，并按“优先级”从高到低排序？若Dataview语法设置不当，可能导致筛选结果为空或排序混乱。具体问题表现为：是否需要在查询语句中明确指定条件的逻辑关系（如and/or），以及如何正确使用sort函数定义排序规则？此外，如果字段值为自定义类型（如日期或枚举值），又该如何确保其被正确解析并排序？这些问题都需要深入理解Dataview的查询语法与数据格式要求。

Answer 1

1. 初识Dataview查询语法

在Obsidian中使用Dataview插件时，首先需要了解其基本的查询语法。Dataview通过JavaScript-like的语法来筛选和排序文件。例如，当笔记中包含“任务”字段和“优先级”字段时，我们需要明确指定条件的逻辑关系。

• task == "未完成"：这是最基本的筛选条件，用于过滤出“任务”字段值为“未完成”的笔记。
• priority > 0：假设“优先级”字段为数值类型，可以进一步筛选优先级大于0的笔记。

为了确保查询结果正确，必须在查询语句中明确指定条件的逻辑关系（如and/or）。例如：

TABLE file.name, task, priority
FROM "#任务列表"
WHERE task == "未完成" AND priority >= 1

2. 深入解析sort函数的用法

在获取符合条件的笔记后，接下来需要对结果进行排序。Dataview提供了SORT关键字，用于定义排序规则。以下是一个示例：

TABLE file.name, task, priority
FROM "#任务列表"
WHERE task == "未完成" AND priority >= 1
SORT priority DESC

上述代码中，SORT priority DESC表示按“优先级”字段从高到低排序。如果需要多级排序，可以这样写：

SORT priority DESC, file.cday ASC

这将先按优先级降序排列，再按创建日期升序排列。

3. 处理自定义类型字段

当字段值为自定义类型（如日期或枚举值）时，Dataview要求这些字段被正确解析并排序。以下是具体步骤：

1. 确保字段格式符合标准。例如，日期字段应采用ISO 8601格式（如2023-10-01），枚举值应为字符串类型。
2. 在查询中显式声明字段类型。例如，对于日期字段，可以使用file.mtime或file.cday。

以下是一个处理日期字段的示例：

TABLE file.name, dueDate, priority
FROM "#任务列表"
WHERE task == "未完成" AND dueDate > "2023-09-01"
SORT dueDate ASC

如果字段值为枚举类型，例如“优先级”为["高", "中", "低"]，可以通过映射函数将其转换为数值后再排序：

TABLE file.name, task, priority
FROM "#任务列表"
WHERE task == "未完成"
LET priorityNum = if(priority == "高", 3, if(priority == "中", 2, 1))
SORT priorityNum DESC

4. 查询流程图

为了更清晰地理解整个查询过程，以下是一个流程图：

graph TD;
    A[开始] --> B[加载笔记数据];
    B --> C{笔记是否包含"任务"和"优先级"字段?};
    C --是--> D[筛选"任务"为"未完成"的笔记];
    D --> E[按"优先级"字段排序];
    C --否--> F[跳过该笔记];
    E --> G[输出结果];

通过以上流程图可以看出，每个步骤都至关重要，任何一个环节出错都会导致最终结果不符合预期。