Add text fragments to quarto-search.js items

[vezwork]

Description

Adds text fragments to items in search. Example video:

Kapture.2026-02-06.at.12.51.59.mp4

I have attempted to write this code quite defensively so that it will not break things. Its not quite the ideal place for this code since this piece of code can be called multiple time for a single item, but it gets the job done.

Text fragments are well supported and apparently browsers will fall back to id linking if the text fragment is not supported or found (worked in my testing in chrome and safari and firefox on Desktop MacOS Tahoe, e.g. https://en.wikipedia.org/wiki/Dog#Domestication:~:text=blablabla).

[posit-snyk-bot]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scanner	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues
✅	Licenses	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[cscheid]

The PR looks good. Just to be clear, this exists in part to improve the situation we have wrt visibility of search results in the page, right?

[vezwork]

Just to be clear, this exists in part to improve the situation we have wrt visibility of search results in the page, right?

Yes, this will be helpful for all search results, but will be especially helpful once we have tabsets that have behaviour that they switch tabs to reveal specific content in response to browser ctrl+f or text fragment links. I am looking into using the <details> element to create a tabset that supports this. It should work based on my testing across desktop browsers.

[vezwork]

Should we merge this? Whats the next release it will be in? Will it be in a "daily" sort of build before the main release so that we can use it in a build of the quarto.org docs?

[cderv]

Will it be in a "daily" sort of build before the main release so that we can use it in a build of the quarto.org docs?

Yes I'll build the new prerelease, and we can see effect in quarto.org

[cderv]

1.9.20 has the change

[mcanouil]

@vezwork

Probably worth taking a look at this discussion as it's about text fragments and query parameters in URL.

• https://github.com/orgs/quarto-dev/discussions/13123

Especially, the following part which is involving in removing the search text highlighting

• quarto-cli/src/resources/projects/website/search/quarto-search.js

  Lines 56 to 64 in 1b9b5e4

  	// function to clear highlighting on the page when the search query changes
  	// (e.g. if the user edits the query or clears it)
  	let highlighting = true;
  	const resetHighlighting = (searchTerm) => {
  	if (mainEl && highlighting && query && searchTerm !== query) {
  	clearHighlight(query, mainEl);
  	highlighting = false;
  	}
  	};