amis2/docs/zh-CN/components/code.md

title	description	type	group	menuName	icon	order
Code 代码高亮		0	⚙ 组件	Code		38

使用代码高亮的方式来显示一段代码。

基本用法

{
  "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

{
  "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 支持从上下文获取数据

{
  "type": "page",
  "data": {
    "lang": "javascript"
  },
  "body": {
    "type": "code",
    "language": "${lang}",
    "value": "function amis() {\n  console.log('amis');\n}"
  }
}

动态数据

可以使用 name 来从上下文来获取数据，比如

{
  "type": "page",
  "data": {
    "sourcecode": "<div>html</div>"
  },
  "body": {
    "type": "code",
    "language": "html",
    "name": "sourcecode"
  }
}

因此它还能放在表单、crud 中实现代码的展现。

主题及 tab 大小

通过 editorTheme 设置主题，tagSize 设置 tab 宽度

{
  "type": "code",
  "language": "javascript",
  "tagSize": 4,
  "value": "function amis() {\n\tconsole.log('amis');\n}"
}

超出换行

1.5.1 及以上版本

通过 wordWrap 设置是否折行，默认是折行

{
  "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 可以实现最大高度，超出滚动

{
  "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 参数来自定义高亮，详情参考示例。

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		最大高度