@whitesev/pops 3.3.4 → 3.3.5

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

@@ -37,16 +37,16 @@ declare class Pops {
         };
         /** icon图标的svg代码 */
         iconSVG: {
-            loading: string;
             min: string;
-            max: string;
-            search: string;
             mise: string;
+            max: string;
             close: string;
             edit: string;
             share: string;
             delete: string;
+            search: string;
             upload: string;
+            loading: string;
             next: string;
             prev: string;
             eleme: string;
@@ -72,14 +72,14 @@ declare class Pops {
         };
         /** 存储已创建的元素 */
         instData: {
-            iframe: import("./types/inst").PopsInstGeneralConfig[];
-            folder: import("./types/inst").PopsInstGeneralConfig[];
             loading: import("./types/inst").PopsInstGeneralConfig[];
             alert: import("./types/inst").PopsInstGeneralConfig[];
             confirm: import("./types/inst").PopsInstGeneralConfig[];
             prompt: import("./types/inst").PopsInstGeneralConfig[];
+            iframe: import("./types/inst").PopsInstGeneralConfig[];
             tooltip: import("./types/inst").PopsInstGeneralConfig[];
             drawer: import("./types/inst").PopsInstGeneralConfig[];
+            folder: import("./types/inst").PopsInstGeneralConfig[];
             panel: import("./types/inst").PopsInstGeneralConfig[];
             rightClickMenu: import("./types/inst").PopsInstGeneralConfig[];
         };
@@ -726,6 +726,7 @@ declare class Pops {
             forbiddenScroll?: boolean | undefined;
             lightStyle?: string | undefined;
             darkStyle?: string | undefined;
+            stopKeyDownEventPropagation?: boolean | undefined;
             beforeAppendToPageCallBack?: void;
             drag?: boolean | undefined;
             dragLimit?: boolean | undefined;
@@ -788,16 +789,16 @@ declare class Pops {
             showArrow: boolean;
             arrowDistance: number;
             otherDistance: number;
-            useShadowRoot: boolean;
-            only: boolean;
             zIndex: IFunction<number>;
             style: string | null;
+            useShadowRoot: boolean;
+            only: boolean;
             lightStyle: string | null;
             darkStyle: string | null;
             beforeAppendToPageCallBack: ($shadowRoot: ShadowRoot | HTMLElement, $shadowContainer: HTMLDivElement) => void;
         };
         $shadowContainer: HTMLDivElement;
-        $shadowRoot: HTMLDivElement | ShadowRoot;
+        $shadowRoot: ShadowRoot | HTMLElement;
         toolTip: import("./components/tooltip").ToolTip;
     };
     /**
@@ -817,9 +818,9 @@ declare class Pops {
     panel: (config: PopsPanelConfig) => {
         addEventListener: <K extends keyof import("./components/panel/types").PopsPanelEventType>(event: K, listener: (evt: CustomEvent<import("./components/panel/types").PopsPanelEventType[K]>) => void, options?: boolean | EventListenerOptions) => void;
         removeEventListener: <K extends keyof import("./components/panel/types").PopsPanelEventType>(event: K, listener: (evt: CustomEvent<import("./components/panel/types").PopsPanelEventType[K]>) => void, options?: boolean | EventListenerOptions) => void;
-        mode: import("./types/main").PopsType;
         close: () => Promise<void>;
         hide: () => Promise<void>;
+        mode: import("./types/main").PopsType;
         show: ($parent?: HTMLElement | Document | ShadowRoot) => Promise<void>;
         $shadowContainer: HTMLDivElement;
         $shadowRoot: ShadowRoot | HTMLElement;
@@ -907,7 +908,7 @@ declare class Pops {
      * searchSuggestion.setAllEvent();
      */
     searchSuggestion: <T = any>(config: PopsSearchSuggestionConfig<T>) => {
-        selfDocument: Document | ShadowRoot | (Document | ShadowRoot)[];
+        selfDocument: ShadowRoot | Document | (ShadowRoot | Document)[];
         $el: {
             root: HTMLElement;
             $dropdownWrapper: HTMLElement;

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

@@ -4,8 +4,12 @@ import type { PopsTitleConfig, PopsDragConfig, PopsGeneralConfig, PopsMoreButton
  */
 export type PopsFolderDownloadOption = {
     /**
+     *
+     * 前置条件：url不为空
+     *
      * 下载方式，不传入就不下载（不做任何处理）
      *
+     *
      * + `a`: 使用`a标签`进行下载
      * + `aBlank`: 使用`a标签`进行下载（添加属性`target="_blank"`）
      * + `iframe`: 使用`iframe`进行下载

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

@@ -213,7 +213,7 @@ export declare const PopsTooltip: {
             beforeAppendToPageCallBack: ($shadowRoot: ShadowRoot | HTMLElement, $shadowContainer: HTMLDivElement) => void;
         };
         $shadowContainer: HTMLDivElement;
-        $shadowRoot: HTMLDivElement | ShadowRoot;
+        $shadowRoot: HTMLElement | ShadowRoot;
         toolTip: ToolTip;
     };
 };

package/dist/types/src/config/GlobalConfig.d.ts

@@ -27,6 +27,7 @@ export declare const GlobalConfig: {
         forbiddenScroll?: boolean | undefined;
         lightStyle?: string | undefined;
         darkStyle?: string | undefined;
+        stopKeyDownEventPropagation?: boolean | undefined;
         beforeAppendToPageCallBack?: void;
         drag?: boolean | undefined;
         dragLimit?: boolean | undefined;

package/dist/types/src/handler/PopsHandler.d.ts

@@ -14,12 +14,9 @@ export declare const PopsHandler: {
     /**
      * 创建shadow
      */
-    handlerShadow(config: Pick<PopsGeneralConfig, "useShadowRoot">): {
+    handlerShadow(config: Pick<PopsGeneralConfig, "useShadowRoot" | "stopKeyDownEventPropagation">): {
         $shadowContainer: HTMLDivElement;
-        $shadowRoot: ShadowRoot;
-    } | {
-        $shadowContainer: HTMLDivElement;
-        $shadowRoot: HTMLDivElement;
+        $shadowRoot: HTMLElement | ShadowRoot;
     };
     /**
      * 处理初始化

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

@@ -214,6 +214,13 @@ export interface PopsGeneralConfig {
    * 传入的css都在dark内
    */
   darkStyle?: string | null;
+  /**
+   * （可选）是否阻止`keydown`事件传播
+   *
+   * 主要是阻止当`keydown`触发来源为输入框时，即在输入框内按下按键不会触发页面的快捷键
+   * @default true
+   */
+  stopKeyDownEventPropagation?: boolean;
   /**
    * 在元素添加到页面前的事件
    * @param $shadowRoot 根元素

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesev/pops",
-  "version": "3.3.4",
+  "version": "3.3.5",
   "description": "弹窗库，包含了alert、confirm、prompt、drawer、folder、loading、iframe、panel、tooltip、searchSuggestion、rightClickMenu组件",
   "keywords": [
     "ScriptCat",

package/src/components/alert/defaultConfig.ts

@@ -60,5 +60,6 @@ export const PopsAlertDefaultConfig = (): DeepRequired<PopsAlertConfig> => {
     lightStyle: null,
     darkStyle: null,
     beforeAppendToPageCallBack() {},
+    stopKeyDownEventPropagation: true,
   } as DeepRequired<PopsAlertConfig>;
 };

package/src/components/confirm/defaultConfig.ts

@@ -88,5 +88,6 @@ export const PopsConfirmDefaultConfig = (): DeepRequired<PopsConfirmConfig> => {
     lightStyle: null,
     darkStyle: null,
     beforeAppendToPageCallBack() {},
+    stopKeyDownEventPropagation: true,
   } as DeepRequired<PopsConfirmConfig>;
 };

package/src/components/drawer/defaultConfig.ts

@@ -87,5 +87,6 @@ export const PopsDrawerDefaultConfig = (): DeepRequired<PopsDrawerConfig> => {
     darkStyle: null,
     beforeAppendToPageCallBack() {},
     forbiddenScroll: false,
+    stopKeyDownEventPropagation: true,
   };
 };

package/src/components/folder/defaultConfig.ts

@@ -149,5 +149,6 @@ export const PopsFolderDefaultConfig = (): DeepRequired<PopsFolderConfig> => {
     lightStyle: null,
     darkStyle: null,
     beforeAppendToPageCallBack() {},
+    stopKeyDownEventPropagation: true,
   };
 };

package/src/components/folder/types/index.ts

@@ -10,8 +10,12 @@ import type {
  */
 export type PopsFolderDownloadOption = {
   /**
+   *
+   * 前置条件：url不为空
+   *
    * 下载方式，不传入就不下载（不做任何处理）
    *
+   *
    * + `a`: 使用`a标签`进行下载
    * + `aBlank`: 使用`a标签`进行下载（添加属性`target="_blank"`）
    * + `iframe`: 使用`iframe`进行下载

package/src/components/iframe/defaultConfig.ts

@@ -58,5 +58,6 @@ export const PopsIframeDefaultConfig = (): DeepRequired<PopsIframeConfig> => {
     lightStyle: null,
     darkStyle: null,
     beforeAppendToPageCallBack() {},
+    stopKeyDownEventPropagation: true,
   };
 };

package/src/components/loading/defaultConfig.ts

@@ -27,5 +27,6 @@ export const PopsLoadingDefaultConfig = (): DeepRequired<PopsLoadingConfig> => {
     lightStyle: null,
     darkStyle: null,
     addIndexCSS: true,
+    stopKeyDownEventPropagation: true,
   };
 };

package/src/components/panel/defaultConfig.ts

@@ -866,5 +866,6 @@ export const PopsPanelDefaultConfig = (): DeepRequired<PopsPanelConfig> => {
     lightStyle: null,
     darkStyle: null,
     beforeAppendToPageCallBack() {},
+    stopKeyDownEventPropagation: true,
   };
 };

package/src/components/prompt/defaultConfig.ts

@@ -92,5 +92,6 @@ export const PopsPromptDefaultConfig = (): DeepRequired<PopsPromptConfig> => {
     lightStyle: null,
     darkStyle: null,
     beforeAppendToPageCallBack() {},
+    stopKeyDownEventPropagation: true,
   };
 };

package/src/handler/PopsHandler.ts

@@ -21,22 +21,46 @@ export const PopsHandler = {
   /**
    * 创建shadow
    */
-  handlerShadow(config: Pick<PopsGeneralConfig, "useShadowRoot">) {
+  handlerShadow(config: Pick<PopsGeneralConfig, "useShadowRoot" | "stopKeyDownEventPropagation">) {
     const $shadowContainer = popsDOMUtils.createElement("div", {
       className: "pops-shadow-container",
     });
+    let $shadowRoot: ShadowRoot | HTMLElement;
     if (config.useShadowRoot) {
-      const $shadowRoot = $shadowContainer.attachShadow({ mode: "open" });
-      return {
-        $shadowContainer,
-        $shadowRoot,
-      };
+      $shadowRoot = $shadowContainer.attachShadow({ mode: "open" });
     } else {
-      return {
-        $shadowContainer,
-        $shadowRoot: $shadowContainer,
-      };
+      $shadowRoot = $shadowContainer;
     }
+    // 添加键盘监听
+    // rightClickMenu
+    // searchSuggestion
+    // tooltip
+    // 以上都不需要添加该事件监听
+    if (config.stopKeyDownEventPropagation) {
+      popsDOMUtils.on(
+        $shadowRoot,
+        "keydown",
+        [
+          'input[type="text"]',
+          'input[type="password"]',
+          'input[type="number"]',
+          'input[type="email"]',
+          'input[type="url"]',
+          'input[type="search"]',
+          "input:not([type])",
+          "textarea",
+        ],
+        (evt) => {
+          evt.stopImmediatePropagation();
+          evt.stopPropagation();
+        },
+        { capture: true }
+      );
+    }
+    return {
+      $shadowContainer,
+      $shadowRoot,
+    };
   },
   /**
    * 处理初始化

package/src/types/components.d.ts

@@ -214,6 +214,13 @@ export interface PopsGeneralConfig {
    * 传入的css都在dark内
    */
   darkStyle?: string | null;
+  /**
+   * （可选）是否阻止`keydown`事件传播
+   *
+   * 主要是阻止当`keydown`触发来源为输入框时，即在输入框内按下按键不会触发页面的快捷键
+   * @default true
+   */
+  stopKeyDownEventPropagation?: boolean;
   /**
    * 在元素添加到页面前的事件
    * @param $shadowRoot 根元素