笔者平时写文章使用的都是Markdown
,但是发布的时候就会遇到一些平台不支持Markdown
的情况,重排是不可能重排的,所以都会使用一些Markdown
转富文本的工具,比如markdown-nice,用的多了就会好奇是怎么实现的,于是就有了本篇文章。
markdown-nice
是一个基于React
构建的项目,先来看一下它的整体页面:
一个顶部工具栏,中间三个并列的区域,分别是编辑区域、预览区域、自定义主题区域,自定义主题区域默认是隐藏的。
大体上就是一个Markdown
编辑器,增加了一些对各个平台的适配而已。
编辑器
编辑器使用的是CodeMirror,具体来说是一个二次封装的组件React-CodeMirror:
代码语言:javascript复制import CodeMirror from "@uiw/react-codemirror";
class App extends Component {
render() {
return (
<CodeMirror
value={this.props.content.content}
options={{
theme: "md-mirror",// 主题
keyMap: "sublime",// 快捷键
mode: "markdown",// 模式,也就是语言类型
lineWrapping: true,// 开启超长换行
lineNumbers: false,// 不显示行号
extraKeys: {// 配置快捷键
...bindHotkeys(this.props.content, this.props.dialog),
Tab: betterTab,
RightClick: rightClick,
},
}}
onChange={this.handleThrottleChange}
onScroll={this.handleScroll}
onFocus={this.handleFocus}
onBlur={this.handleBlur}
onDrop={this.handleDrop}
onPaste={this.handlePaste}
ref={this.getInstance}
/>
)
}
}
复制代码
快捷键、命令
markdown-nice
通过extraKeys
选项设置一些快捷键,此外还在工具栏中增加了一些快捷按钮:
这些快捷键或者命令按钮操作文本内容的逻辑基本是一致的,先获取当前选区的内容:
代码语言:javascript复制const selected = editor.getSelection()
复制代码
然后进行加工修改:
代码语言:javascript复制`**${selected}**`
复制代码
最后替换选区的内容:
代码语言:javascript复制editor.replaceSelection(`**${selected}**`)
复制代码
此外也可以修改光标的位置来提升体验,比如加粗操作后光标位置会在文字后面,而不是*
后面就是因为markdown-nice
在替换完选区内容后还修改了光标的位置:
export const bold = (editor, selection) => {
editor.replaceSelection(`**${selection}**`);
const cursor = editor.getCursor();
cursor.ch -= 2;// 光标位置向前两个字符
editor.setCursor(cursor);
};
复制代码
表格
Markdown
的表格语法手写起来是比较麻烦的,markdown-nice
对于表格只提供了帮你插入表格语法符号的功能,你可以输入要插入的表格行列数:
确认以后会自动插入符号:
实现其实就是一个字符串的拼接逻辑:
代码语言:javascript复制const text = this.buildFormFormat(this.state.rowNum, this.state.columnNum);
buildFormFormat = (rowNum, columnNum) => {
let formFormat = "";
// 最少会创建三行
for (let i = 0; i < 3; i ) {
formFormat = this.buildRow(i, columnNum);
}
// 超过三行
for (let i = 3; i <= rowNum; i ) {
formFormat = this.buildRow(i, columnNum);
}
return formFormat;
};
buildRow = (rowNum, columnNum) => {
let appendText = "|";
// 第一行为表头和内容的分隔
if (rowNum === 1) {
appendText = " --- |";
for (let i = 0; i < columnNum - 1; i ) {
appendText = " --- |";
}
} else {
appendText = " |";
for (let i = 0; i < columnNum - 1; i ) {
appendText = " |";
}
}
return appendText (/windows|win32/i.test(navigator.userAgent) ? "rn" : "n");
};
复制代码
表格字符生成以后替换当前选区内容即可:
代码语言:javascript复制handleOk = () => {
const {markdownEditor} = this.props.content;
const cursor = markdownEditor.getCursor();
const text = this.buildFormFormat(this.state.rowNum, this.state.columnNum);
markdownEditor.replaceSelection(text);
cursor.ch = 2;
markdownEditor.setCursor(cursor);
markdownEditor.focus();
};
复制代码
同样修改了光标位置并且让编辑器重新聚焦。