feat: add anchor link for all headings

Author: Justineo

assets/styles/post.styl

@@ -34,7 +34,20 @@ margin-y($top, $bottom = $top)
   .one-details
     margin-bottom 5px
 
-[data-markdown]
+  .icon-link
+    position absolute
+    transition-property transform, opacity
+    transition-duration 0.2s
+    transform translate(calc(-1px - 100%), -50%)
+    opacity 0
+    padding 0.1em
+
+[data-target]
+  .icon-link
+    opacity 1
+    transform translate(-100%, -50%)
+
+[data-md]
   h1
   h1&
     margin-y(0, 1.25em)
@@ -49,11 +62,6 @@ margin-y($top, $bottom = $top)
     margin-y(1.3em, 1.2em)
     font-size 30px
 
-    &::before
-      content "#"
-      margin-right 5px
-      color #ccc
-
     & + h3
       margin-top 2em
 
@@ -98,9 +106,17 @@ margin-y($top, $bottom = $top)
   h5&
   h6
   h6&
+    position relative
+    display flex
+    align-items center
     color #333
     line-height 1
 
+    &:hover
+      .icon-link
+        opacity 1
+        transform translate(-100%, -50%)
+
   br
   br&
     clear both
@@ -368,7 +384,7 @@ margin-y($top, $bottom = $top)
   .post
     padding 30px
 
-  [data-markdown]
+  [data-md]
     h1
     h1&
       font-size 24px

nuxt.config.js

@@ -53,6 +53,7 @@ module.exports = {
   ],
 
   plugins: [
+    { src: '~plugins/global.js' },
     { src: '~plugins/hm.js', ssr: false },
     { src: '~plugins/i18n.js' },
     { src: '~plugins/l10n.js' },

one/build/page.js

@@ -6,6 +6,7 @@ import frontmatter from 'remark-frontmatter'
 import shortcodes from 'remark-shortcodes'
 import remarkToRehype from 'remark-rehype'
 import raw from 'rehype-raw'
+import rehypeAutolinkHeadings from '@justfork/rehype-autolink-headings'
 import html from 'rehype-stringify'
 import highlight from 'rehype-highlight'
 import etpl from 'etpl'
@@ -45,6 +46,14 @@ const md = remark()
   .use(toc)
   .use(remarkToRehype, { allowDangerousHTML: true })
   .use(raw)
+  .use(rehypeAutolinkHeadings, {
+    content: {
+      type: 'element',
+      tagName: 'icon-link',
+      properties: { class: 'icon-link' }
+    },
+    test: ['h2', 'h3', 'h4', 'h5', 'h6']
+  })
   .use(rehypePreviewImg)
   .use(rehypeLink)
   .use(rehypeScoped)
@@ -87,16 +96,20 @@ export function renderDocToPage (file) {
       .replace(/\{/g, '{')
       .replace(/\}/g, '}')
       .replace(/v-pre="true"/g, 'v-pre')
-      .replace(/data-markdown="true"/g, 'data-markdown'),
+      .replace(/data-md="true"/g, 'data-md'),
     demos: demoList.map(name => {
       return {
         name,
-        src: join('@/components/demos', relative(DOCS_DIR, demos[name].filePath))
+        src: join(
+          '@/components/demos',
+          relative(DOCS_DIR, demos[name].filePath)
+        )
       }
     }),
     components: componentList,
     alert: hasAlert,
-    boilerplate: demoList.length || componentList.length || hasAlert || style === 'post',
+    boilerplate:
+      demoList.length || componentList.length || hasAlert || style === 'post',
     layout,
     style,
     path: file,

one/build/rehype-link.js

@@ -10,12 +10,16 @@ export default function attacher () {
     let [, locale] = localPath.match(RE_LOCALE) || []
 
     visit(tree, 'element', node => {
-      let { tagName, properties: { href, ...props } } = node
-      if (tagName !== 'a' || href.match(/^\w+:\/\//)) {
+      let {
+        tagName,
+        properties: { href, ...props }
+      } = node
+      if (tagName !== 'a' || href.startsWith('#') || href.match(/^\w+:\/\//)) {
         return
       }
 
-      let routePath = locale && href.indexOf('/') === 0 ? `/${locale}${href}` : href
+      let routePath =
+        locale && href.indexOf('/') === 0 ? `/${locale}${href}` : href
 
       node.tagName = 'nuxt-link'
       node.properties = { ...props, to: routePath }

one/build/rehype-scoped.js

@@ -6,7 +6,7 @@ export default function attacher () {
   return tree => {
     visit(tree, 'element', ({ tagName, properties }, _, { type }) => {
       if (type === 'root' && !RE_DEMO.test(tagName)) {
-        properties['data-markdown'] = true
+        properties['data-md'] = true
       }
     })
   }

one/build/remark-anchor.js

@@ -29,7 +29,10 @@ export default function attacher () {
       const { type, depth, children, value, position } = node
       if (type === 'heading') {
         if (depth === 3) {
-          const text = children[0]
+          let text = children[0]
+          if (text && text.type === 'element' && text.tagName === 'icon-link') {
+            text = children[1]
+          }
           if (text && text.type === 'text' && KNOWN_SCOPES[text.value]) {
             scope = KNOWN_SCOPES[text.value]
             return

one/docs/changelog.vue

@@ -3,7 +3,7 @@
   class="content post"
   :class="{ 'filter-version': compareValid }"
 >
-  <h1 data-markdown>
+  <h1 data-md>
     升级日志
   </h1>
   <veui-form
@@ -78,7 +78,7 @@
     v-for="{ version, codeName, date, changeset } of pagedChangelog"
     :key="version"
     class="version-item"
-    data-markdown
+    data-md
   >
     <h2
       :id="getHash(version)"

one/docs/demo/style/number.vue

@@ -0,0 +1,57 @@
+<template>
+<article>
+  <section>
+    <strong :class="{ tabular }">
+      {{ value }}
+    </strong>
+    <veui-checkbox v-model="tabular">
+      Tabular numbers
+    </veui-checkbox>
+  </section>
+  <veui-slider
+    v-model="value"
+    :step="1"
+    :min="19000101"
+    :max="21001231"
+  />
+</article>
+</template>
+
+<script>
+import { Checkbox, Slider } from 'veui'
+
+export default {
+  components: {
+    'veui-checkbox': Checkbox,
+    'veui-slider': Slider
+  },
+  data () {
+    return {
+      tabular: true,
+      value: 20170320
+    }
+  }
+}
+</script>
+
+<style scoped>
+section {
+  display: flex;
+  align-items: center;
+  gap: 24px;
+}
+
+strong {
+  font-family: "Baidu Number", sans-serif;
+  font-size: 32px;
+}
+
+.tabular {
+  font-variant-numeric: tabular-nums;
+}
+
+.veui-slider {
+  width: 50%;
+  margin-top: 24px;
+}
+</style>