个人开发的小破站,居然把掘金的文本编辑组件给搬上来了

简介: 个人开发的小破站,居然把掘金的文本编辑组件给搬上来了

这是我用小夹子的文本编辑器编写的一篇内容。


在这里主要说明的就是,小夹子上线了一个文章内容编写的功能。该功能上线后用户就可以不用复制站外链接就能生成小夹子网唯一的资源文章链接哦!


对于平时喜欢做笔记、写日志、写计划的,都可以用小夹子网的文章编写功能,方便又实用。


文章编写功能的具体实现呢,主要依赖于前端,毕竟是在网页上写东西,而编写的体验就是关键了,后端倒是只存储一个文章内容字段就 ok 完事了(当然,后端也不简单)。


在参照了市面上的很多 Markdown 语法的编辑器,最终选择了 ByteMD 。


ByteMD 编辑器是字节跳动的掘金团队所开源的一个编辑器组件,当时我在掘金社区发布文章的时候就被这个编辑器给惊艳到了。说真的,外观是真的好看给我的感觉,所以我就把它给集成到小夹子 Vue 项目中来了。


效果如下👇👇👇


image.png

image.png


使用 Vue 开发前端项目给我最大的感受就是,即插即用,非常方便。ByteMD 提供的文档上有针对 Vue 项目所使用的基本教程,如果是简单的使用的话,我觉得够用。但,对于我这个项目小夹子来说,就不一定了。


首先我来说说集成步骤吧!


第一步:


Vue 所有的依赖功能,都要先 inatall 一下才可以有对应的环境,所有先执行如下命令:

# 因为我是 Vue2 版本,所以使用这个命令
npm install @bytemd/vue
# Vue3 版本用下面这个
npm install @bytemd/vue-next


第二步:

在对应的文章页面,导入 ByteMD 样式文件

import 'bytemd/dist/index.css'


第三步:

使用 ByteMD 提供的内容编辑空间

<template>
  <Editor :value="value" :plugins="plugins" @change="handleChange" />
</template>
<script>
import { Editor } from '@bytemd/vue'
import gfm from '@bytemd/plugin-gfm'
const plugins = [
  gfm(),
  // Add more plugins here
]
export default {
  components: { Editor },
  data() {
    return { value: '', plugins }
  },
  methods: {
    handleChange(v) {
      this.value = v
    },
  },
}
</script>


说明:


Editor 内容编辑控件,效果就是上图显示的那样了,不过初始化的时候控件是英文,且样式有稍微不同,后面带大家进行调整修改样式。


plugins 内容控件所支持的特殊功能插件列表,如:支持代码高亮、图片优化等。

value 内容控件中输入的值,回绑定到该属性对应的变量中。


集成之后会发现,效果有点点差强人意,来看一下直接运行的效果:


image.png


直观的来讲,有两个点:

  • 页面是英文版,没有汉化
  • 编辑区的高度不行,没有充满整个页面


image.png


虽然用户能在小夹子上写内容的概率几乎为零,但这直接运行出来的样式我也是看不下去,要改!


第一个汉化倒是非常简单,官方给的文档中也有相关的提示,步骤如下:


1、引入中文包

// 引入中文包
import zhHans from 'bytemd/locales/zh_Hans.json'


2、声明中文包变量

data() {
    return {
   // 声明中文包变量
      zhHans
    }
}


3、在组件中使用

<Editor :locale="zhHans" :value="addContent.content" :plugins="plugins"/>


这样就汉化好了,非常简单!


image.png


接着就是编辑区的样式问题了。


在官方给出的文档中有提到说能覆盖组件中的样式,而我也照着做了,好像并没有什么软用。我的使用步骤如下,如果是因为我的使用方法不对,我认错,毕竟我是个后端开发😆。

<template>
  <Editor :locale="zhHans" :value="addContent.content" :plugins="plugins"/>
</template>
<script>
// 这是我导入的官方样式
import 'bytemd/dist/index.css'
import { Editor } from '@bytemd/vue'
import gfm from '@bytemd/plugin-gfm'
import zhHans from 'bytemd/locales/zh_Hans.json'
const plugins = [
  gfm(),
  // Add more plugins here
]
export default {
  components: { Editor },
  data() {
    return { value: '', plugins, zhHans }
  },
  methods: {
    handleChange(v) {
      this.value = v
    }
  }
}
</script>
<style scoped>
# 这是我所要覆盖的样式
.bytemd {
  height: calc(100vh - 200px);
}
</style>


以上方法,直接在当前页面的 style 标签中编写对应的样式是没有任何效果的,这种现象只能说明一个问题就是,样式没有被覆盖。


what?按着官方文档来的,还有的错。


这是我当时第一反应,但没办法,功能还是要实现,所以就去百度上各种搜索。整体搜索了几个小时,很失望,一个有用的都没有,都基本是和官方给的文档一样,没有说明参考价值,那我现在还能怎么办?


难道真的到了自己手写 CSS 样式的底部了,不然上面这编辑效果也太难看了。


突然,我好像想到了什么~


image.png


我知道,这个文本编辑组件掘金社区也是有再用的,因为我经常在掘金发文章每次都能被它优美的界面给吸引,哈哈!那我能不能 F12 对照掘金文本编辑区样式来魔改一番我自己引入的 ByteMD 组件样式呢!我想是可以的。


说干就干,首先我吧引入的 ByteMD 全局样式给 copy 了一份,放在了自己的工程目录下,具体如图:


image.png


这样,我就能通过改变本地 index.css 样式文件,直接影响到我引入的编辑组件了,而且事实也是如此,我修改了 index.css 样式文件,能正常的在页面显示效果,还不报错,嘻嘻!


image.png


还有,我本人对 CSS 这种样式的编写能力是有限的(菜是原罪),但我会 CV 呀!所以我是去到掘金社区里,在我的文本编辑区和掘金社区的文本编辑区内输入一篇相同的文章,两者对比,如果发现两者样式不一致,我就会吧掘金的样式 CV 到我本地的 index.css 文件中,就这样经过对我的文本编辑组件样式的一顿修改最终达到的效果还算理想。


最后,编辑的问题算是解决了,那保存的内容是如何给到用户看呢!


那这就是 Viewer 标签要做的事情了,只需要把 Editor 对应的 plugins 和 value 原封不动的也给 Viewer 附上值就大功告成了,效果和编辑时预览看到的没有任何差异。


最后来看看小夹子和掘金对比的效果图(用图来证明😁):


微信图片_20220427094539.png微信图片_20220427094557.png


以上,前端所要做的工作就算是完成了,后端在这里我就不展开了,没什么工作量。但如果大家对小夹子这个网站的后端代码感兴趣也是可以联系我,一起讨论讨论的。


说了这么多,还是要各位人才自己使用了才知道效果如何,所以各位人才还不抓紧使用起来😏😏😏。


今天的内容到这里就结束了,关注我,我们下期见

目录
相关文章
|
7月前
|
开发者
阿里云开发者社区Markdown语法
【2月更文挑战第1篇】
703 0
阿里云开发者社区Markdown语法
|
前端开发 JavaScript API
wordpress插件开发踩坑记
想要使用 REST API 需要自己额外安装插件:WordPress REST API,现在 WordPress 5.0以上的版本已经默认支持 REST API了,不需要额外去安装插件
145 0
|
CDN
网站美化代码系列(持续更新)
网站美化终极奥秘:创作第一,体验第二,避免繁杂,简洁为上!
395 0
网站美化代码系列(持续更新)
|
小程序 UED 开发者
小程序开发必备功能的吐血整理【个人中心界面样式大全】
小程序开发必备功能的吐血整理【个人中心界面样式大全】
748 1
小程序开发必备功能的吐血整理【个人中心界面样式大全】
|
前端开发
前端知识学习案例17-开发企业网站17-底部信息2
前端知识学习案例17-开发企业网站17-底部信息2
57 0
前端知识学习案例17-开发企业网站17-底部信息2
|
前端开发
前端知识学习案例16-开发企业网站16-底部信息1
前端知识学习案例16-开发企业网站16-底部信息1
69 0
前端知识学习案例16-开发企业网站16-底部信息1
|
前端开发
前端知识学习案例5-开发企业网站5-编写导航css样式
前端知识学习案例5-开发企业网站5-编写导航css样式
85 0
前端知识学习案例5-开发企业网站5-编写导航css样式
测试语雀编辑器
测试语雀编辑器
163 0
|
JSON 前端开发 JavaScript
它来了!掘金编辑器主题开发贡献图文教程
它来了!掘金编辑器主题开发贡献图文教程
525 0
它来了!掘金编辑器主题开发贡献图文教程
|
存储 数据库
Axure实战24:创建一个掘金Lottery幸运抽奖工具
Axure实战24:创建一个掘金Lottery幸运抽奖工具
292 0
Axure实战24:创建一个掘金Lottery幸运抽奖工具