📄️ 文件格式(FileFormat)
实现此协议可为自定义二进制文件格式添加编辑器支持。声明了扩展名的文件会作为 blob 导入,保留原始字节,并通过 view 获得预览。若要为可在编辑器中编辑的文本格式提供支持,请改用 TextFileFormat。
📄️ 编辑器上下文(EditorContext)
在 FileFormat 视图编辑时提供的上下文。它返回的所有内容要么是不可变的,要么是私有实例;不会回写到打开文件的实时状态。
📄️ 编辑器滚动(EditorScroll)
文本编辑器面板的滚动位置。line 是视口顶部所在的小数 0-based 行:10.5 表示视口顶部位于第 10 行的中间。percent 在编辑器可滚动范围内从 0 到 1。
📄️ 编辑器主题(EditorTheme)
编辑器解析后的代码主题(默认值、用户的 Luau 配置和覆盖项已合并)。当用户配置发生变化时,值会实时刷新;请在 draw/measure 中读取,而不是跨帧缓存。
📄️ 编辑器主题样式(EditorThemeStyle)
一个高亮作用域的样式,使用纯值,以便可以直接供给 paint、视图模型或其他地方使用。
📄️ 自动完成项(FormatCompletion)
一条自动完成条目。省略范围时,会在光标位置插入文本。
📄️ 诊断信息(FormatDiagnostic)
一个要显示在文档行号和问题面板中的问题。
📄️ 格式文档(FormatDocument)
一个正在被编辑的文档,会传给每个 FileFormat 回调。text(文本文档)和 bytes(二进制文档)中有且仅有一个会被设置。返回给 Rive 的位置都是基于 text 的 0-based 字节偏移。
📄️ 悬停提示(FormatHover)
悬停给定范围时显示的文档。
📄️ 高亮作用域(FormatScope)
标记的高亮作用域。作用域映射到 Luau 和 WGSL 编辑器使用的相同主题颜色。
📄️ 格式表面(FormatSurface)
FileFormat 视图所在的宿主位置:'pane' 表示编辑器分栏或完整的 viewer 标签页,'inspector' 表示选中的资源条。
📄️ 高亮标记(FormatToken)
一个高亮片段。省略 length 时,该片段会延伸到同一行下一个标记,或行尾。
📄️ 格式视图(FormatView)
一个文档在一个表面上的实时预览。由 FileFormat.view 创建;当表面关闭时释放。
📄️ 文本文件格式(TextFileFormat)
用于文本的 FileFormat。声明了扩展名的文件会作为带内文本文档导入,可在编辑器中编辑并跨协作者同步,下方回调会驱动文本编辑器的智能提示。文档导出时为纯 blob,因此脚本在编辑时和运行时都可以通过 context:blob(name) 读取它们。