README.md 2.1 KB
Newer Older
Miykael_xxm's avatar
Miykael_xxm 已提交
1 2
# C Markdown 编辑器

璃白.'s avatar
璃白. 已提交
3
一款Markdown编辑器组件,支持使用markodwn语法来编写文档,同时支持图片上传等功能(当前版本仅支持单文件上传)
璃白.'s avatar
璃白. 已提交
4

Miykael_xxm's avatar
Miykael_xxm 已提交
5 6 7 8 9 10 11 12 13 14
## 更新记录

### v0.1 

2021-06-07 v0.1 初版更新,支持功能:

- 自定义主题
- 单张图片/单个附件上传
- Markdown & Html 内容获取

璃白.'s avatar
璃白. 已提交
15 16 17 18 19 20
# 使用

1. 通过script标签引入
```html
<script src="./markdown-editor.js"></script>
```
璃白.'s avatar
璃白. 已提交
21
2. 指定需要渲染的容器
璃白.'s avatar
璃白. 已提交
22 23 24 25 26 27 28 29
```html
<div id="app"></div>
```
3. 初始化实例
```js
new MdEditor({
    ...options
})
璃白.'s avatar
璃白. 已提交
30
```
璃白.'s avatar
璃白. 已提交
31 32 33 34 35 36

# options

| 属性 | 说明 | 类型 | 默认值 |
| ------ | ------ | ------ | ------ |
| el | 编辑器渲染的容器 | String | "#app"
璃白.'s avatar
璃白. 已提交
37
| themeOptions | 主题颜色配置 | Object | [themeOptions](#themeoptions)
璃白.'s avatar
璃白. 已提交
38 39
| canAttachFile | 是否可以上传图片 | Boolean | true
| placeholder | placeholder | String | "请输入内容"
璃白.'s avatar
璃白. 已提交
40
| onChange | 获取编辑器markdown及html内容 | Function | function(res) {} [示例](#onchange)
璃白.'s avatar
璃白. 已提交
41
| onUpload | 上传文件钩子函数 | Function | function(file, callback) {} [示例](#onupload)
璃白.'s avatar
璃白. 已提交
42 43 44 45 46 47 48 49 50

# themeOptions

| 属性 | 说明 | 类型 | 默认值 |
| ------ | ------ | ------ | ------ |
| borderColor | 编辑器边框默认颜色 | String | "#dbdbdb"
| borderColorActive | 编辑器边框激活颜色 | String | "#409eff"
| textColor | 编辑器文字默认颜色 | String | "#303030"
| textColorActive | 编辑器文字激活颜色 | String | "#000"
璃白.'s avatar
璃白. 已提交
51

璃白.'s avatar
璃白. 已提交
52 53 54
# onChange
用于获取markdown内容及编译后的html内容

璃白.'s avatar
璃白. 已提交
55 56 57 58 59 60 61 62 63 64

```js
new MdEditor({
    ...,
    onChange: function(res) {
        console.log(res) // { text: "...", html: "..." }
    }
})
```

璃白.'s avatar
璃白. 已提交
65 66 67
# onUpload

上传或粘贴文件时会触发此函数
璃白.'s avatar
璃白. 已提交
68 69 70 71 72

```js
new MdEditor({
    ...,
    onUpload: function(file, callback) {
璃白.'s avatar
璃白. 已提交
73
        // do something with file
璃白.'s avatar
璃白. 已提交
74 75 76
        // ajax
        // ...
        // 得到图片的url
璃白.'s avatar
璃白. 已提交
77
        // 在callback函数中回传图片url,编辑器会将图片链接粘贴到内容里
璃白.'s avatar
璃白. 已提交
78 79 80 81
        callback(url)
    }
})
```
璃白.'s avatar
璃白. 已提交
82 83

# License
璃白.'s avatar
璃白. 已提交
84 85

[MIT](https://codechina.csdn.net/codechina_dev/markdown-editor/-/blob/master/LICENSE)