Univer
Univer Slide
教程
如何查找命令 ID

如何查找命令 ID

📊📝📽️ Univer General

开发者在进行扩展或者开发插件时,经常需要查找某个命令的 ID。而 Univer 繁多的插件生态中包含了大量的命令,如何快速找到某个命令的 ID 呢?

从插件中引入 0.2.0+

Univer 导出了所有的命令,你可以在 API Reference 中找到目标命令,并从对应的包中导入,即可获取到命令的 ID。

例如,你想要查找设置选区下划线的命令 ID,首先可以在 API Reference - Variable: SetRangeUnderlineCommand 中找到。然后就可以这样导入并获取命令 ID:

import { SetRangeUnderlineCommand } from '@univerjs/sheets-ui';
 
console.log(SetRangeUnderlineCommand.id);

开启日志

创建 Univer 实例时,可以通过 logLevel 参数来设置日志级别。日志级别有 5 种,分别是:

  • LogLevel.SILENT:不输出日志
  • LogLevel.ERROR:只输出错误日志
  • LogLevel.WARN:输出错误和警告日志
  • LogLevel.INFO:输出错误、警告和信息日志
  • LogLevel.VERBOSE:输出所有日志
const univer = new Univer({
+  logLevel: LogLevel.VERBOSE,
});

使用 LogLevel.VERBOSE 日志级别,Univer 会输出所有的操作日志信息,其中包括命令的 ID。

需要特别注意的是,部分浏览器的默认日志级别可能会隐藏 VERBOSE 级别的日志,你可能需要手动调整浏览器的日志级别。

调整 Edge 浏览器的日志级别

阅读源码

如果你对 Univer 的架构所有了解,应该能非常轻松地在源码中寻找到命令的 ID。

命令通常存放在插件目录的 commands 文件夹中。你需要根据命令的功能来查找对应的文件,然后在文件中找到命令的 ID。

比如修改 Worksheet 标签背景色的命令可以在 ./packages/ui/src/commands/commands/set-tab-color.command.ts 中找到,这个 ID 的名称叫作 sheet.command.set-tab-color


Copyright © 2021-2024 DreamNum Co,Ltd. All Rights Reserved.