Markodwn 标题对齐的同步滚动实现思路详解

时间:2021-05-08

前言

需要给正在写的Markodwn编辑器加上同步滚动的功能,百度了一通,没找到比较好的思路。就自己写了一个。

Github上是写好的库,和更直观的Demo。

Github

这篇文章主要讲的是实现的思路。

介绍

同步滚动的实现方式有很多种。简单粗暴的就直接让 HTMLElement.scrollTop 相等,还有就是让滚动条等比例滚动,还有标题对齐的滚动(这个是我在 stackedit 上看到的)。

这篇文章主要的内容是标题对齐同步滚动的实现方式。

个人来讲比较喜欢标题对齐,因为这种方式相对于另外两个对用户更友好。

从原理上来讲标题对齐实际上是等比例滚动的改良版。因为他们的核心都是通过计算编辑区和预览区的高度比值决定滚动的距离。

DEMO

下面是DEMO的GIF图

注意左边的 # 同步滚动 同步滚动 。

可以看到随着滚动条的移动,左右两边滚动的距离是不同的。

这个看起来有点像等比例滚动,但是他们是不一样的,区别在等比例滚动根据两边的 全文高度 决定滚动距离,标题对齐方式根据 标题下内容高度 决定滚动距离。

思路

上图是一张示意图:

# heading 表示标题, content 表示标题下面的内容。我把 标题+内容 称为片段(fragment)。

等比例滚动我想应该比较好理解,就是通过计算编辑区和预览区的高度比值,然后根据比值再计算滚动距离。

而标题对齐要更加精确一些,它把编辑区和预览区的高度换成了 标题高度+标题下内容的高度 即 片段 的高度,然后根据当前的片段对应的高度计算滚动距离。

上面的示意图中的 md height 和 html height 就是我们需要的 片段的高度 。

很明显只要我们根据这两个高度的比值就可以计算出相对应滚动的距离。

具体过程

首先需要编辑区和预览区的标题信息,数据结构如下。这里用 editFragmentsInfo 和 preFragmentsInfo 代替

FragmentInfo: { pairId, // 于编辑区/预览区相对应的标题匹配用的id offsetTop, // 距离顶部偏移的距离 height // 标题加上内容的高度}

然后需要能够获取当前页面顶部的标题块的方法,这里用 getCurrentFragment() 代替

接下来要在 编辑区(editArea)/预览区(previewArea) 的滚动事件中向 预览区(previewArea)/编辑区(editArea) 发送消息通知它要开始滚动了。

在另一区域接收到之后,进行以下操作。(假设主动滚动的是编辑区,被动滚动的是预览区即 另一区域 )

  • 先要拿到当前在顶部的标题,用上面提到的 getCurrentHeading() 获取。
  • 然后要在预览区中匹配到对应的标题。
  • 根据两边 headingInfo.height 的比值计算出的数值再加上 headingInfo.offsetTop 的值就是预览区的 scrollTop 。
  • 到此为止,一次同步就结束了。这一过程是绑定在元素的滚动事件上的,每次滚动都会触发一次这样的过程。
  • 同步问题

    因为一个元素的滚动会导致另一个元素滚动,这必定会形成死循环。所以在滚动事件中一定要进行判断,避免死循环。

    这是简单的互斥方法,支持两个以上对象的互斥。

    总结

    以上所述是小编给大家介绍的Markodwn 标题对齐的同步滚动实现思路详解,希望对大家有所帮助,如果大家有任何疑问欢迎给我留言,小编会及时回复大家的!

    声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

    相关文章