u

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

@@ -81,6 +81,7 @@ description: 点击 / 悬停 / 右键触发的操作列表，支持子菜单与
 | `mouseLeaveDelay` | `number` | `200` | hover 关闭延迟（ms）。有子菜单时适当调大 |
 | `offset` | `number` | `4` | 与触发器的间距（px） |
 | `unwrapped` | `boolean` | `true` | 零包裹模式，触发器不额外包 `<span>` |
+| `menuMaxHeight` | `boolean \| number \| string` | — | 菜单面板最大高度（超出才滚动）。不传 / `true` 用默认上限（`--g3-dropdown-max-height`，兜底 `calc(100vh - 48px)`）；`false` 不限制（面板随内容撑开，菜单很短时才用）；数字按 px；字符串原样（如 `'320px'` / `'min(480px, 70vh)'`）。面板 Teleport 到 `body`，调用方没法用 CSS 局部覆盖那个变量，所以按实例调整用这个 prop。子菜单面板沿用同一个值 |
 
 ### Events
 
@@ -138,7 +139,7 @@ export interface DropdownClickPayload {
 | 变量 | 默认值 | 说明 |
 | --- | --- | --- |
 | `--g3-dropdown-min-width` | `180px` | 菜单最小宽度 |
-| `--g3-dropdown-max-height` | `256px` | 菜单最大高度（超出滚动） |
+| `--g3-dropdown-max-height` | `calc(100vh - 48px)` | 菜单最大高度（超出滚动）；按视口算，菜单长到屏幕放不下才滚 |
 | `--g3-dropdown-item-padding-y` / `-x` | `5px` / `8px` | 菜单项内边距 |
 | `--g3-dropdown-item-radius` | `4px` | 菜单项圆角 |
 | `--g3-dropdown-divider-margin` | `4px 0` | 分隔线外边距 |