feat(docs): add bilingual package documentation site

2026-09-20 15:53:28 +08:00
parent 60f6f1fb1a
commit dc80bd8ae0
111 changed files with 6531 additions and 0 deletions
@@ -0,0 +1,44 @@
+---
+title: Define an action
+description: Add product-specific behavior while preserving automatic dependency collection.
+order: 20
+toc:
+  - id: declare-the-action
+    title: Declare the action
+  - id: custom-control
+    title: Custom control
+  - id: typed-values
+    title: Typed values
+---
+
+## Declare the action {#declare-the-action}
+
+Keep the command and its editor dependencies in one definition:
+
+```tsx
+const Mention = defineLexicalAction({
+  name: "mention",
+  label: "Insert mention",
+  nodes: [MentionNode],
+  plugins: [MentionPopoverPlugin],
+  execute: ({ editor }) => openMentionPicker(editor),
+})
+```
+
+The node and plugin are enabled whenever `<Mention />` appears inside `LexicalActions`.
+
+## Custom control {#custom-control}
+
+```tsx
+<Mention>
+  {({ disabled, execute }) => (
+    <MentionButton disabled={disabled} onSelect={execute} />
+  )}
+</Mention>
+```
+
+Replacing the visible control does not change dependency collection.
+
+## Typed values {#typed-values}
+
+The render context exposes `execute(value?)` with the action's value type. `onClick` is the no-argument shortcut for ordinary buttons.