@bestime/utils_browser 1.0.1 → 1.0.3

package/dist/jUtilsBrowser.esm.d.ts

@@ -6,6 +6,140 @@ declare function getWindowSize(): {
   height: number;
 };
 
+/**
+ * 监听DOM尺寸变化
+ * @param element - dom元素
+ * @param handler - 变换回调函数
+ * @param type - 监听类型。默认width+height
+ * @param interval - 多久检查一次。默认值：500
+ * @returns 销毁方法
+ *
+ */
+declare function observeDomResize(
+  element: HTMLElement,
+  handler: (element: HTMLElement) => void,
+  type?: ('width' | 'height' | 'position')[],
+  interval?: number
+): () => void;
+
+/**
+ * 下载 url 文件
+ * @param url - 文件地址
+ * @param fileName - 文件名
+ */
+declare function downloadFileByUrl(url: string, fileName: string): void;
+
+/**
+ * 下载ArrayBuffer文件
+ * @param data - ArrayBuffer格式的数据
+ * @param fileName - 文件名
+ */
+declare function downloadFileByArrayBuffer(data: ArrayBuffer, fileName: string): void;
+
+/**
+ * 移除Dom节点
+ * @param dom - 待移除的dom元素
+ */
+declare function removeElement(el: HTMLElement): void;
+
+/**
+ * 移除Dom节点
+ * @param ev - 事件
+ * @param bubble - 阻止冒泡. 默认 true
+ * @param stop - 阻止穿透. 默认 true
+ */
+declare function prevent(ev: Event, bubble: boolean, stop: boolean): void;
+
+/**
+ * @param key - 获取的键
+ * @returns 保存的值
+ */
+declare function getStorage(key: string): string;
+
+/**
+ * @param key - 删除的键
+ * @returns 保存的值
+ */
+declare function removeStorage(key: string): void;
+
+/**
+ * 设置localstorage
+ * @param key - 保存的键
+ * @param value - 保存的值
+ */
+declare function setStorage(key: string, value: any): void;
+
+/**
+ * 获取dom相对位置
+ * @param el - dom
+ * @returns 信息
+ */
+declare function getRelativePos(el: HTMLElement): {
+  x: number;
+  y: number;
+  height: number;
+  width: number;
+  clientWidth: number;
+  clientHeight: number;
+};
+
+/**
+ * 获取当前js所在路径
+ * @param tir - 向上取几级目录，默认0，当前目录
+ * @returns 相对路径
+ */
+declare function getJsFileBaseUrl(tir: number): string;
+
+interface LibraryFileConfig {
+  type: 'js' | 'css';
+  url: string;
+  module: string;
+  dependencies?: LibraryFileConfig[];
+  with?: LibraryFileConfig[];
+  attribute?: Record<string, string>;
+}
+type SuccessCallback = (...args: any[]) => void;
+/**
+ * js和css文件加载器
+ * @param files - 文件配置
+ * @param callback - 加载成功回调
+ */
+declare function libraryFile(
+  files: LibraryFileConfig | LibraryFileConfig[],
+  callback: SuccessCallback
+): void;
+
+/**
+ * 设置cookie。默认path="/"
+ * @param key - 设置的键名
+ * @param value - 设置的值
+ * @param expiredTime - 单位（毫秒）
+ */
+declare function setCookie(key: string, value: string, expiredTime?: number): void;
+
+/**
+ * @param key - 获取的键
+ * @param target - 来源，默认document.cookie
+ * @returns 保存的值
+ */
+declare function getCookie(key: string, target?: string): string;
+
+/**
+ * 删除cookie
+ *
+ * @param key - 键名
+ */
+declare function removeCookie(key: string): void;
+
+/**
+ * 给dom元素添加className
+ * @param el - DOM
+ * @param from - 将要被替换的className
+ * @param to - 替换为
+ * @returns
+ */
+declare function toggleClass(el: HTMLElement, from: string | string[], to: string | string[]): void;
+
 /**
  * 给dom元素添加className
  * @param el - DOM
@@ -14,6 +148,33 @@ declare function getWindowSize(): {
  */
 declare function addClass(el: HTMLElement, name: string | string[]): void;
 
-export { addClass, getWindowSize };
+/**
+ * 给dom元素移除className
+ * @param el - DOM
+ * @param name - 需要添加的className
+ * @returns
+ */
+declare function removeClass(el: HTMLElement, name: string | string[]): void;
+
+export {
+  addClass,
+  downloadFileByArrayBuffer,
+  downloadFileByUrl,
+  getCookie,
+  getJsFileBaseUrl,
+  getRelativePos,
+  getStorage,
+  getWindowSize,
+  libraryFile,
+  observeDomResize,
+  prevent,
+  removeClass,
+  removeCookie,
+  removeElement,
+  removeStorage,
+  setCookie,
+  setStorage,
+  toggleClass
+};
 
 export default undefined;

package/dist/jUtilsBrowser.esm.min.mjs

@@ -3,6 +3,6 @@
  * @QQ 1174295440
  * @author Bestime
  * @see https://github.com/bestime/tool
- * @update 2023-11-05 11:41:51
+ * @update 2023-11-08 22:15:57
  */
-import{isArray,forEach}from"@bestime/utils_base";function getWindowSize(){return{width:document.documentElement.clientWidth||document.body.clientWidth||window.innerWidth||0,height:document.documentElement.clientHeight||document.body.clientHeight||window.innerHeight||0}}function addClass(i,t){isArray(t)?forEach(t,function(t){i.classList.add(t)}):i.classList.add(t)}export{addClass,getWindowSize};
+import{defaultValue,isString,variableHasValue,isArray,forEach}from"@bestime/utils_base";function getWindowSize(){return{width:document.documentElement.clientWidth||document.body.clientWidth||window.innerWidth||0,height:document.documentElement.clientHeight||document.body.clientHeight||window.innerHeight||0}}var timer,htivId=0,idName="",isStart=!1,records={};function stop(){isStart=!1,clearInterval(timer),timer=undefined}function startRun(){clearInterval(timer),isStart=!0,timer=setInterval(function(){for(var e in records){var t=records[e];t.current=+new Date,t.current-t.start>=t.interval&&(t.start=t.current,records[e].handler())}},17)}function add(e,t){return idName="HI-"+ ++htivId,records[idName]={start:+new Date,current:0,handler:e,interval:t},isStart||startRun(),idName}function remove(e){delete records[e],0===Object.keys(records).length&&stop()}var hpInterval={add:add,remove:remove};function observeDomResize(n,o,r,e){var i=[0,0,!1],l=[0,0,!1],a=[0,0,!1],d=[0,0,!1],t=hpInterval.add(c,e=e||500);function c(){var e,t;document.body.contains(n)?(e=!1,null!=r&&r.includes("position")&&(t=n.getBoundingClientRect(),a[0]=t.left,a[2]=a[0]!==a[1],d[0]=t.top,d[2]=d[0]!==d[1]),i[0]=n.offsetWidth,i[2]=i[0]!==i[1],l[0]=n.offsetHeight,l[2]=l[0]!==l[1],i[2]&&(i[1]=i[0],null!=r&&r.includes("width")&&(e=!0)),l[2]&&(l[1]=l[0],null!=r&&r.includes("height")&&(e=!0)),(d[2]||a[2])&&(d[1]=d[0],a[1]=a[0],null!=r&&r.includes("position")&&(e=!0)),r&&0!==r.length||(i[2]||l[2]||d[2]||a[2])&&(e=!0),e&&o(n)):s()}function s(){hpInterval.remove(t),i=undefined,l=undefined}return c(),s}function downloadFileByUrl(e,t){var n=document.createElement("a");n.style.display="none",n.download=t,n.setAttribute("href",e),n.setAttribute("target","_blank"),n.setAttribute("download",t),document.body.appendChild(n),n.click(),n.remove()}var $undefinedValue=void 0,$decodeURIComponent=decodeURIComponent,$browserGlobal=window,$headElement=document.getElementsByTagName("head")[0];function downloadFileByArrayBuffer(e,t){var n=$browserGlobal.URL,e=n.createObjectURL(new Blob([e]));downloadFileByUrl(e,t),n.revokeObjectURL(e),undefined}function removeElement(e){e.parentNode&&e.parentNode.removeChild(e)}function prevent(e,t,n){e=e||$browserGlobal.event,n=!1!==n,(t=!1!==t)&&$browserGlobal.event?$browserGlobal.event.cancelBubble=!0:e.stopPropagation(),n&&$browserGlobal.event?$browserGlobal.event.returnValue=!1:e.preventDefault()}function getStorage(e){e=localStorage.getItem(e);return defaultValue(e,"")}function removeStorage(e){localStorage.removeItem(e)}function hpSetStringValue(e){return e=isString(e)?e:JSON.stringify(e)}function setStorage(e,t){localStorage.setItem(e,hpSetStringValue(t))}function getRelativePos(e){var t=e.getBoundingClientRect();return{x:t.left,y:t.top,height:e.offsetHeight,width:e.offsetWidth,clientWidth:e.clientWidth,clientHeight:e.clientHeight}}function getJsFileBaseUrl(e){e=e||0;for(var t="/[^/]*",n=document.scripts,o=0;o<e;o++)t+=t;return n[n.length-1].src.replace(new RegExp(t+"$"),"")}function hpCreateFileLoaderElement(e,t,n,o){if($headElement){var r;if("js"===e?(r=document.createElement("script")).src=t:((r=document.createElement("link")).setAttribute("rel","stylesheet"),r.href=t),o)for(var i in o)r.setAttribute(i,o[i]);r.onload=r.onerror=n,$headElement.appendChild(r)}}var cache={};function loadMultiple(n,o){for(var r=[],i=0,e=0;e<n.length;e++)!function(t){loadSingle(n[t],function(e){r[t]=e,++i===n.length&&o.apply($undefinedValue,r)})}(e)}function loadSingle(e,t){var n=e.dependencies&&e.dependencies.length,o=e["with"]&&e["with"].length,r=(cache[e.url]||(cache[e.url]={count:0,dependencies:!n,"with":!o,complete:!1,create:!1,url:e.url}),cache[e.url]);function i(){r.complete&&r.dependencies&&r["with"]&&(e.module?t($browserGlobal[e.module]):t())}r.count++,!r.dependencies&&n?(r.dependencies=!0,loadMultiple(e.dependencies,function(){loadSingle(e,t)})):!r["with"]&&o?(r["with"]=!0,loadMultiple(e["with"].concat(e),i)):r.create?variableHasValue(function(){return r.complete},i,300):(r.create=!0,hpCreateFileLoaderElement(e.type,e.url,function(){r.complete=!0,i()},e.attribute))}function libraryFile(e,t){console.log("加载器",e,cache),(e instanceof Array?loadMultiple:loadSingle)(e,t)}function setObjectToString(e){return e=isString(e)?e:JSON.stringify(e)}function setCookie(e,t,n){t=setObjectToString(t);e=e+"="+encodeURI(t)+";path=/;";"number"==typeof n&&((t=new Date).setTime(t.getTime()+n),e+="expires="+t.toUTCString()),document.cookie=e}function getCookie(e,t){t=t||document.cookie;var o="";return t.replace(new RegExp("(^|;\\s)"+e+"=(.*?)($|(;\\s))"),function(e,t,n){o=$decodeURIComponent(n)}),o}function removeCookie(e){setCookie(e,"",-1)}function removeClass(t,e){isArray(e)?forEach(e,function(e){t.classList.remove(e)}):t.classList.remove(e)}function addClass(t,e){isArray(e)?forEach(e,function(e){t.classList.add(e)}):t.classList.add(e)}function toggleClass(e,t,n){removeClass(e,t),addClass(e,n)}export{addClass,downloadFileByArrayBuffer,downloadFileByUrl,getCookie,getJsFileBaseUrl,getRelativePos,getStorage,getWindowSize,libraryFile,observeDomResize,prevent,removeClass,removeCookie,removeElement,removeStorage,setCookie,setStorage,toggleClass};

package/dist/jUtilsBrowser.global.d.ts

@@ -6,6 +6,140 @@ declare function getWindowSize(): {
   height: number;
 };
 
+/**
+ * 监听DOM尺寸变化
+ * @param element - dom元素
+ * @param handler - 变换回调函数
+ * @param type - 监听类型。默认width+height
+ * @param interval - 多久检查一次。默认值：500
+ * @returns 销毁方法
+ *
+ */
+declare function observeDomResize(
+  element: HTMLElement,
+  handler: (element: HTMLElement) => void,
+  type?: ('width' | 'height' | 'position')[],
+  interval?: number
+): () => void;
+
+/**
+ * 下载 url 文件
+ * @param url - 文件地址
+ * @param fileName - 文件名
+ */
+declare function downloadFileByUrl(url: string, fileName: string): void;
+
+/**
+ * 下载ArrayBuffer文件
+ * @param data - ArrayBuffer格式的数据
+ * @param fileName - 文件名
+ */
+declare function downloadFileByArrayBuffer(data: ArrayBuffer, fileName: string): void;
+
+/**
+ * 移除Dom节点
+ * @param dom - 待移除的dom元素
+ */
+declare function removeElement(el: HTMLElement): void;
+
+/**
+ * 移除Dom节点
+ * @param ev - 事件
+ * @param bubble - 阻止冒泡. 默认 true
+ * @param stop - 阻止穿透. 默认 true
+ */
+declare function prevent(ev: Event, bubble: boolean, stop: boolean): void;
+
+/**
+ * @param key - 获取的键
+ * @returns 保存的值
+ */
+declare function getStorage(key: string): string;
+
+/**
+ * @param key - 删除的键
+ * @returns 保存的值
+ */
+declare function removeStorage(key: string): void;
+
+/**
+ * 设置localstorage
+ * @param key - 保存的键
+ * @param value - 保存的值
+ */
+declare function setStorage(key: string, value: any): void;
+
+/**
+ * 获取dom相对位置
+ * @param el - dom
+ * @returns 信息
+ */
+declare function getRelativePos(el: HTMLElement): {
+  x: number;
+  y: number;
+  height: number;
+  width: number;
+  clientWidth: number;
+  clientHeight: number;
+};
+
+/**
+ * 获取当前js所在路径
+ * @param tir - 向上取几级目录，默认0，当前目录
+ * @returns 相对路径
+ */
+declare function getJsFileBaseUrl(tir: number): string;
+
+interface LibraryFileConfig {
+  type: 'js' | 'css';
+  url: string;
+  module: string;
+  dependencies?: LibraryFileConfig[];
+  with?: LibraryFileConfig[];
+  attribute?: Record<string, string>;
+}
+type SuccessCallback = (...args: any[]) => void;
+/**
+ * js和css文件加载器
+ * @param files - 文件配置
+ * @param callback - 加载成功回调
+ */
+declare function libraryFile(
+  files: LibraryFileConfig | LibraryFileConfig[],
+  callback: SuccessCallback
+): void;
+
+/**
+ * 设置cookie。默认path="/"
+ * @param key - 设置的键名
+ * @param value - 设置的值
+ * @param expiredTime - 单位（毫秒）
+ */
+declare function setCookie(key: string, value: string, expiredTime?: number): void;
+
+/**
+ * @param key - 获取的键
+ * @param target - 来源，默认document.cookie
+ * @returns 保存的值
+ */
+declare function getCookie(key: string, target?: string): string;
+
+/**
+ * 删除cookie
+ *
+ * @param key - 键名
+ */
+declare function removeCookie(key: string): void;
+
+/**
+ * 给dom元素添加className
+ * @param el - DOM
+ * @param from - 将要被替换的className
+ * @param to - 替换为
+ * @returns
+ */
+declare function toggleClass(el: HTMLElement, from: string | string[], to: string | string[]): void;
+
 /**
  * 给dom元素添加className
  * @param el - DOM
@@ -14,12 +148,39 @@ declare function getWindowSize(): {
  */
 declare function addClass(el: HTMLElement, name: string | string[]): void;
 
+/**
+ * 给dom元素移除className
+ * @param el - DOM
+ * @param name - 需要添加的className
+ * @returns
+ */
+declare function removeClass(el: HTMLElement, name: string | string[]): void;
+
 declare global {
   /**
    * 该声明文件用于全局声明（不用npm安装时拷贝到项目中直接使用）
    */
   namespace jUtilsBrowser {
-    export { addClass, getWindowSize };
+    export {
+      addClass,
+      downloadFileByArrayBuffer,
+      downloadFileByUrl,
+      getCookie,
+      getJsFileBaseUrl,
+      getRelativePos,
+      getStorage,
+      getWindowSize,
+      libraryFile,
+      observeDomResize,
+      prevent,
+      removeClass,
+      removeCookie,
+      removeElement,
+      removeStorage,
+      setCookie,
+      setStorage,
+      toggleClass
+    };
   }
 }
 

package/dist/jUtilsBrowser.umd.min.cjs

@@ -3,6 +3,6 @@
  * @QQ 1174295440
  * @author Bestime
  * @see https://github.com/bestime/tool
- * @update 2023-11-05 11:41:51
+ * @update 2023-11-08 22:15:57
  */
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("@bestime/utils_base")):"function"==typeof define&&define.amd?define(["exports","@bestime/utils_base"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).jUtilsBrowser={},e.jUtilsBase)}(this,function(e,i){"use strict";e.addClass=function(t,e){i.isArray(e)?i.forEach(e,function(e){t.classList.add(e)}):t.classList.add(e)},e.getWindowSize=function(){return{width:document.documentElement.clientWidth||document.body.clientWidth||window.innerWidth||0,height:document.documentElement.clientHeight||document.body.clientHeight||window.innerHeight||0}}});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("@bestime/utils_base")):"function"==typeof define&&define.amd?define(["exports","@bestime/utils_base"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).jUtilsBrowser={},e.jUtilsBase)}(this,function(e,d){"use strict";var n,i,o=0,r=!1,c={};var s={add:function(e,t){return n="HI-"+ ++o,c[n]={start:+new Date,current:0,handler:e,interval:t},r||(clearInterval(i),r=!0,i=setInterval(function(){for(var e in c){var t=c[e];t.current=+new Date,t.current-t.start>=t.interval&&(t.start=t.current,c[e].handler())}},17)),n},remove:function(e){delete c[e],0===Object.keys(c).length&&(r=!1,clearInterval(i),i=undefined)}};function l(e,t){var n=document.createElement("a");n.style.display="none",n.download=t,n.setAttribute("href",e),n.setAttribute("target","_blank"),n.setAttribute("download",t),document.body.appendChild(n),n.click(),n.remove()}var a=void 0,u=decodeURIComponent,f=window,h=document.getElementsByTagName("head")[0];var m={};function g(n,i){for(var o=[],r=0,e=0;e<n.length;e++)!function(t){p(n[t],function(e){o[t]=e,++r===n.length&&i.apply(a,o)})}(e)}function p(e,t){var n=e.dependencies&&e.dependencies.length,i=e["with"]&&e["with"].length,o=(m[e.url]||(m[e.url]={count:0,dependencies:!n,"with":!i,complete:!1,create:!1,url:e.url}),m[e.url]);function r(){o.complete&&o.dependencies&&o["with"]&&(e.module?t(f[e.module]):t())}if(o.count++,!o.dependencies&&n)o.dependencies=!0,g(e.dependencies,function(){p(e,t)});else if(!o["with"]&&i)o["with"]=!0,g(e["with"].concat(e),r);else if(o.create)d.variableHasValue(function(){return o.complete},r,300);else{o.create=!0;var c,n=e.type,i=e.url,l=function(){o.complete=!0,r()},a=e.attribute;if(h){if("js"===n?(c=document.createElement("script")).src=i:((c=document.createElement("link")).setAttribute("rel","stylesheet"),c.href=i),a)for(var u in a)c.setAttribute(u,a[u]);c.onload=c.onerror=l,h.appendChild(c)}}}function t(e,t,n){i=t,t=i=d.isString(i)?i:JSON.stringify(i);var i=e+"="+encodeURI(t)+";path=/;";"number"==typeof n&&((e=new Date).setTime(e.getTime()+n),i+="expires="+e.toUTCString()),document.cookie=i}function v(t,e){d.isArray(e)?d.forEach(e,function(e){t.classList.remove(e)}):t.classList.remove(e)}function b(t,e){d.isArray(e)?d.forEach(e,function(e){t.classList.add(e)}):t.classList.add(e)}e.addClass=b,e.downloadFileByArrayBuffer=function(e,t){var n=f.URL;l(e=n.createObjectURL(new Blob([e])),t),n.revokeObjectURL(e),undefined},e.downloadFileByUrl=l,e.getCookie=function(e,t){t=t||document.cookie;var i="";return t.replace(new RegExp("(^|;\\s)"+e+"=(.*?)($|(;\\s))"),function(e,t,n){i=u(n)}),i},e.getJsFileBaseUrl=function(e){e=e||0;for(var t="/[^/]*",n=document.scripts,i=0;i<e;i++)t+=t;return n[n.length-1].src.replace(new RegExp(t+"$"),"")},e.getRelativePos=function(e){var t=e.getBoundingClientRect();return{x:t.left,y:t.top,height:e.offsetHeight,width:e.offsetWidth,clientWidth:e.clientWidth,clientHeight:e.clientHeight}},e.getStorage=function(e){return e=localStorage.getItem(e),d.defaultValue(e,"")},e.getWindowSize=function(){return{width:document.documentElement.clientWidth||document.body.clientWidth||window.innerWidth||0,height:document.documentElement.clientHeight||document.body.clientHeight||window.innerHeight||0}},e.libraryFile=function(e,t){console.log("加载器",e,m),(e instanceof Array?g:p)(e,t)},e.observeDomResize=function(n,i,o,e){var r=[0,0,!1],c=[0,0,!1],l=[0,0,!1],a=[0,0,!1],t=s.add(u,e=e||500);function u(){var e,t;document.body.contains(n)?(e=!1,null!=o&&o.includes("position")&&(t=n.getBoundingClientRect(),l[0]=t.left,l[2]=l[0]!==l[1],a[0]=t.top,a[2]=a[0]!==a[1]),r[0]=n.offsetWidth,r[2]=r[0]!==r[1],c[0]=n.offsetHeight,c[2]=c[0]!==c[1],r[2]&&(r[1]=r[0],null!=o&&o.includes("width")&&(e=!0)),c[2]&&(c[1]=c[0],null!=o&&o.includes("height")&&(e=!0)),(a[2]||l[2])&&(a[1]=a[0],l[1]=l[0],null!=o&&o.includes("position")&&(e=!0)),o&&0!==o.length||(r[2]||c[2]||a[2]||l[2])&&(e=!0),e&&i(n)):d()}function d(){s.remove(t),r=undefined,c=undefined}return u(),d},e.prevent=function(e,t,n){e=e||f.event,n=!1!==n,(t=!1!==t)&&f.event?f.event.cancelBubble=!0:e.stopPropagation(),n&&f.event?f.event.returnValue=!1:e.preventDefault()},e.removeClass=v,e.removeCookie=function(e){t(e,"",-1)},e.removeElement=function(e){e.parentNode&&e.parentNode.removeChild(e)},e.removeStorage=function(e){localStorage.removeItem(e)},e.setCookie=t,e.setStorage=function(e,t){localStorage.setItem(e,(e=t,e=d.isString(e)?e:JSON.stringify(e)))},e.toggleClass=function(e,t,n){v(e,t),b(e,n)}});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bestime/utils_browser",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "main": "./dist/jUtilsBrowser.esm.min.mjs",
   "module": "./dist/jUtilsBrowser.esm.min.mjs",
   "types": "./dist/jUtilsBrowser.esm.d.ts",
@@ -13,6 +13,10 @@
     "build": "rollup --config rollup.config.prod.js",
     "serve": "rollup --config rollup.config.dev.js --watch"
   },
+  
+  "dependencies": {
+    "@bestime/utils_base": "^1.0.3"
+  },
   "devDependencies": {
     "@babel/core": "7.18.6",
     "@babel/plugin-proposal-class-properties": "^7.18.6",
@@ -48,8 +52,5 @@
   "homepage": "https://github.com/bestime/tool",
   "publishConfig": {
     "access": "public"
-  },
-  "dependencies": {
-    "@bestime/utils_base": "^1.0.1"
   }
 }