@whitesev/pops 2.3.3 → 2.3.5

package/dist/types/src/Pops.d.ts

@@ -112,9 +112,9 @@ declare class Pops {
             height(element: HTMLElement | string | Window | Document | typeof globalThis, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
             outerWidth(element: HTMLElement | string | Window | Document, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
             outerHeight(element: HTMLElement | string | Window, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
-            addClassName(element: Element | undefined | null, className: string): void;
-            removeClassName(element: Element | undefined | null, className: string): void;
-            containsClassName(element: HTMLElement | undefined | null, className: string): boolean;
+            addClassName($el: Element | undefined | null, className: string): void;
+            removeClassName($el: Element | undefined | null, className: string): void;
+            containsClassName($el: HTMLElement | undefined | null, className: string): boolean;
             css(element: HTMLElement | string, property: keyof CSSStyleDeclaration): string;
             css(element: HTMLElement | string, property: string): string;
             css(element: HTMLElement | string, property: keyof CSSStyleDeclaration & string, value: string | number): string;
@@ -147,6 +147,10 @@ declare class Pops {
                 getDarkColor: (color: string, level: number) => string;
                 getLightColor: (color: string, level: number) => string;
             };
+            getTransform(element: HTMLElement): {
+                transformLeft: number;
+                transformTop: number;
+            };
             on<T extends import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: T | T[], callback: (this: HTMLElement, event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event[T]) => void, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): void;
             on<T extends Event>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: string | string[], callback: (this: HTMLElement, event: T) => void, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): void;
             on<T extends import("./types/PopsDOMUtilsEventType").PopsDOMUtils_EventType>(element: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsElementEventType, eventType: T | T[], selector: string | string[] | undefined | null, callback: (this: HTMLElement, event: import("./types/PopsDOMUtilsEventType").PopsDOMUtils_Event[T], selectorTarget: HTMLElement) => void, option?: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsEventListenerOption | boolean): void;
@@ -21408,13 +21412,14 @@ declare class Pops {
         $data: {
             isEmpty: boolean;
         };
-        init(parentElement?: HTMLElement): void;
         initEl(): void;
-        getSearchSelectElement(): HTMLDivElement;
+        init(parentElement?: HTMLElement): void;
+        getData(): any[];
+        createSearchSelectElement(): HTMLDivElement;
         getDynamicCSS(): string;
-        getSearchItemLiElement(data: any, index: number): HTMLLIElement;
+        createSearchItemLiElement(data: any, index: number): HTMLLIElement;
         getItemDataValue(data: any): any;
-        setSearchItemClickEvent(liElement: HTMLLIElement): void;
+        setSearchItemClickEvent($searchItem: HTMLLIElement): void;
         setSearchItemSelectEvent(liElement: HTMLLIElement): void;
         setInputChangeEvent(option?: AddEventListenerOptions): void;
         removeInputChangeEvent(option?: AddEventListenerOptions): void;
@@ -21433,9 +21438,10 @@ declare class Pops {
         changeHintULElementPosition(target?: HTMLElement): void;
         changeHintULElementWidth(target?: HTMLElement): void;
         updateDynamicCSS(): void;
+        updateStyleSheet(): void;
         update(data?: any[]): void;
         clear(): void;
-        hide(): void;
+        hide(useAnimationToHide?: boolean): void;
         show(): void;
     };
 }

package/dist/types/src/components/searchSuggestion/index.d.ts

@@ -17,16 +17,20 @@ export declare const PopsSearchSuggestion: {
             /** 是否结果为空 */
             isEmpty: boolean;
         };
+        /** 初始化元素变量 */
+        initEl(): void;
         /**
          * 初始化
          */
         init(parentElement?: HTMLElement): void;
-        /** 初始化元素变量 */
-        initEl(): void;
+        /**
+         * 获取数据
+         */
+        getData(): any[];
         /**
          * 获取显示出搜索建议框的html
          */
-        getSearchSelectElement(): HTMLDivElement;
+        createSearchSelectElement(): HTMLDivElement;
         /** 动态获取CSS */
         getDynamicCSS(): string;
         /**
@@ -34,7 +38,7 @@ export declare const PopsSearchSuggestion: {
          * @param data 当前项的值
          * @param index 当前项的下标
          */
-        getSearchItemLiElement(data: any, index: number): HTMLLIElement;
+        createSearchItemLiElement(data: any, index: number): HTMLLIElement;
         /**
          * 获取data-value值
          * @param data
@@ -42,9 +46,9 @@ export declare const PopsSearchSuggestion: {
         getItemDataValue(data: any): any;
         /**
          * 设置搜索建议框每一项的点击事件
-         * @param liElement
+         * @param $searchItem
          */
-        setSearchItemClickEvent(liElement: HTMLLIElement): void;
+        setSearchItemClickEvent($searchItem: HTMLLIElement): void;
         /**
          * 设置搜索建议框每一项的选中事件
          * @param liElement
@@ -121,6 +125,10 @@ export declare const PopsSearchSuggestion: {
          * 动态更新CSS
          */
         updateDynamicCSS(): void;
+        /**
+         * 数据项的数量改变时调用
+         */
+        updateStyleSheet(): void;
         /**
          * 更新页面显示的搜索结果
          * @param data
@@ -132,8 +140,9 @@ export declare const PopsSearchSuggestion: {
         clear(): void;
         /**
          * 隐藏搜索建议框
+         * @param useAnimationToHide 是否使用动画隐藏
          */
-        hide(): void;
+        hide(useAnimationToHide?: boolean): void;
         /**
          * 显示搜索建议框
          */

package/dist/types/src/components/searchSuggestion/types/index.d.ts

@@ -33,7 +33,7 @@ export interface PopsSearchSuggestionDetails<T = any> extends Pick<PopsCommonCon
         /**
          * 点击回调
          */
-        callback?: (event: MouseEvent | PointerEvent, liElement: HTMLLIElement, data: T) => void;
+        callback?: (event: MouseEvent | PointerEvent, $dataItem: HTMLLIElement, dataItem: T) => void;
     };
     /**
      * 自定义的className
@@ -46,9 +46,19 @@ export interface PopsSearchSuggestionDetails<T = any> extends Pick<PopsCommonCon
     isAbsolute?: boolean;
     /**
      * 是否启用动画
-     * @default true
+     * @default false
      */
     isAnimation?: boolean;
+    /**
+     * 是否启用折叠动画
+     * @default true
+     */
+    useFoldAnimation?: boolean;
+    /**
+     * 是否启用箭头
+     * @default false
+     */
+    useArrow?: boolean;
     /**
      * 建议框的宽度
      * @default "250px"
@@ -110,24 +120,25 @@ export interface PopsSearchSuggestionDetails<T = any> extends Pick<PopsCommonCon
      *
      * 它的父元素是一个<li>标签
      */
-    getItemHTML: (item: T) => string;
+    getItemHTML: (dataItem: T) => string;
     /**
      * 当config.target触发input时自动调用该函数来获取数据
      * @param inputValue 当前输入框的值
+     * @param data 当前数据
      */
-    getData?: (inputValue: string) => Promise<T[]> | T[];
+    getData?: (inputValue: string, data: T[]) => Promise<T[]> | T[];
     /**
      * 每一项的点击回调
      * @param event 触发的事件
-     * @param liElement 每一项的元素
-     * @param data config.data的数据
+     * @param $dataItem 每一项的元素
+     * @param dataItem config.data的点击项的值
      */
-    itemClickCallBack?: (event: MouseEvent | PointerEvent, liElement: HTMLLIElement, data: T) => void;
+    itemClickCallBack?: (event: MouseEvent | PointerEvent, $dataItem: HTMLLIElement, dataItem: T) => void;
     /**
      * 键盘的上下键选择的回调
      * @param event 触发的事件
-     * @param liElement 每一项的元素
-     * @param data config.data的数据
+     * @param $dataItem 每一项的元素
+     * @param dataItem config.data的选中项的值
      */
-    selectCallBack?: (event: MouseEvent, liElement: HTMLLIElement, data: T) => void;
+    selectCallBack?: (event: MouseEvent, $dataItem: HTMLLIElement, dataItem: T) => void;
 }

package/dist/types/src/utils/PopsDOMUtils.d.ts

@@ -499,22 +499,22 @@ declare class PopsDOMUtils extends PopsDOMUtilsEvent {
     outerHeight(element: HTMLElement | string | Window, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
     /**
      * 添加className
-     * @param element 目标元素
+     * @param $el 目标元素
      * @param className className属性
      */
-    addClassName(element: Element | undefined | null, className: string): void;
+    addClassName($el: Element | undefined | null, className: string): void;
     /**
      * 删除className
-     * @param element 目标元素
+     * @param $el 目标元素
      * @param className className属性
      */
-    removeClassName(element: Element | undefined | null, className: string): void;
+    removeClassName($el: Element | undefined | null, className: string): void;
     /**
      * 判断元素是否包含某个className
-     * @param element 目标元素
+     * @param $el 目标元素
      * @param className className属性
      */
-    containsClassName(element: HTMLElement | undefined | null, className: string): boolean;
+    containsClassName($el: HTMLElement | undefined | null, className: string): boolean;
     /**
      * 获取元素的样式属性值
      * @param element 目标元素
@@ -742,6 +742,14 @@ declare class PopsDOMUtils extends PopsDOMUtilsEvent {
         getDarkColor: (color: string, level: number) => string;
         getLightColor: (color: string, level: number) => string;
     };
+    /**
+     * 获取移动元素的transform偏移
+     * @param element 元素
+     */
+    getTransform(element: HTMLElement): {
+        transformLeft: number;
+        transformTop: number;
+    };
 }
 declare const popsDOMUtils: PopsDOMUtils;
 export { popsDOMUtils };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesev/pops",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "description": "弹窗库",
   "type": "module",
   "homepage": "https://github.com/WhiteSevs/TamperMonkeyScript/tree/master/lib/pops#readme",