fix(cdk:popper): modify default placement to bottomStart (#1785)

IDuxFE · Jan 8, 2024 · 5d9ddc4 · 5d9ddc4
1 parent ca64a1e
commit 5d9ddc4
Show file tree

Hide file tree

Showing 3 changed files with 4 additions and 4 deletions.
diff --git a/packages/cdk/popper/__tests__/__snapshots__/popper.spec.ts.snap b/packages/cdk/popper/__tests__/__snapshots__/popper.spec.ts.snap
@@ -12,12 +12,12 @@ exports[`usePopper > options > autoAdjust work 2`] = `
 
 exports[`usePopper > options > offset work 1`] = `
 "<div id=\\"trigger\\">Trigger</div>
-<div id=\\"overlay\\" style=\\"position: absolute; left: 0px; top: 0px;\\" data-popper-reference-hidden=\\"\\" data-popper-placement=\\"top\\">Popper</div>"
+<div id=\\"overlay\\" style=\\"position: absolute; left: 0px; top: 0px;\\" data-popper-reference-hidden=\\"\\" data-popper-placement=\\"bottom-start\\">Popper</div>"
 `;
 
 exports[`usePopper > options > offset work 2`] = `
 "<div id=\\"trigger\\">Trigger</div>
-<div id=\\"overlay\\" style=\\"position: absolute; left: 0px; top: 0px;\\" data-popper-reference-hidden=\\"\\" data-popper-placement=\\"top\\">Popper</div>"
+<div id=\\"overlay\\" style=\\"position: absolute; left: 0px; top: 0px;\\" data-popper-reference-hidden=\\"\\" data-popper-placement=\\"bottom-start\\">Popper</div>"
 `;
 
 exports[`usePopper > options > placement work 1`] = `

diff --git a/packages/cdk/popper/docs/Api.zh.md b/packages/cdk/popper/docs/Api.zh.md
@@ -15,7 +15,7 @@ export function usePopper(options?: PopperOptions): PopperInstance
 | `delay` | 延迟显示或隐藏的时间 | `number \| [number \| null, number \| null]` | `0` | - | 为数组时，第一个元素是延迟显示的时间，第二个元素是延迟隐藏的时间 |
 | `disabled` | 是否禁用浮层 | `boolean` | `false` | - | - |
 | `offset` | 浮层相对目标元素的偏移量 | `[number, number]` | `[0, 0]` | - | 第一个元素是水平偏移量，第二个元素是垂直偏移量 |
-| `placement` | 浮层的位置 | `PopperPlacement` | `top` | - | - |
+| `placement` | 浮层的位置 | `PopperPlacement` | `bottomStart` | - | - |
 | `trigger` | 浮层的触发方式 | `PopperTrigger` | `hover` | - | - |
 | `visible` | 是否显示浮层 | `boolean` | `false` | - | - |
 | `strategy` | 浮层的定位策略 | `'absolute' \| 'fixed'` | `absolute` | - | - |

diff --git a/packages/cdk/popper/src/composables/useOptions.ts b/packages/cdk/popper/src/composables/useOptions.ts
@@ -23,7 +23,7 @@ export function usePopperOptions(options: PopperOptions): {
     delay: options.delay ?? defaultDelay,
     disabled: options.disabled ?? false,
     offset: options.offset ?? [0, 0],
-    placement: options.placement ?? 'top',
+    placement: options.placement ?? 'bottomStart',
     trigger: options.trigger ?? 'hover',
     visible: options.visible ?? false,
     strategy: options.strategy ?? 'absolute',