mirror of
https://gitee.com/baidu/amis.git
synced 2024-12-02 03:58:07 +08:00
145 lines
4.6 KiB
Markdown
145 lines
4.6 KiB
Markdown
---
|
||
title: Code 代码高亮
|
||
description:
|
||
type: 0
|
||
group: ⚙ 组件
|
||
menuName: Code
|
||
icon:
|
||
order: 38
|
||
---
|
||
|
||
使用代码高亮的方式来显示一段代码。
|
||
|
||
## 基本用法
|
||
|
||
```schema: scope="body"
|
||
{
|
||
"type": "code",
|
||
"language": "html",
|
||
"value": "<div>html</div>"
|
||
}
|
||
```
|
||
|
||
## 语言设置
|
||
|
||
默认语言是 html，可以通过 language 指定以下语言：
|
||
|
||
`bat`、 `c`、 `coffeescript`、 `cpp`、 `csharp`、 `css`、 `dockerfile`、 `fsharp`、 `go`、 `handlebars`、 `html`、 `ini`、 `java`、 `javascript`、 `json`、 `less`、 `lua`、 `markdown`、 `msdax`、 `objective-c`、 `php`、 `plaintext`、 `postiats`、 `powershell`、 `pug`、 `python`、 `r`、 `razor`、 `ruby`、 `sb`、 `scss`、`shell`、 `sol`、 `sql`、 `swift`、 `typescript`、 `vb`、 `xml`、 `yaml`
|
||
|
||
```schema
|
||
{
|
||
"body": {
|
||
"type": "code",
|
||
"language": "javascript",
|
||
"value": "(function () {\n let amis = amisRequire('amis/embed');\n let amisJSON = {\n type: 'page',\n title: '表单页面',\n body: {\n type: 'form',\n mode: 'horizontal',\n api: '/saveForm',\n body: [\n {\n label: 'Name',\n type: 'input-text',\n name: 'name'\n },\n {\n label: 'Email',\n type: 'input-email',\n name: 'email'\n }\n ]\n }\n };\n let amisScoped = amis.embed('#root', amisJSON);\n})();"
|
||
}
|
||
}
|
||
```
|
||
|
||
language 支持从上下文获取数据
|
||
|
||
```schema
|
||
{
|
||
"type": "page",
|
||
"data": {
|
||
"lang": "javascript"
|
||
},
|
||
"body": {
|
||
"type": "code",
|
||
"language": "${lang}",
|
||
"value": "function amis() {\n console.log('amis');\n}"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 动态数据
|
||
|
||
可以使用 name 来从上下文来获取数据，比如
|
||
|
||
```schema
|
||
{
|
||
"type": "page",
|
||
"data": {
|
||
"sourcecode": "<div>html</div>"
|
||
},
|
||
"body": {
|
||
"type": "code",
|
||
"language": "html",
|
||
"name": "sourcecode"
|
||
}
|
||
}
|
||
```
|
||
|
||
因此它还能放在表单、crud 中实现代码的展现。
|
||
|
||
## 主题及 tab 大小
|
||
|
||
通过 `editorTheme` 设置主题，`tagSize` 设置 tab 宽度
|
||
|
||
```schema: scope="body"
|
||
{
|
||
"type": "code",
|
||
"language": "javascript",
|
||
"tagSize": 4,
|
||
"value": "function amis() {\n\tconsole.log('amis');\n}"
|
||
}
|
||
|
||
```
|
||
|
||
## 超出换行
|
||
|
||
> 1.5.1 及以上版本
|
||
|
||
通过 `wordWrap` 设置是否折行，默认是折行
|
||
|
||
```schema: scope="body"
|
||
{
|
||
"type": "code",
|
||
"language": "typescript",
|
||
"tagSize": 4,
|
||
"wordWrap": false,
|
||
"value": "function amis() {\n\tconsole.log('amis')\tconsole.log('amis')\tconsole.log('amis')\tconsole.log('amis')\tconsole.log('amis')\tconsole.log('amis');\n}"
|
||
}
|
||
```
|
||
|
||
## 最大高度
|
||
|
||
通过配置 `maxHeight` 可以实现最大高度，超出滚动
|
||
|
||
```schema
|
||
{
|
||
"body": {
|
||
"type": "code",
|
||
"language": "javascript",
|
||
"className": "b-a",
|
||
"maxHeight": 200,
|
||
"value": "(function () {\n let amis = amisRequire('amis/embed');\n let amisJSON = {\n type: 'page',\n title: '表单页面',\n body: {\n type: 'form',\n mode: 'horizontal',\n api: '/saveForm',\n body: [\n {\n label: 'Name',\n type: 'input-text',\n name: 'name'\n },\n {\n label: 'Email',\n type: 'input-email',\n name: 'email'\n }\n ]\n }\n };\n let amisScoped = amis.embed('#root', amisJSON);\n})();"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 自定义语言高亮
|
||
|
||
还可以通过 `customLang` 参数来自定义高亮，详情参考[示例](../../../examples/code)。
|
||
|
||
`customLang` 中主要是 `tokens` 设置，这里是语言词法配置，它有 4 个配置项：
|
||
|
||
- `name`：词法名称
|
||
- `regex`：词法的正则匹配，注意因为是在字符串中，这里正则中如果遇到 `\` 需要写成 `\\`
|
||
- `regexFlags`: 可选，正则的标志参数
|
||
- `color`：颜色
|
||
- `fontStyle`: 可选，字体样式，比如 `bold` 代表加粗
|
||
|
||
## 属性表
|
||
|
||
| 属性名 | 类型 | 默认值 | 说明 |
|
||
| ----------- | ------------------ | ------ | ---------------------------------- |
|
||
| className | `string` | | 外层 CSS 类名 |
|
||
| value | `string` | | 显示的颜色值 |
|
||
| name | `string` | | 在其他组件中，时，用作变量映射 |
|
||
| language | `string` | | 所使用的高亮语言，默认是 plaintext |
|
||
| tabSize | `number` | 4 | 默认 tab 大小 |
|
||
| editorTheme | `string` | 'vs' | 主题，还有 'vs-dark' |
|
||
| wordWrap | `string` | `true` | 是否折行 |
|
||
| maxHeight | `string`\|`number` | | 最大高度 |
|