@whitesev/pops 3.2.1 → 3.3.0

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

@@ -1,121 +1,123 @@
-import type { PopsGeneralConfig } from "../../../types/components";
-import type { PopsPanelGeneralConfig } from "../../panel/types/components-common";
-
-/** tooltip的出现位置 */
-export type PopsTooltipPosition = "top" | "right" | "bottom" | "left" | "follow";
-
-/**
- * pops.tooltip
- */
-export interface PopsToolTipConfig
-  extends Pick<PopsGeneralConfig, "useShadowRoot" | "only" | "zIndex" | "style" | "beforeAppendToPageCallBack"> {
-  /**
-   * 目标元素
-   */
-  $target: HTMLElement;
-  /**
-   * 显示的文字
-   */
-  content: string | (() => string);
-  /**
-   * 是否比较获取到的`content`的内容是否改变
-   *
-   * 如果未改变，则在触发`.show`时不修改内容
-   * @default false
-   */
-  isDiffContent?: boolean;
-  /**
-   * 位置
-   * + `follow` 跟随（鼠标|触摸）的位置而移动
-   * @default "top"
-   */
-  position?: PopsTooltipPosition;
-  /**
-   * 自定义className
-   *
-   * + `github-tooltip`：github的样式
-   * @default ""
-   */
-  className?: PopsPanelGeneralConfig<any>["className"];
-  /**
-   * 是否使用`fixed`定位，`false`则是`absolute`定位
-   * @default false
-   */
-  isFixed?: boolean;
-  /**
-   * 是否总是显示，默认为false
-   * + true 设置的`onShowEventName`、`onCloseEventName`将无效
-   *        返回提供`show`和`close`函数，取消`on`和`off`
-   * + false 事件触发才显示
-   */
-  alwaysShow?: boolean;
-  /**
-   * 延迟xxms关闭tooltip
-   * @default 100
-   */
-  delayCloseTime?: number;
-  /**
-   * 触发显示事件的名称，默认`mouseenter`、`touchstart`，如果是多个事件，按空格分割
-   *
-   * 如果`position`为`follow`，则添加`mousemove`、`touchmove`事件监听
-   * @default  "mouseenter touchstart"
-   */
-  onShowEventName?: string;
-  /**
-   * 触发关闭事件的名称，默认`mouseleave`、`touchend`、`touchcancel`，如果是多个事件，按空格分割
-   * @default  "mouseleave touchend touchcancel"
-   */
-  onCloseEventName?: string;
-  /**
-   * 监听的事件配置
-   */
-  eventOption?: {
-    once?: boolean;
-    passive?: boolean;
-    capture?: boolean;
-  };
-  /**
-   * 触发显示前的回调
-   * @returns
-   * + false 可阻止显示
-   */
-  showBeforeCallBack?: ($toolTip: HTMLElement) => false | void;
-  /**
-   * 触发显示后的回调
-   */
-  showAfterCallBack?: ($toolTip: HTMLElement) => void;
-  /**
-   * 触发关闭前的回调
-   */
-  closeBeforeCallBack?: (
-    /**
-     *
-     * @returns
-     * + false 可阻止关闭
-     */
-    $toolTip: HTMLElement
-  ) => false | void;
-  /**
-   * 触发关闭后的回调
-   */
-  closeAfterCallBack?: ($toolTip: HTMLElement) => void;
-  /**
-   * 是否显示箭头
-   * @default true
-   */
-  showArrow?: boolean;
-  /**
-   * 箭头与目标的的距离(px)
-   *
-   * @default 12.5
-   */
-  arrowDistance?: number;
-  /**
-   * 其它的距离(px)
-   * + 当`position`为`left`或者`right`，这个距离是上、下距离
-   * + 当`position`为`top`或者`bottom`，这个距离是左、右距离
-   * + 当`position`为`follow`，这个距离是上、左距离
-   * @default 0
-   */
-  otherDistance?: number;
-}
+import type { PopsGeneralConfig } from "../../../types/components";
+import type { PopsPanelGeneralConfig } from "../../panel/types/components-common";
+
+/** tooltip的出现位置 */
+export type PopsTooltipPosition = "top" | "right" | "bottom" | "left" | "follow";
+
+/**
+ * pops.tooltip
+ */
+export interface PopsToolTipConfig extends Pick<
+  PopsGeneralConfig,
+  "useShadowRoot" | "only" | "zIndex" | "style" | "beforeAppendToPageCallBack"
+> {
+  /**
+   * 目标元素
+   */
+  $target: HTMLElement;
+  /**
+   * 显示的文字
+   */
+  content: string | (() => string);
+  /**
+   * 是否比较获取到的`content`的内容是否改变
+   *
+   * 如果未改变，则在触发`.show`时不修改内容
+   * @default false
+   */
+  isDiffContent?: boolean;
+  /**
+   * 位置
+   * + `follow` 跟随（鼠标|触摸）的位置而移动
+   * @default "top"
+   */
+  position?: PopsTooltipPosition;
+  /**
+   * 自定义className
+   *
+   * + `github-tooltip`：github的样式
+   * @default ""
+   */
+  className?: PopsPanelGeneralConfig<any>["className"];
+  /**
+   * 是否使用`fixed`定位，`false`则是`absolute`定位
+   * @default false
+   */
+  isFixed?: boolean;
+  /**
+   * 是否总是显示，默认为false
+   * + true 设置的`onShowEventName`、`onCloseEventName`将无效
+   *        返回提供`show`和`close`函数，取消`on`和`off`
+   * + false 事件触发才显示
+   */
+  alwaysShow?: boolean;
+  /**
+   * 延迟xxms关闭tooltip
+   * @default 100
+   */
+  delayCloseTime?: number;
+  /**
+   * 触发显示事件的名称，默认`mouseenter`、`touchstart`，如果是多个事件，按空格分割
+   *
+   * 如果`position`为`follow`，则添加`mousemove`、`touchmove`事件监听
+   * @default  "mouseenter touchstart"
+   */
+  onShowEventName?: string;
+  /**
+   * 触发关闭事件的名称，默认`mouseleave`、`touchend`、`touchcancel`，如果是多个事件，按空格分割
+   * @default  "mouseleave touchend touchcancel"
+   */
+  onCloseEventName?: string;
+  /**
+   * 监听的事件配置
+   */
+  eventOption?: {
+    once?: boolean;
+    passive?: boolean;
+    capture?: boolean;
+  };
+  /**
+   * 触发显示前的回调
+   * @returns
+   * + false 可阻止显示
+   */
+  showBeforeCallBack?: ($toolTip: HTMLElement) => false | void;
+  /**
+   * 触发显示后的回调
+   */
+  showAfterCallBack?: ($toolTip: HTMLElement) => void;
+  /**
+   * 触发关闭前的回调
+   */
+  closeBeforeCallBack?: (
+    /**
+     *
+     * @returns
+     * + false 可阻止关闭
+     */
+    $toolTip: HTMLElement
+  ) => false | void;
+  /**
+   * 触发关闭后的回调
+   */
+  closeAfterCallBack?: ($toolTip: HTMLElement) => void;
+  /**
+   * 是否显示箭头
+   * @default true
+   */
+  showArrow?: boolean;
+  /**
+   * 箭头与目标的的距离(px)
+   *
+   * @default 12.5
+   */
+  arrowDistance?: number;
+  /**
+   * 其它的距离(px)
+   * + 当`position`为`left`或者`right`，这个距离是上、下距离
+   * + 当`position`为`top`或者`bottom`，这个距离是左、右距离
+   * + 当`position`为`follow`，这个距离是上、左距离
+   * @default 0
+   */
+  otherDistance?: number;
+}

package/src/config/CommonCSSClassName.ts

@@ -1,17 +1,17 @@
-/**
- * 通用的CSS类名
- */
-export const PopsCommonCSSClassName = {
-  flexCenter: "pops-flex-items-center",
-  flexYCenter: "pops-flex-y-center",
-  flexXCenter: "pops-flex-x-center",
-  hide: "pops-hide",
-  hideImportant: "pops-hide-important",
-  noBorder: "pops-no-border",
-  noBorderImportant: "pops-no-border-important",
-  userSelectNone: "pops-user-select-none",
-  lineHeightCenter: "pops-line-height-center",
-  widthFill: "pops-width-fill",
-  textIsDisabled: "pops-text-is-disabled",
-  textIsDisabledImportant: "pops-text-is-disabled-important",
-};
+/**
+ * 通用的CSS类名
+ */
+export const PopsCommonCSSClassName = {
+  flexCenter: "pops-flex-items-center",
+  flexYCenter: "pops-flex-y-center",
+  flexXCenter: "pops-flex-x-center",
+  hide: "pops-hide",
+  hideImportant: "pops-hide-important",
+  noBorder: "pops-no-border",
+  noBorderImportant: "pops-no-border-important",
+  userSelectNone: "pops-user-select-none",
+  lineHeightCenter: "pops-line-height-center",
+  widthFill: "pops-width-fill",
+  textIsDisabled: "pops-text-is-disabled",
+  textIsDisabledImportant: "pops-text-is-disabled-important",
+};

package/src/config/GlobalConfig.ts

@@ -1,63 +1,63 @@
-import type { PopsGeneralConfig, PopsDragConfig } from "../types/components";
-
-type EnterReturnType<T> = null | T | (() => T);
-
-type GlobalConfigOption = {
-  style?: EnterReturnType<string>;
-  zIndex?: EnterReturnType<number> | EnterReturnType<string>;
-} & Partial<PopsGeneralConfig> &
-  Partial<PopsDragConfig>;
-
-type ResultGlobalConfigOption<T> = T extends null | undefined ? never : T extends (...args: any) => infer R ? R : T;
-
-export const GlobalConfig = {
-  config: {} as GlobalConfigOption,
-  /**
-   * 为所有弹窗设置全局属性
-   */
-  setGlobalConfig(config: GlobalConfigOption) {
-    Reflect.ownKeys(config).forEach((keyName) => {
-      Reflect.set(GlobalConfig.config, keyName, Reflect.get(config, keyName));
-    });
-  },
-  /**
-   * 获取全局配置
-   */
-  getGlobalConfig() {
-    const result: {
-      [P in keyof GlobalConfigOption]: ResultGlobalConfigOption<GlobalConfigOption[P]>;
-    } = {};
-    Object.keys(GlobalConfig.config).forEach((keyName) => {
-      const configValue = Reflect.get(GlobalConfig.config, keyName);
-      if (keyName === "style") {
-        // 设置style属性
-        const style = configValue == null ? "" : typeof configValue === "function" ? configValue() : configValue;
-
-        if (typeof style === "string") {
-          result.style = style;
-        }
-      } else if (keyName === "zIndex") {
-        // 设置zIndex属性
-        let zIndex = configValue == null ? "" : typeof configValue === "function" ? configValue() : configValue;
-        if (typeof zIndex === "string") {
-          const newIndex = (zIndex = Number(zIndex));
-          if (!isNaN(newIndex)) {
-            result.zIndex = newIndex;
-          }
-        } else {
-          if (!isNaN(zIndex)) {
-            result.zIndex = zIndex;
-          }
-        }
-      } else if (keyName === "mask") {
-        const mask = GlobalConfig.config.mask == null ? {} : GlobalConfig.config.mask;
-        if (typeof mask === "object" && mask != null) {
-          result.mask = mask;
-        }
-      } else {
-        Reflect.set(result, keyName, configValue);
-      }
-    });
-    return result;
-  },
-};
+import type { PopsGeneralConfig, PopsDragConfig } from "../types/components";
+
+type EnterReturnType<T> = null | T | (() => T);
+
+type GlobalConfigOption = {
+  style?: EnterReturnType<string>;
+  zIndex?: EnterReturnType<number> | EnterReturnType<string>;
+} & Partial<PopsGeneralConfig> &
+  Partial<PopsDragConfig>;
+
+type ResultGlobalConfigOption<T> = T extends null | undefined ? never : T extends (...args: any) => infer R ? R : T;
+
+export const GlobalConfig = {
+  config: {} as GlobalConfigOption,
+  /**
+   * 为所有弹窗设置全局属性
+   */
+  setGlobalConfig(config: GlobalConfigOption) {
+    Reflect.ownKeys(config).forEach((keyName) => {
+      Reflect.set(GlobalConfig.config, keyName, Reflect.get(config, keyName));
+    });
+  },
+  /**
+   * 获取全局配置
+   */
+  getGlobalConfig() {
+    const result: {
+      [P in keyof GlobalConfigOption]: ResultGlobalConfigOption<GlobalConfigOption[P]>;
+    } = {};
+    Object.keys(GlobalConfig.config).forEach((keyName) => {
+      const configValue = Reflect.get(GlobalConfig.config, keyName);
+      if (keyName === "style") {
+        // 设置style属性
+        const style = configValue == null ? "" : typeof configValue === "function" ? configValue() : configValue;
+
+        if (typeof style === "string") {
+          result.style = style;
+        }
+      } else if (keyName === "zIndex") {
+        // 设置zIndex属性
+        let zIndex = configValue == null ? "" : typeof configValue === "function" ? configValue() : configValue;
+        if (typeof zIndex === "string") {
+          const newIndex = (zIndex = Number(zIndex));
+          if (!isNaN(newIndex)) {
+            result.zIndex = newIndex;
+          }
+        } else {
+          if (!isNaN(zIndex)) {
+            result.zIndex = zIndex;
+          }
+        }
+      } else if (keyName === "mask") {
+        const mask = GlobalConfig.config.mask == null ? {} : GlobalConfig.config.mask;
+        if (typeof mask === "object" && mask != null) {
+          result.mask = mask;
+        }
+      } else {
+        Reflect.set(result, keyName, configValue);
+      }
+    });
+    return result;
+  },
+};