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,42 @@
+---
+title: Arrange actions
+description: Replace the preset with explicit actions and place controls in the correct editing surfaces.
+order: 11
+toc:
+  - id: explicit-actions
+    title: Explicit actions
+  - id: placement
+    title: Placement
+  - id: action-groups
+    title: Action groups
+---
+
+## Explicit actions {#explicit-actions}
+
+Switch from a preset to children when the product needs exact feature and ordering control:
+
+```tsx
+<LexicalActions>
+  <Undo />
+  <Redo />
+  <Bold />
+  <Italic />
+  <Link />
+</LexicalActions>
+```
+
+## Placement {#placement}
+
+Actions default to the fixed toolbar. The `in` prop accepts one area or several:
+
+```tsx
+<Bold in={["toolbar", "bubble"]} />
+<Date in="bubble" />
+<ClearFormatting in="footer" />
+```
+
+Hidden actions provide editor behavior without rendering a control. `DraggableBlocks` uses this pattern.
+
+## Action groups {#action-groups}
+
+`ActionGroup` can be a logical group or a visible menu. Use a menu for mutually related choices such as normal text, headings, quotes, and list styles.
@@ -0,0 +1,47 @@
+---
+title: Create the editor
+description: Render the root, content surface, toolbars, and a complete default action set.
+order: 10
+toc:
+  - id: styles
+    title: Styles
+  - id: editor-structure
+    title: Editor structure
+  - id: presets
+    title: Presets
+---
+
+## Styles {#styles}
+
+Import the editor stylesheet once in the application:
+
+```ts
+import "@workspace/lexical/globals.css"
+```
+
+## Editor structure {#editor-structure}
+
+```tsx
+import {
+  LexicalActions,
+  LexicalBubbleToolbar,
+  LexicalContent,
+  LexicalFixedToolbar,
+  LexicalFooter,
+  LexicalRoot,
+} from "@workspace/lexical"
+
+;<LexicalRoot value="" onChange={setHtml}>
+  <LexicalActions useDefaults="full" />
+  <LexicalFixedToolbar />
+  <LexicalContent placeholder="Start writing…" />
+  <LexicalBubbleToolbar />
+  <LexicalFooter />
+</LexicalRoot>
+```
+
+Toolbars and the footer render no DOM when their region has no actions and no custom children.
+
+## Presets {#presets}
+
+Choose `minimal` for basic text editing or `full` for the complete built-in feature set. Preset mode intentionally does not accept manual action children.