脚本笔记可以由事件触发。请注意,这些是后端事件,因此 relation 需要指向“JS backend”代码笔记。
全局事件
全局事件通过标签附加到代码笔记。只需使用其中一些值创建例如“run”标签,一旦事件发生,代码笔记就会被执行。
| 标签 | 描述 |
|---|---|
run | 定义脚本应在哪些事件上运行。可能的值包括:
|
runOnInstance | 指定脚本应仅在特定的 Trilium 实例上运行。 |
runAtHour | 这应该在什么时间运行。应与 一起使用。可以多次定义,以便在白天进行更多运行。#run=hourly |
实体事件
其他事件绑定到某个实体,这些被定义为关系 - 这意味着只有当 note 通过关系附加了这个脚本(或者它可以继承它)时,才会触发脚本。
| 关系 | 描述 |
|---|---|
runOnNoteCreation | 在后端创建笔记时执行。如果要为在特定子树下创建的所有笔记运行脚本,请使用此关系。在这种情况下,请在子树根笔记上创建它并使其可继承。在子树(任何深度)中创建的新笔记将触发脚本。 |
runOnChildNoteCreation | 在定义了此关系的注解下创建新笔记时执行 |
runOnNoteTitleChange | 更改笔记标题时执行(也包括笔记创建) |
runOnNoteContentChange | 在笔记内容更改时执行(也包括笔记创建)。 |
runOnNoteChange | 在笔记更改时执行(也包括笔记创建)。不包括内容更改 |
runOnNoteDeletion | 删除笔记时执行 |
runOnBranchCreation | 在创建分支时执行。分支是父笔记和子笔记之间的链接,例如在克隆或移动笔记时创建。 |
runOnBranchChange | 在更新分支时执行。(从 v0.62 开始) |
runOnBranchDeletion | 在删除分支时执行。分支是父笔记和子笔记之间的链接,例如在移动笔记时被删除(旧分支/链接被删除)。 |
runOnAttributeCreation | 在为定义此关系的笔记创建新属性时执行 |
runOnAttributeChange | 当定义此关系的笔记的属性发生更改时执行。删除属性时也会触发此作 |