x-next 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.3.0] - 2026-09-30
+
+### 修复
+
+- **Select**：关闭状态不再吞掉 Escape；方向键可打开下拉，键盘选择与关闭后保留焦点，Tab 保留浏览器原生焦点移动。
+- **Checkbox**：原生 `required`、`form`、`tabindex`、`autofocus` 和 `autocomplete` 属性传到内部 input，保留外层 class/style 与组件受控状态。
+- **Dialog / Drawer**：完善顺序 Tab 候选与共享滚动锁清理，正确归还自定义容器的原始样式。
+- **Dropdown**：补齐受控菜单焦点、方向键/Home/End 导航、禁用项跳过、多级菜单进入返回与 Escape 关闭；保留鼠标点击和悬浮行为。
+- **局部暗色主题**：生成完整受影响变量依赖链，让同一暗色容器内的语义覆盖正确传递到表单和组件别名，保留组件自身覆盖。
+- **文档与类型**：补充 `MessageBoxStaticMethod` 根入口类型导出；快速开始明确局部导入与全局注册的区别。
+
 ## [1.2.0] - 2026-09-30
 
 ### 新增
@@ -69,5 +80,6 @@
 - Progress 不支持 `indeterminate` 不确定态与自定义 `format` 文本（可用 `text` 插槽替代）。
 - Space 不支持 Arco 的 `size` 数组写法与 `wrap`。
 
+[1.3.0]: https://gitee.com/ztes/x-next/releases/tag/v1.3.0
 [1.2.0]: https://gitee.com/ztes/x-next/releases/tag/v1.2.0
 [1.1.0]: https://github.com/ztes/x-next/releases/tag/v1.1.0

package/dist/components/dropdown/Dropdown.vue.d.ts

@@ -90,6 +90,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         default: boolean;
     };
 }>, {
+    renderTrigger: (attrs: Record<string, unknown>) => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+        [key: string]: any;
+    }>[];
     className: {
         block: string;
         element: (className: string) => string;
@@ -100,6 +103,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     handlePopupVisibleChange: (visible: boolean) => void;
     handleScroll: (ev: Event) => void;
     handleReachBottom: (ev: Event) => void;
+    panelRef: import('vue').Ref<import('./context').DropdownPanelRef | undefined, import('./context').DropdownPanelRef | undefined>;
+    handleShow: () => void;
+    handleTriggerKeydown: (ev: KeyboardEvent) => void;
+    handleTriggerFocus: (ev: FocusEvent) => void;
+    handleClose: () => void;
+    handleKeyboardSelect: (ev: Event) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     'update:popupVisible': (visible: boolean) => true;
     /**
@@ -801,6 +810,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         install(app: import('vue').App): void;
     };
     DropdownPanel: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+        closeOnArrowLeft: BooleanConstructor;
         loading: {
             type: BooleanConstructor;
             default: boolean;
@@ -831,9 +841,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         })[]>;
         style: import('vue').ComputedRef<import('vue').CSSProperties | undefined>;
         wrapperRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        panelElement: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        handleKeydown: (ev: KeyboardEvent) => void;
         handleScroll: (e: Event) => void;
         t: (key: import('../../index.ts').LocaleKey | (string & {}), params?: Record<string, string | number>) => string;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("scroll" | "reachBottom")[], "scroll" | "reachBottom", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("close" | "scroll" | "reachBottom")[], "close" | "scroll" | "reachBottom", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+        closeOnArrowLeft: BooleanConstructor;
         loading: {
             type: BooleanConstructor;
             default: boolean;
@@ -853,10 +866,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: PropType<import('../../_hooks/_types.ts').EmitType<(ev: Event) => void>>;
         };
     }>> & Readonly<{
+        onClose?: ((...args: any[]) => any) | undefined;
         onScroll?: ((...args: any[]) => any) | undefined;
         onReachBottom?: ((...args: any[]) => any) | undefined;
     }>, {
         loading: boolean;
+        closeOnArrowLeft: boolean;
         isEmpty: boolean;
         bottomOffset: number;
     }, {}, {
@@ -1315,5 +1330,16 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             install(app: import('vue').App): void;
         };
     }, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+    RenderFunction: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+        renderFunc: {
+            type: PropType<import('../../_container/render-function').RenderFunc>;
+            required: true;
+        };
+    }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+        renderFunc: {
+            type: PropType<import('../../_container/render-function').RenderFunc>;
+            required: true;
+        };
+    }>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 }, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/dropdown/DropdownButton.vue.d.ts

@@ -667,6 +667,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             default: boolean;
         };
     }>, {
+        renderTrigger: (attrs: Record<string, unknown>) => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+            [key: string]: any;
+        }>[];
         className: {
             block: string;
             element: (className: string) => string;
@@ -677,6 +680,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         handlePopupVisibleChange: (visible: boolean) => void;
         handleScroll: (ev: Event) => void;
         handleReachBottom: (ev: Event) => void;
+        panelRef: import('vue').Ref<import('./context.ts').DropdownPanelRef | undefined, import('./context.ts').DropdownPanelRef | undefined>;
+        handleShow: () => void;
+        handleTriggerKeydown: (ev: KeyboardEvent) => void;
+        handleTriggerFocus: (ev: FocusEvent) => void;
+        handleClose: () => void;
+        handleKeyboardSelect: (ev: Event) => void;
     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         'update:popupVisible': (visible: boolean) => true;
         popupVisibleChange: (visible: boolean) => true;
@@ -1313,6 +1322,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             install(app: import('vue').App): void;
         };
         DropdownPanel: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+            closeOnArrowLeft: BooleanConstructor;
             loading: {
                 type: BooleanConstructor;
                 default: boolean;
@@ -1343,9 +1353,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             })[]>;
             style: import('vue').ComputedRef<import('vue').CSSProperties | undefined>;
             wrapperRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+            panelElement: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+            handleKeydown: (ev: KeyboardEvent) => void;
             handleScroll: (e: Event) => void;
             t: (key: import('../../index.ts').LocaleKey | (string & {}), params?: Record<string, string | number>) => string;
-        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("scroll" | "reachBottom")[], "scroll" | "reachBottom", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("close" | "scroll" | "reachBottom")[], "close" | "scroll" | "reachBottom", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+            closeOnArrowLeft: BooleanConstructor;
             loading: {
                 type: BooleanConstructor;
                 default: boolean;
@@ -1365,10 +1378,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
                 type: PropType<import('../../_hooks/_types.ts').EmitType<(ev: Event) => void>>;
             };
         }>> & Readonly<{
+            onClose?: ((...args: any[]) => any) | undefined;
             onScroll?: ((...args: any[]) => any) | undefined;
             onReachBottom?: ((...args: any[]) => any) | undefined;
         }>, {
             loading: boolean;
+            closeOnArrowLeft: boolean;
             isEmpty: boolean;
             bottomOffset: number;
         }, {}, {
@@ -1827,6 +1842,17 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
                 install(app: import('vue').App): void;
             };
         }, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+        RenderFunction: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+            renderFunc: {
+                type: PropType<import('../../_container/render-function.ts').RenderFunc>;
+                required: true;
+            };
+        }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+            renderFunc: {
+                type: PropType<import('../../_container/render-function.ts').RenderFunc>;
+                required: true;
+            };
+        }>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
     }, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 }, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/dropdown/DropdownOption.vue.d.ts

@@ -27,6 +27,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         [x: string]: boolean;
     })[]>;
     liRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+    tabIndex: import('vue').ComputedRef<0 | -1>;
+    handleFocus: () => void | undefined;
     handleClick: (ev: Event) => void;
     handleKeydown: (ev: KeyboardEvent) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {

package/dist/components/dropdown/DropdownSubmenu.vue.d.ts

@@ -62,6 +62,149 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: ObjectConstructor;
     };
 }>, {
+    optionRef: import('vue').Ref<import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        value: {
+            type: (StringConstructor | ObjectConstructor | NumberConstructor)[];
+        };
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        active: BooleanConstructor;
+        uninjectContext: BooleanConstructor;
+    }>> & Readonly<{
+        onClick?: ((ev: Event) => any) | undefined;
+    }>, {
+        className: {
+            block: string;
+            element: (className: string) => string;
+            modifier: (className: string) => string;
+            is: (className: string) => string;
+        };
+        cls: import('vue').ComputedRef<(string | {
+            [x: string]: boolean;
+        })[]>;
+        liRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        tabIndex: import('vue').ComputedRef<0 | -1>;
+        handleFocus: () => void | undefined;
+        handleClick: (ev: Event) => void;
+        handleKeydown: (ev: KeyboardEvent) => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        click: (ev: Event) => true;
+    }, import('vue').PublicProps, {
+        disabled: boolean;
+        active: boolean;
+        uninjectContext: boolean;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        value: {
+            type: (StringConstructor | ObjectConstructor | NumberConstructor)[];
+        };
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        active: BooleanConstructor;
+        uninjectContext: BooleanConstructor;
+    }>> & Readonly<{
+        onClick?: ((ev: Event) => any) | undefined;
+    }>, {
+        className: {
+            block: string;
+            element: (className: string) => string;
+            modifier: (className: string) => string;
+            is: (className: string) => string;
+        };
+        cls: import('vue').ComputedRef<(string | {
+            [x: string]: boolean;
+        })[]>;
+        liRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        tabIndex: import('vue').ComputedRef<0 | -1>;
+        handleFocus: () => void | undefined;
+        handleClick: (ev: Event) => void;
+        handleKeydown: (ev: KeyboardEvent) => void;
+    }, {}, {}, {}, {
+        disabled: boolean;
+        active: boolean;
+        uninjectContext: boolean;
+    }> | undefined, import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        value: {
+            type: (StringConstructor | ObjectConstructor | NumberConstructor)[];
+        };
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        active: BooleanConstructor;
+        uninjectContext: BooleanConstructor;
+    }>> & Readonly<{
+        onClick?: ((ev: Event) => any) | undefined;
+    }>, {
+        className: {
+            block: string;
+            element: (className: string) => string;
+            modifier: (className: string) => string;
+            is: (className: string) => string;
+        };
+        cls: import('vue').ComputedRef<(string | {
+            [x: string]: boolean;
+        })[]>;
+        liRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        tabIndex: import('vue').ComputedRef<0 | -1>;
+        handleFocus: () => void | undefined;
+        handleClick: (ev: Event) => void;
+        handleKeydown: (ev: KeyboardEvent) => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        click: (ev: Event) => true;
+    }, import('vue').PublicProps, {
+        disabled: boolean;
+        active: boolean;
+        uninjectContext: boolean;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        value: {
+            type: (StringConstructor | ObjectConstructor | NumberConstructor)[];
+        };
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        active: BooleanConstructor;
+        uninjectContext: BooleanConstructor;
+    }>> & Readonly<{
+        onClick?: ((ev: Event) => any) | undefined;
+    }>, {
+        className: {
+            block: string;
+            element: (className: string) => string;
+            modifier: (className: string) => string;
+            is: (className: string) => string;
+        };
+        cls: import('vue').ComputedRef<(string | {
+            [x: string]: boolean;
+        })[]>;
+        liRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        tabIndex: import('vue').ComputedRef<0 | -1>;
+        handleFocus: () => void | undefined;
+        handleClick: (ev: Event) => void;
+        handleKeydown: (ev: KeyboardEvent) => void;
+    }, {}, {}, {}, {
+        disabled: boolean;
+        active: boolean;
+        uninjectContext: boolean;
+    }> | undefined>;
     className: {
         block: string;
         element: (className: string) => string;
@@ -70,6 +213,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     };
     computedPopupVisible: import('vue').ComputedRef<boolean>;
     handlePopupVisibleChange: (visible: boolean) => void;
+    handleTriggerKeydown: (ev: KeyboardEvent) => void;
+    panelRef: import('vue').Ref<import('./context.ts').DropdownPanelRef | undefined, import('./context.ts').DropdownPanelRef | undefined>;
+    handleShow: () => void;
+    handleTriggerFocus: (ev: FocusEvent) => void;
+    handleClose: () => void;
+    handleKeyboardSelect: (ev: Event) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     'update:popupVisible': (visible: boolean) => true;
     /**
@@ -718,6 +867,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         install(app: import('vue').App): void;
     };
     DropdownPanel: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+        closeOnArrowLeft: BooleanConstructor;
         loading: {
             type: BooleanConstructor;
             default: boolean;
@@ -748,9 +898,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         })[]>;
         style: import('vue').ComputedRef<import('vue').CSSProperties | undefined>;
         wrapperRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        panelElement: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        handleKeydown: (ev: KeyboardEvent) => void;
         handleScroll: (e: Event) => void;
         t: (key: import('../../index.ts').LocaleKey | (string & {}), params?: Record<string, string | number>) => string;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("scroll" | "reachBottom")[], "scroll" | "reachBottom", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("close" | "scroll" | "reachBottom")[], "close" | "scroll" | "reachBottom", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+        closeOnArrowLeft: BooleanConstructor;
         loading: {
             type: BooleanConstructor;
             default: boolean;
@@ -770,10 +923,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: PropType<import('../../_hooks/_types.ts').EmitType<(ev: Event) => void>>;
         };
     }>> & Readonly<{
+        onClose?: ((...args: any[]) => any) | undefined;
         onScroll?: ((...args: any[]) => any) | undefined;
         onReachBottom?: ((...args: any[]) => any) | undefined;
     }>, {
         loading: boolean;
+        closeOnArrowLeft: boolean;
         isEmpty: boolean;
         bottomOffset: number;
     }, {}, {
@@ -1253,6 +1408,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             [x: string]: boolean;
         })[]>;
         liRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+        tabIndex: import('vue').ComputedRef<0 | -1>;
+        handleFocus: () => void | undefined;
         handleClick: (ev: Event) => void;
         handleKeydown: (ev: KeyboardEvent) => void;
     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {

package/dist/components/dropdown/context.d.ts

@@ -1,6 +1,19 @@
-import { InjectionKey } from 'vue';
+import { InjectionKey, Ref } from 'vue';
 export interface DropdownContext {
     popupMaxHeight: boolean | number;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 export declare const dropdownInjectionKey: InjectionKey<DropdownContext>;
+export interface DropdownMenuItem {
+    element: Ref<HTMLElement | undefined>;
+    disabled: Readonly<Ref<boolean>>;
+}
+export interface DropdownMenuContext {
+    activeItem: Ref<DropdownMenuItem | undefined>;
+    registerItem: (item: DropdownMenuItem) => () => void;
+    setActiveItem: (item: DropdownMenuItem) => void;
+}
+export interface DropdownPanelRef {
+    focus: (edge?: 'first' | 'last') => boolean;
+}
+export declare const dropdownMenuInjectionKey: InjectionKey<DropdownMenuContext>;

package/dist/components/dropdown/dropdown-panel.vue.d.ts

@@ -1,6 +1,7 @@
 import { CSSProperties, PropType } from 'vue';
 import { EmitType } from '../../_hooks/_types';
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    closeOnArrowLeft: BooleanConstructor;
     loading: {
         type: BooleanConstructor;
         default: boolean;
@@ -31,9 +32,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     })[]>;
     style: import('vue').ComputedRef<CSSProperties | undefined>;
     wrapperRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+    panelElement: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+    handleKeydown: (ev: KeyboardEvent) => void;
     handleScroll: (e: Event) => void;
     t: (key: import('../../locale').LocaleKey | (string & {}), params?: Record<string, string | number>) => string;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("scroll" | "reachBottom")[], "scroll" | "reachBottom", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("close" | "scroll" | "reachBottom")[], "close" | "scroll" | "reachBottom", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    closeOnArrowLeft: BooleanConstructor;
     loading: {
         type: BooleanConstructor;
         default: boolean;
@@ -53,10 +57,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: PropType<EmitType<(ev: Event) => void>>;
     };
 }>> & Readonly<{
+    onClose?: ((...args: any[]) => any) | undefined;
     onScroll?: ((...args: any[]) => any) | undefined;
     onReachBottom?: ((...args: any[]) => any) | undefined;
 }>, {
     loading: boolean;
+    closeOnArrowLeft: boolean;
     isEmpty: boolean;
     bottomOffset: number;
 }, {}, {