am-editor-001/docs/plugin/plugin-link.zh-CN.md

98 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# @aomao/plugin-link
链接插件
## 安装
```bash
$ yarn add @aomao/plugin-link
```
`Vue3` 使用
```bash
$ yarn add @aomao/plugin-link-vue
```
`Vue2` 使用
```bash
$ yarn add am-editor-link-vue2
```
添加到引擎
```ts
import Engine, { EngineInterface } from '@aomao/engine';
import Link from '@aomao/plugin-link';
new Engine(...,{ plugins:[Link] })
```
## 可选项
### 快捷键
默认快捷键为 `mod+k`,默认参数为 ["_blank"]
```ts
//快捷键key 组合键args执行参数[target?:string,href?:string,text?:string] 打开模式:可选,默认链接:可选,默认文本:可选
hotkey?:string | {key:string,args:Array<string>};
//使用配置
new Engine(...,{
config:{
"link":{
//修改快捷键
hotkey:{
key:"mod+k",
args:["_balnk_","https://www.aomao.com","ITELLYOU"]
}
}
}
})
```
### Markdown
默认支持 markdown传入`false`关闭
Link 插件 markdown 语法为`[文本](链接地址)` 回车后触发
```ts
markdown?: boolean;//默认开启false 关闭
//使用配置
new Engine(...,{
config:{
"link":{
//关闭markdown
markdown:false
}
}
})
```
### onConfirm
可对要修改的 url 或者 文本 进行修改
在编辑文本和 url 后确认执行
```ts
onConfirm?: (
text: string,
link: string,
) => Promise<{ text: string; link: string }>;
```
## 命令
可传入三个参数[target?:string,href?:string,text?:string] 打开模式:可选,默认链接:可选,默认文本:可选
```ts
//target:'_blank', '_parent', '_top', '_self'href:链接text:文字
engine.command.execute('link', '_blank', 'https://www.aomao.com', 'ITELLYOU');
//使用 command 执行查询当前状态,返回 boolean | undefined
engine.command.queryState('link');
```