Skip to content

Commit eeff099

Browse files
committed
docs: Document new Task id filters
1 parent c27c49f commit eeff099

File tree

2 files changed

+23
-0
lines changed

2 files changed

+23
-0
lines changed

docs/Getting Started/Task Dependencies.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,8 @@ Query
7878

7979
## Searching For Dependencies
8080

81+
See [[Filters#Filters for Task Dependencies]].
82+
8183
`is not blocked`
8284

8385
`is blocking`

docs/Queries/Filters.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ This page is long. Here are some links to the main sections:
1717
- [[#Text filters]]
1818
- [[#Matching multiple filters]]
1919
- [[#Filters for Task Statuses]]
20+
- [[#Filters for Task Dependencies]]
2021
- [[#Filters for Dates in Tasks]]
2122
- [[#Filters for Other Task Properties]]
2223
- [[#Filters for File Properties]]
@@ -450,6 +451,26 @@ Find any tasks that have status symbols you have not yet added to your Tasks set
450451
group by path
451452
```
452453

454+
## Filters for Task Dependencies
455+
456+
### Id
457+
458+
- `has id`
459+
- `no id`
460+
- `id (includes|does not include) <string>`
461+
- Matches case-insensitive (disregards capitalization).
462+
- `id (regex matches|regex does not match) /<JavaScript-style Regex>/`
463+
- Does regular expression match (case-sensitive by default).
464+
- Essential reading: [[Regular Expressions|Regular Expression Searches]].
465+
466+
For more information, see [[Task Dependencies]].
467+
468+
> [!released]
469+
>
470+
> - Task Id was introduced in Tasks X.Y.Z.
471+
472+
Since Tasks X.Y.Z, **[[Custom Filters|custom filtering]] by Id** is now possible, using `task.id`.
473+
453474
## Filters for Dates in Tasks
454475

455476
### Due Date

0 commit comments

Comments
 (0)