喜欢请点起来 star～
网页布局分为三部分，分别是
- 头部header，固定定位
- 侧边栏aside，固定定位,margin-top的值是header的高度
- 内容contain，静态定位, margin-top值为header的高度，margin-left的值为aside的宽度，是router-view的出口。分为两部分：
- 主内容，显示md转换后的html页面，margin-right值为md目录的宽度值
- 提取markdown的h1和h2目录，用于标题导航，固定定位
为了md能在网页上良好的展示，应具备以下功能：
- 点击左侧的菜单，可以获取到相应的md内容（字符串格式），将md内容转成html，为一级、二级标题加锚点id
- 为html增加md的格式，引入一个css即可，参考网址
- 提取md中的一级二级标题，在右侧显示文章目录
- 点击右侧文章目录，左侧内容可定位到相应的位置，还要做平滑滚动处理，增强用户体验
- 左侧内容滚动时，右侧目录的激活项随之动态变化
我使用了marked.js将md转成html，并在这里为h1和h2加上了id值，作为锚点
// 先安装marked.js到本地
npm install marked --save
// 在组件内引入marked
import marked from 'marked';
// marked的基本设置
marked.setOptions({
renderer: rendererMD,
gfm: true,
tables: true,
breaks: false,
pedantic: false,
sanitize: false,
smartLists: true,
smartypants: false
});
// 实例化
let rendererMD = new marked.Renderer();
// 在计算属性中，处理md的h1、h2，加上id值，并使用marked转成html
computed: {
compiledMarkdown: function() {
let index = 0;
rendererMD.heading = function(text, level) {
if (level < 3) {
return `<h${level} id="${index++}" class="jump" >${text}</h${level}>`;
} else {
return `<h${level}>${text}</h${level}>`;
}
};
return marked(this.content);
}
}
在html中，用v-html绑定此计算属性即可
<div class="markdown-body" ref="content" id="content" v-html="compiledMarkdown">
getTitle(content) {
let nav = [];
let navLevel = [1, 2];
let tempArr = [];
content
.replace(/```/g, function(match) {
return '\f';
})
.replace(/\f[^\f]*?\f/g, function(match) {
return '';
})
.replace(/\r|\n+/g, function(match) {
return '\n';
})
// 以至少一个#开始，紧接非换行符外任意个字符进行惰性匹配，然后是一个换行符
.replace(/(#+)[^#][^\n]*?(?:\n)/g, function(match, m1) {
let title = match.replace('\n', '');
let level = m1.length;
tempArr.push({
title: title.replace(/^#+/, '').replace(/\([^)]*?\)/, ''),
level: level,
children: []
});
});
// tempArr得到的是全部1-6级标题，将一级和二级过滤出来
nav = tempArr.filter(_ => _.level <= 2);
let index = 0;
// 在此处加index值，这里和标签里绑定的id是对应的
nav = nav.map(_ => {
_.index = index++;
return _;
});
let retNavs = [];
let toAppendNavList;
navLevel.forEach(level => {
// 遍历一级和二级标题，将同一级的元素组成一个新数组
toAppendNavList = this.find(nav, {
level: level
});
if (retNavs.length === 0) {
// 处理一级标题
retNavs = retNavs.concat(toAppendNavList);
} else {
// 处理二级标题，把二级标题加到相应的父节点的children中
toAppendNavList.forEach(_ => {
_ = Object.assign(_);
let parentNavIndex = this.getParentIndex(nav, _.index);
return this.appendToParentNav(retNavs, parentNavIndex, _);
});
}
});
// 此处的retNavs就是处理后的树
return retNavs;
},
// 处理属于同一级的标题，组成数组
find(arr, condition) {
return arr.filter(_ => {
for (let key in condition) {
if (condition.hasOwnProperty(key) && condition[key] !== _[key]) {
return false;
}
}
return true;
});
},
// 获取此节点的父节点
getParentIndex(nav, endIndex) {
// 从当前的index开始找 1.距离自己最近的（递减体现） 2.level比本身小的（越小越高）
for (var i = endIndex - 1; i >= 0; i--) {
if (nav[endIndex].level > nav[i].level) {
return nav[i].index;
}
}
},
// 找到同一个父节点的所有子节点
appendToParentNav(nav, parentIndex, newNav) {
// 找到每一个二级标题的傅标题的index值
let index = this.findIndex(nav, {
index: parentIndex
});
if (index === -1) {
// 这里处理的是三级及以下标题
// 如果在一级标题里没找到父节点，就去每一个一级标题里的children里找
let subNav;
for (var i = 0; i < nav.length; i++) {
// 处理没有父节点的情况
subNav = nav[i];
subNav.children.length && this.appendToParentNav(subNav.children, parentIndex, newNav);
}
} else {
nav[index].children = nav[index].children.concat(newNav);
}
},
// 找符合条件的数组中的成员
findIndex(arr, condition) {
let ret = -1;
arr.forEach((item, index) => {
for (var key in condition) {
if (condition.hasOwnProperty(key) && condition[key] !== item[key]) { // 不进行深比较
return false;
}
}
ret = index;
});
return ret;
},
<div id="menu">
<ul class="nav-list">
<li v-for="(nav, index) in contentMenu" :key="index">
<a :href="'#' + nav.index" :class="{'active': highlightIndex === nav.index}" @click="handleHighlight(nav.index)" :key="nav.index">{{nav.title}}
</a>
<template v-if="nav.children.length > 0">
<ul class="nav-list">
<li v-for="(item, index) in nav.children" :key="index">
<a :href="'#' + item.index" :class="{active: highlightIndex === item.index}" :key="item.index" @click="handleHighlight(item.index)">{{item.title}}
</a>
</li>
</ul>
</template>
</li>
</ul>
</div>
在md的目录中，a标签里已经设置了href值，进行了锚点定位，在点击目录绑定的事件里做了平滑处理
handleHighlight(item) {
this.highlightIndex = item;
let jump = document.querySelectorAll('.jump');
// 这里的60是header的高度值
let total = jump[item].offsetTop - 60;
let distance = document.documentElement.scrollTop || window.pageYOffset || document.body.scrollTop;
// 平滑滚动，时长500ms，每10ms一跳，共50跳
let step = total / 50;
if (total > distance) {
smoothDown();
} else {
let newTotal = distance - total;
step = newTotal / 50;
smoothUp();
}
function smoothDown() {
if (distance < total) {
distance += step;
document.body.scrollTop = distance;
document.documentElement.scrollTop = distance;
setTimeout(smoothDown, 10);
} else {
document.body.scrollTop = total;
document.documentElement.scrollTop = total;
}
}
function smoothUp() {
if (distance > total) {
distance -= step;
document.body.scrollTop = distance;
document.documentElement.scrollTop = distance;
setTimeout(smoothUp, 10);
} else {
document.body.scrollTop = total;
document.documentElement.scrollTop = total;
}
}
}
在阅读md内容时，随着滚动条的变化，目录的高亮项也随着变化
mounted() {
this.$nextTick(function() {
window.addEventListener('scroll', this.onScroll);
});
},
methods: {
onScroll() {
let top = document.documentElement ? document.documentElement.scrollTop : document.body.scrollTop;
let items = document.getElementById('content').getElementsByClassName('jump');
let currentId = '';
for (let i = 0; i < items.length; i++) {
let _item = items[i];
let _itemTop = _item.offsetTop;
if (top > _itemTop - 75) {
currentId = _item.id;
} else {
break;
}
}
if (currentId) {
// 这里的currentOId是字符串，必须转换成数字，否则高亮项的全等无法匹配
this.highlightIndex = parseInt(currentId);
}
}
}
以上就是如何让md在网页上良好展示的全部功能，谷歌了多次，感谢分享经验的艾瑞巴dei，开源万岁～！
待改进的点有：
- 如何避免非标题的#的正则匹配，比如
// #这不是标题格式的内容 - md中h1和h2标签的处理，md中是允许html的，现在不能满足匹配h1、h2的标签
npm install
npm start
npm run build
npm run lint