u

code/g3soft-libs/docs/content/ui/overlay/dropdown.md

@@ -52,6 +52,23 @@ description: 点击 / 悬停 / 右键触发的操作列表，支持子菜单与
 
 <demo vue="dropdown/header-slot.vue" />
 
+## 分裂按钮
+
+分裂按钮（对齐 Ant Design 的 `Dropdown.Button` / TinyMCE 的分裂下拉按钮）由 **`G3ButtonGroup` 组合**而成，`Dropdown` 本身不提供 `split` prop：图标按钮是独立的主操作（点它执行动作、不开菜单），箭头按钮是 `Dropdown` 自己的触发器（点它才展开菜单）。边框贴合、首尾圆角、hover 抬层全由 `G3ButtonGroup` 承担，无需自绘分隔线。
+
+```vue
+<G3ButtonGroup>
+  <G3Button @click="onToggleList">无序列表</G3Button>
+  <G3Dropdown>
+    <template #trigger>
+      <G3Button aria-label="无序列表样式"><ChevronDown /></G3Button>
+    </template>
+    <G3DropdownItem item-key="square">实心方块</G3DropdownItem>
+    <G3DropdownItem item-key="circle">空心圆圈</G3DropdownItem>
+  </G3Dropdown>
+</G3ButtonGroup>
+```
+
 ## 键盘操作
 
 菜单打开后焦点会进入菜单容器，因此可以直接用键盘：