12. 钩子与事件

钩子(hooks)

clojure
(add-hook! :after-save-hook (fn [ed] (ed/message ed "saved!") ed))
代码

函数收 editor、返回 editor;抛错只写 echo area,不中断编辑。可用钩子:

| 钩子 | 时机 |
|---|---|
| `:after-init-hook` | 启动完成后 |
| `:find-file-hook` | 打开文件后 |
| `:after-save-hook` | 存盘后 |
| `:kill-buffer-hook` | 关 buffer 前(在被关的 buffer 里跑) |
| `:kill-emacs-hook` | 退出时 |
| `:post-command-hook` | 每个输入事件之后 |
| `:post-self-insert-hook` | 自插入字符之后 |
| `:window-change-hook` | 窗口布局变化后 |
| `:tick-hook` | 主循环每轮(参数 now 毫秒) |
| `:change-major-mode-hook` / `:after-change-major-mode-hook` | 主模式切换前 / 后 |
| `<模式>-mode-hook`(如 `:clojure-mode-hook` `:prog-mode-hook`) | 进入主模式后 |
| `<次要模式>-hook`(如 `:slime-mode-hook`) | 次要模式开 / 关之后 |

`add-hook!` 第三参给深度(-100..100,缺省 0;`true` = 90,照 Emacs APPEND)。
buffer 局部钩子用 `coxn.hooks/add-local-hook`。

### 事件(bus)
clojure
(subscribe! :document-opened (fn [event {:keys [buffer path new?]}] ...))
代码

事件是**已发生的事实**(过去式 + 不可变 payload),handler 不返回 editor、不能 veto。
当前内置:`:document-opened`(`{:buffer :path :new?}`)、`:document-renamed`
(`{:buffer :new-buffer :path}`)。`subscribe!` 返回退订函数。

原始 Markdown:coxn 使用手册(Markdown) · 安装包:coxn 产品页