# 大文件 编辑器只绘制可见的行,十万行以上的文件也可以直接打开和编辑。 ## 基础用法 文件很大时,建议使用 `v-model:doc` 代替 `v-model`。`v-model` 每次修改都要把全部文本拼成一个字符串,`v-model:doc` 则直接交回 `CodeText`。 ```ts import { CodeText } from '@dou-ui/code' import { shallowRef } from 'vue' const doc = shallowRef(CodeText.of(source)) // 需要字符串时再调用 doc.value.toString() ``` `CodeText` 是不可变的,每次修改得到一个新的 `CodeText`,未改动的部分与旧的共享,用 `shallowRef` 保存即可。 只需要最终结果时,也可以使用 `v-model.lazy`,在编辑器失去焦点时才更新字符串。 ## 语法着色 编辑器先给可见的行着色,其余的行在浏览器空闲时继续处理。修改后从改动的行开始重新处理,通常只需要重新处理一两行。 直接跳到还没处理到的位置时,那里的代码先显示为普通文字,处理完成后再着色。 ## 在 worker 中分析语法 加上 `worker` 后,语法分析在 Web Worker 中进行,页面只处理可见的几行。 ```vue ``` 自带的 worker 支持所有内置语言,多个编辑器共用一个,最后一个编辑器卸载时结束。它以 `blob:` 地址启动,站点设置了内容安全策略(CSP)时,需要在 `worker-src` 中允许 `blob:`。 ### 使用自己的 worker 使用自定义语言,或者不能允许 `blob:` 时,`worker` 传入一个创建 worker 的函数。在 worker 文件中调用 `serveCodeHighlighting`,列出要支持的语言: ```ts // highlight.ts import { javascript, serveCodeHighlighting } from '@dou-ui/code/worker' import { myLanguage } from './my-language' serveCodeHighlighting([javascript, myLanguage]) ``` ```vue ``` - 函数在编辑器挂载后才调用,服务端渲染时不会创建 worker。 - 编辑器卸载或更换 `worker` 时会结束它创建的 worker,所以函数每次都要返回新的 worker。 - `@dou-ui/code/worker` 只包含语言和语法分析,不会引入 Vue。包含其他语言的语言要在 `nested` 中列出它们。 - worker 无法启动,或缺少编辑器使用的语言时,编辑器改为在页面中空闲时处理,开发环境下会在控制台提示原因。 ## 小地图 `minimap` 在右侧显示整份代码的缩略图,并标出可见的部分。点击缩略图跳到对应位置,拖动标记滚动。编辑器窄于 480px 时不显示。