-
-
Notifications
You must be signed in to change notification settings - Fork 5.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Shorten markdown heading anchors links
This changes the links on headings like '# Usage' in markdown from `https://host/user/repo#user-content-usage` to just `https://host/user/repo#usage` matching GitHub and GitLab. The linked id elements still have the prefix and this behaviour matches GitHub and GitLab too, so JS is needed to scroll to the active anchor. I suspect it's like that to avoid namespace collission between user-generated content and other page content. Compatibilty for old links is included so they will continue to work. Also included are some enhancements to make the clickable area for the link icon larger and fix its color on arc-green. Fixes: #11896 Fixes: #12062
- Loading branch information
1 parent
4b66d9a
commit aed4c21
Showing
3 changed files
with
67 additions
and
73 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,32 @@ | ||
import {svg} from '../utils.js'; | ||
|
||
const headingSelector = '.markdown h1, .markdown h2, .markdown h3, .markdown h4, .markdown h5, .markdown h6'; | ||
|
||
function scrollToAnchor() { | ||
if (document.querySelector(':target')) return; | ||
if (!window.location.hash || window.location.hash.length <= 1) return; | ||
const id = window.location.hash.substring(1); | ||
const el = document.getElementById(`user-content-${id}`); | ||
if (el) { | ||
el.scrollIntoView(); | ||
} else if (id.startsWith('user-content-')) { // compat for links with old 'user-content-' prefixed hashes | ||
const el = document.getElementById(id); | ||
if (el) el.scrollIntoView(); | ||
} | ||
} | ||
|
||
export default function initMarkdownAnchors() { | ||
if (!document.querySelector('.markdown')) return; | ||
|
||
for (const heading of document.querySelectorAll(headingSelector)) { | ||
const originalId = heading.id.replace(/^user-content-/, ''); | ||
const a = document.createElement('a'); | ||
a.classList.add('anchor'); | ||
a.setAttribute('href', `#${encodeURIComponent(originalId)}`); | ||
a.innerHTML = svg('octicon-link', 16); | ||
heading.prepend(a); | ||
} | ||
|
||
scrollToAnchor(); | ||
window.addEventListener('hashchange', scrollToAnchor); | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters