How to modify this dataviewjs search query to also include tags?

[OnesN0s]

Hi everyone!

I’m trying to sort text and tasks based on the assigned tag or tags and have them listed in the order they appear in the file beneath the correct heading. I found this dataviewjs search query below written by user ces3001 in this thread How to group tasks by File and then by Section? ####720. I wonder if someone could explain how this works and how I can modify it to add a search for a specific tag or tags. Basically:

1. What parameters do I need to replace with my own information, and...
2. How I can add a parameter to search for tasks tagged with a specific tag or tags?

	const summary = true
	const includeSection = true
	let taskList = dv.current().file.tasks
				 .where(t => !t.completed && dv.date(t.start) <= dv.date('today'))
	taskList = taskList
		.sort(t => t.line)
		.sort(t => t.path)
	if (summary) { dv.span("*" + taskList.length + " tasks*\n") }
	if (includeSection) {
		const regex = /> ([^\]]+)/;
		let section = null
		let page = null
		let sectionTaskList = []
		for (let t of taskList) {
			if ((sectionTaskList.length > 0) && 
				((page != t.path) || (section != t.section.toString()))) {
				dv.taskList(sectionTaskList,false)
			}
			if (page != t.path) {
				dv.header(2,t.path.replace(/\.md$/, ''))
				page = t.path
			}
			if (section != t.section.toString()) {
				section = t.section.toString()
				dv.header(3,  section.match(regex)[1])
				sectionTaskList = []
			}
			sectionTaskList = sectionTaskList.concat(t)
		}
		dv.taskList(sectionTaskList,false)
	} else {
		dv.taskList(taskList,true)  // true = divide by file
	}

To summarise: I want to do the following using dataview:

1. Sort tasks and blocks of text based on the assigned tags.
2. Have them sorted in the correct order (results are showing up in the wrong order with the current search query).
3. And finally listed under the correct heading.

So for example, if I have a document with 1000 tasks, and 15 of them are tagged with #example-tag-1, located beneath three different headings, I want to show ONLY those 15 tasks in their correct order under the correct heading. I also want to be able to search for multiple tags at once and show only those tasks that are tagged with these tags. I explain what I'm trying to do more in detail here.

This regular search query below almost does the job, except it lists the headings in the wrong order (alphabetically instead of how they appear in the document). See this screenshot from Obsidian!

TASK
FROM "name of file"
WHERE contains(tags, "#example-tag")
GROUP BY meta(section).subpath

Does anyone know how to modify this JavaScript search query above to fit my needs?

Help would be much appreciated! // Cheers

[nkgm]

The grouped headings sort issue seems to originate from DataArray.groupBy. The workaround here is to provide a comparator that preserves the original order.

const data = dv.current().file.tasks.filter(t => t.tags.contains('#example-tag')).groupBy(t => t.section.subpath, (a, b) => a === b ? 0 : 1)
dv.taskList(data)

[nkgm]

I wasn't entirely clear on your 3 points, so I based my answer on:

This regular search query below almost does the job, except it lists the headings in the wrong order (alphabetically instead of how they appear in the document). See this screenshot from Obsidian!

Once placed in a dataviewjs block on its own, it should produce the same result as your regular task query while preserving the original headings order. If I missed something, or any other question, please let me know!

[OnesN0s]

Thank you so much! I think I got it working, but I can only input one tag. How do I add a second tag to search for or more? I tried separating the tags with commas but this didn't work:

dataviewjs
const data = dv.current().file.tasks.filter(t => t.tags.contains('#example-tag, #secondary-tag')).groupBy(t => t.section.subpath, (a, b) => a === b ? 0 : 1)
dv.taskList(data)

[OnesN0s]

Also, how do I point the search query to a different file than the current one?

[nkgm]

To choose an arbitrary file from your vault, replace dv.current() with dv.page('path/to/file').

To filter tasks containing every one of the specified tags, replace tasks.filter(...) with:

tasks.filter(t => ['#example-tag', '#secondary-tag', '#etc-tag'].every(tag => t.tags.includes(tag)))

Bonus tip: to filter tasks containing some of the specified tags, use same code replacing every with some.

[OnesN0s]

IT WORKED!!!! Thank you SO MUCH!!! I really appreciate it! I can't thank you enough, you've just helped me build a workflow I've been wanting for years! Cue: Hans Zimmer - A Dark Knight and read the following:

@nkgm is a silent guardian. A watchful protector. A Dataview JavaScript genius.

The end.