knight-ui 1.1.7 → 1.1.8

package/component/display/Modal.d.ts

@@ -7,6 +7,16 @@ export declare class Modal extends AbstractUI<ModalProps, ModalState> {
     private zIndex;
     private animTimer;
     private escHandler;
+    /** 本次打开是否加了 body 滚动锁 —— 容器模式下不加, 清理时必须成对判断 */
+    private scrollLocked;
+    /**
+     * 解析 getPopupContainer 指定的挂载容器。
+     *
+     * 返回 null 表示"照旧挂到 body、按视口定位": 没传 getPopupContainer、或回调返回空
+     * (容器还没挂上)都走这条路。绝不把"没拿到容器"当成"容器模式" —— 那样会渲染出一个
+     * position:absolute 却仍挂在 body 上的弹窗, top:50% 变成相对整页, 直接跑出视野。
+     */
+    private get popupContainer();
     constructor(props: ModalProps);
     componentDidMount(): void;
     componentDidUpdate(prevProps: Readonly<ModalProps>): void;
@@ -35,6 +45,12 @@ export interface ModalProps extends UIProps {
     size?: "small" | "medium" | "large";
     onOk?: () => void | Promise<void>;
     onCancel?: () => void;
+    /**
+     * 指定挂载容器。传了就渲染到该容器内, 并把定位从视口(fixed/vw/vh)切成容器
+     * (absolute/%), 同时不再锁 body 滚动 —— 用于把对话框嵌进一个局部区域。
+     * 不传时行为与从前完全一致(挂 body + fixed)。
+     */
+    getPopupContainer?: () => HTMLElement;
 }
 interface ModalState extends UIState {
     animPhase: ModalAnimPhase;

package/component/display/SideSheet.d.ts

@@ -8,6 +8,16 @@ export declare class SideSheet extends AbstractUI<SideSheetProps, SideSheetState
     private zIndex;
     private animTimer;
     private escHandler;
+    /** 本次打开是否加了 body 滚动锁 —— 容器模式下不加, 清理时必须成对判断 */
+    private scrollLocked;
+    /**
+     * 解析 getPopupContainer 指定的挂载容器。
+     *
+     * 返回 null 表示"照旧挂到 body、按视口定位": 没传 getPopupContainer、或回调返回空
+     * (容器还没挂上)都走这条路。绝不把"没拿到容器"当成"容器模式" —— 那样会渲染出一个
+     * position:absolute 却仍挂在 body 上的抽屉, 它靠 top:0/bottom:0 张开, 会直接铺满整页。
+     */
+    private get popupContainer();
     constructor(props: SideSheetProps);
     componentDidMount(): void;
     componentDidUpdate(prevProps: Readonly<SideSheetProps>): void;
@@ -32,6 +42,11 @@ export interface SideSheetProps extends UIProps {
     onCancel?: () => void;
     afterClose?: () => void;
     keepDOM?: boolean;
+    /**
+     * 指定挂载容器。传了就渲染到该容器内, 并把定位从视口(fixed/vw)切成容器
+     * (absolute/%), 同时不再锁 body 滚动 —— 用于把抽屉嵌进一个局部区域。
+     * 不传时行为与从前完全一致(挂 body + fixed)。
+     */
     getPopupContainer?: () => HTMLElement;
 }
 interface SideSheetState extends UIState {

package/component/display/Table.d.ts

@@ -8,7 +8,8 @@ export interface TableColumn {
     key: string;
     title: React.ReactNode;
     dataIndex?: string;
-    width?: number;
+    /** 列宽。数字按 px; 字符串原样交给 CSS 的 width(如 "18%") —— 表是 tableLayout:fixed, 百分比直接生效 */
+    width?: number | string;
     render?: (value: any, record: Record<string, any>, index: number) => React.ReactNode;
     /**
      * 排序比较函数。给了就在表头出排序按钮。
@@ -82,6 +83,11 @@ export interface TableProps extends UIProps {
     selectedRowKeys?: (string | number)[];
     defaultSelectedRowKeys?: (string | number)[];
     onRowSelectionChange?: (selectedRowKeys: (string | number)[]) => void;
+    /**
+     * 行级属性钩子(antd 同款形状): 返回值展开到该行的 <tr> 上, 可用来挂 onClick / title / data-*。
+     * 返回值里的 className 会与行自身的类合并(不是替换), 所以 ku-table-row 的底色不会丢。
+     */
+    onRow?: (record: Record<string, any>, index: number) => React.HTMLAttributes<HTMLTableRowElement>;
     /** 表头排序/筛选发生变化时回调(服务端分页时可据此重新取数) */
     onChange?: (sorter: TableSorter, filters: Record<string, string[]>) => void;
 }

package/component/input/Form.d.ts

@@ -54,6 +54,8 @@ export interface FormApi {
     getValues: () => Record<string, any>;
     setValues: (values: Record<string, any>) => void;
     validate: () => Promise<Record<string, any> | null>;
+    /** 校验并提交: 通过才触发 onSubmit, 否则触发 onSubmitFail。validate() 是纯查询, 不会碰 onSubmit */
+    submit: () => Promise<Record<string, any> | null>;
     reset: () => void;
     setError: (field: string, error: string | null) => void;
     /** 动态添加字段(若已存在则更新) */
@@ -92,6 +94,14 @@ export declare class Form extends AbstractUI<FormProps, FormState> {
     private setFieldValue;
     private setFieldsValue;
     private validate;
+    /**
+     * 校验并提交: 通过才触发 onSubmit, 否则触发 onSubmitFail。
+     *
+     * validate() 是**纯查询**, 只返回结果 —— 它从前会在成功时顺手调一次 onSubmit, 于是
+     * "拿 validate() 当确认按钮的扳机"与"在 onSubmit 里落库"会叠成提交两次。要老行为的
+     * 调用方改用 submit()。
+     */
+    private submit;
     private reset;
     private setError;
     protected OnRenderContent(): React.ReactElement;
@@ -111,6 +121,11 @@ export interface FormProps extends UIProps {
     onSubmit?: (values: Record<string, any>) => void;
     /** 提交失败回调 */
     onSubmitFail?: (values: Record<string, any>) => void;
+    /**
+     * 字段值变化回调 —— 非受控模型下唯一能感知"值变了"的信号(脏检查 / 自动保存门控)。
+     * 在字段值写回之后触发, 第三个参数是当前全部已注册字段的值的快照。
+     */
+    onValuesChange?: (field: string, value: any, values: Record<string, any>) => void;
 }
 interface FormState extends UIState {
     validating: boolean;

package/component/internal/Mask.d.ts

@@ -34,8 +34,11 @@ export declare class Mask {
      * @param opacity 透明度(0-1),浮层组件根据动画状态传入
      * @param onClick 点击遮罩回调
      * @param duration 过渡时长(ms)
+     * @param position 定位方式。视口模式传 "fixed"(默认); 浮层被渲染进某个局部容器时
+     *                 必须传 "absolute" —— fixed 会相对视口铺满整屏, 把容器外的内容
+     *                 也一起蒙上, 与"对话框嵌在容器里"这件事自相矛盾。
      */
-    static render(zIndex: number, opacity: number, onClick?: () => void, duration?: number): React.ReactElement;
+    static render(zIndex: number, opacity: number, onClick?: () => void, duration?: number, position?: "fixed" | "absolute"): React.ReactElement;
     /**
      * 带"洞"的遮罩 —— rect 那一块不被遮住, 用于 UserGuide 高亮目标。
      *