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: 编排操作
+description: 用显式 Actions 替换预设，并将控件放入正确的编辑区域。
+order: 11
+toc:
+  - id: explicit-actions
+    title: 显式 Actions
+  - id: placement
+    title: 放置位置
+  - id: action-groups
+    title: Action 分组
+---
+
+## 显式 Actions {#explicit-actions}
+
+当产品需要精确控制功能和顺序时，将预设切换为子元素：
+
+```tsx
+<LexicalActions>
+  <Undo />
+  <Redo />
+  <Bold />
+  <Italic />
+  <Link />
+</LexicalActions>
+```
+
+## 放置位置 {#placement}
+
+Actions 默认显示在固定工具栏中。`in` 属性接受一个或多个区域：
+
+```tsx
+<Bold in={["toolbar", "bubble"]} />
+<Date in="bubble" />
+<ClearFormatting in="footer" />
+```
+
+隐藏 Action 可以提供编辑器行为而不渲染控件，`DraggableBlocks` 就使用了这种模式。
+
+## Action 分组 {#action-groups}
+
+`ActionGroup` 可以是逻辑分组，也可以是可见菜单。普通文本、标题、引用和列表样式等相互关联的选择适合放入菜单。
@@ -0,0 +1,47 @@
+---
+title: 创建编辑器
+description: 渲染根节点、内容区域、工具栏和完整的默认 Action 集合。
+order: 10
+toc:
+  - id: styles
+    title: 样式
+  - id: editor-structure
+    title: 编辑器结构
+  - id: presets
+    title: 预设
+---
+
+## 样式 {#styles}
+
+在应用中导入一次编辑器样式：
+
+```ts
+import "@workspace/lexical/globals.css"
+```
+
+## 编辑器结构 {#editor-structure}
+
+```tsx
+import {
+  LexicalActions,
+  LexicalBubbleToolbar,
+  LexicalContent,
+  LexicalFixedToolbar,
+  LexicalFooter,
+  LexicalRoot,
+} from "@workspace/lexical"
+
+;<LexicalRoot value="" onChange={setHtml}>
+  <LexicalActions useDefaults="full" />
+  <LexicalFixedToolbar />
+  <LexicalContent placeholder="开始输入…" />
+  <LexicalBubbleToolbar />
+  <LexicalFooter />
+</LexicalRoot>
+```
+
+当某个区域没有 Actions 或自定义子元素时，对应工具栏和 Footer 不会渲染 DOM。
+
+## 预设 {#presets}
+
+基础文本编辑选择 `minimal`，完整内置功能选择 `full`。预设模式有意不接受手动 Action 子元素。