这13个前端库,让我在工作中轻松摸鱼

发表时间: 2024-05-30 10:43

前言

平时开发的过程中,常常会使用到一些第三方库来提高开发效率,我总结了自己工作这么久以来经常用到的 13 个库,希望对大家有帮助~

antd

全称应该是Ant Design,这是一个 React 的组件库,旨在提供一套常用的组件库解决方案,用 React 的同学可能对他不会陌生,就像用 Vue 的同学不会对 Element UI 陌生一样。

虽然现在也出现了更多新颖的组件库,但是无论是在公司还是自己做一些东西,只要是中后台的产品,我们都会使用它。

它提供了 75 个组件,包括常用的按钮、下拉、输入框、菜单、分页、时间选择器、级联选择器、对话框、进度条等等,常用的不常用的组件基本都有,我觉得基本上能涵盖 90% 的常规开发场景。

支持国际化以及自定义主题色,可以让我们轻松拓展。

除了拥有不俗的样式以及交互效果之外,还向外输出了一套设计理念,包括 Icon 、颜色、字体大小、阴影等,也是我们值得借鉴和学习的地方。

axios

这可以说是我每天都用到的库,相信各位同学对它也不会陌生。这是一个基于 Promise 的 http 请求库,也就是我们常说的调接口,就是用它来调用。

它支持浏览器端和 node 端,除此之外,它支持我们自定义请求和响应的拦截器,这可以让我们在发送请求前或收到响应后执行额外的操作。比如,可以在请求发送前添加认证信息,或在收到响应后处理数据。

它提供了取消请求的功能,我们可以在请求发送后取消请求,避免不必要的网络请求或资源浪费。

以下是我自己常用的一种封装 axios 的手法:

let _BASE_URL = "/api";import { message } from "antd";import _axios from "axios";const axiosInstance = _axios.create({  withCredentials: true, // 是否允许带cookie这些});axiosInstance.interceptors.request.use((request) => {  request.headers['Authorization'] = getAuthorization();  return request;});axiosInstance.interceptors.response.use(  (response: any) => {    const data = response.data;    if (data.code === 401) {      const loginUrl = `${location.protocol}//${        location.host      }/login?redirect_url=${encodeURIComponent(location.href)}`;      location.replace(loginUrl);    } else if (data.code !== 200) {      message.error(data.msg);      return Promise.reject(data.msg);    }    return response.data;  },  (error) => {    // 超出 2xx 范围的状态码都会触发该函数。对响应错误时调用。    console.error("请求错误: ", error);    message.error(error?.message);    return Promise.reject(error);  });export const BASE_URL = _BASE_URL;export const axios = axiosInstance;

封装一个 axiosInstance ,然后再新建一个请求模块文件,比如说我们对用户相关的接口都可以放在 user 模块中:

import { BASE_URL, axios } from ".";export const register = (params: {  account: string;  password: string;  code: string;}) => {  return axios.post(`${BASE_URL}/user/register/${params.code}`, {    account: params.account,    password: params.password,  });};export const login = (params: { account: string; password: string }) => {  return axios.post(`${BASE_URL}/user/login`, params);};

然后再在代码里面如下使用 user 模块中的接口:

  try {    setLoading(true);    await login({ account: fields.account, password: fields.password });    message.success("登录成功");  } finally {    setLoading(false);  }

dayjs

dayjs是一个十分强大的日期处理库,它只有 2KB ,十分轻巧。API设计支持链式调用,非常灵活,而且兼容所有的浏览器。

以下是 dayjs 中使用的时候常见的 10 个例子,仅供参考

import dayjs from "dayjs";// 1. 获取当前日期const currentDate = dayjs();console.log(currentDate.format('YYYY-MM-DD')); // 输出当前日期,如:2024-04-30// 2. 获取当前时间const currentTime = dayjs();console.log(currentTime.format('HH:mm:ss')); // 输出当前时间,如:14:30:00// 3. 获取指定日期const specifiedDate = dayjs('2023-01-15');console.log(specifiedDate.format('YYYY-MM-DD')); // 输出指定日期,如:2023-01-15// 4. 格式化日期const formattedDate = dayjs('2024-04-30');console.log(formattedDate.format('dddd, MMMM D, YYYY')); // 输出格式化后的日期,如:Saturday, April 30, 2024// 5. 添加/减去时间const addedTime = dayjs().add(7, 'days');console.log(addedTime.format('YYYY-MM-DD')); // 输出添加 7 天后的日期,如:2024-05-07// 6. 计算两个日期之间的差值const date1 = dayjs('2024-01-01');const date2 = dayjs('2024-02-01');const diffInDays = date2.diff(date1, 'days');console.log(diffInDays); // 输出两个日期之间的天数差,如:31// 7. 检查日期是否在某个范围内const targetDate = dayjs('2024-04-30');const startDate = dayjs('2024-04-01');const endDate = dayjs('2024-05-01');const isWithinRange = targetDate.isBetween(startDate, endDate);console.log(isWithinRange); // 输出 true,因为目标日期在范围内// 8. 获取一周中的第几天const dayOfWeek = dayjs().day();console.log(dayOfWeek); // 输出今天是一周中的第几天,0 表示星期日,1 表示星期一,依此类推// 9. 获取月份的天数const daysInMonth = dayjs('2024-02-01').daysInMonth();console.log(daysInMonth); // 输出该月份的天数,如:29// 10. 获取两个日期之间的所有日期const startDate = dayjs('2024-04-01');const endDate = dayjs('2024-04-05');const allDates = [];let currentDate = startDate;while (currentDate.isBefore(endDate) || currentDate.isSame(endDate, 'day')) {    allDates.push(currentDate.format('YYYY-MM-DD'));    currentDate = currentDate.add(1, 'day');}console.log(allDates); // 输出包含所有日期的数组,如:['2024-04-01', '2024-04-02', '2024-04-03', '2024-04-04', '2024-04-05']

lodash

lodash 是一个 js 工具库,提供了许多工具函数,用于简化常见的编程需求。

以下是我对它特点的一些理解:

  1. 集合处理:提供了许多用于处理数组和对象的方法,如排序、过滤、查找、分组等,使得对集合进行操作变得非常方便。
  2. 函数工具:包含了许多函数工具,如节流、防抖、柯里化等。
  3. 类型检查:提供了一系列用于类型检查的函数,如 isString 、 isArray 、 isObject 等。
  4. 深拷贝: 提供了强大的深拷贝函数,兼容了函数、日期、正则对象等。
  5. 字符串处理:提供了许多用于字符串处理的方法,如截取、拼接、格式化等。
  6. 数学运算:提供了一些常见的数学运算函数,如求和、求平均数、最大值、最小值等。

下面举几个我常用的lodash函数:

深拷贝

import { cloneDeep } from "lodash"const originalObject = { name: '名字', age: 30, hobbies: ['唱', '跳'] };const clonedObject = cloneDeep(originalObject);console.log(clonedObject); // 输出一个深拷贝后的对象

数组去重

import { uniq } from "lodash"const numbers = [1, 2, 2, 3, 3, 3, 4, 4, 4, 4];const uniqueNumbers = uniq(numbers);console.log(uniqueNumbers); // 输出 [1, 2, 3, 4]

函数防抖

import { debounce } from "lodash"const debouncedFunction = debounce(() => {    console.log('防抖函数');}, 1000);debouncedFunction();

对象深度比较

import { isEqual } from "lodash"const object1 = { a: { b: 2 } };const object2 = { a: { b: 2 } };const res = isEqual(object1, object2);console.log(res); // 输出 true,因为两个对象的内容相同

xss

xss是一个用于处理 HTML 和防止 XSS 攻击的库,一般提交一些富文本内容的时候我们都会用它过滤一下。

它通过过滤和转义,可以去除输入的 HTML 字符串中的不安全的标签;同时支持白名单配置,用于指定允许出现的标签和属性;而且它是一个轻量级的库,体积十分小巧,引入也不会对项目造成什么影响;并且它在浏览器端跟 Node 端都能使用。

下面是一些使用的例子:

import xss from "xss";const userInput = '<script>alert("恶意代码");</script><p>这是用户输入的文本内容</p>'; const output = xss(userInput);console.log(output); // <script>alert("恶意代码");</script><p>这是用户输入的文本内容</p>

再举一个白名单的使用例子,下面是没设置白名单的代码

import xss from "xss";const userInput = '<script>alert("恶意代码");</script><p>这是用户输入的文本内容</p><a href="javascript:alert(\'XSS攻击\')">恶意链接</a>';const output = xss(userInput);console.log(output); // <script>alert("恶意代码");</script><p>这是用户输入的文本内容</p><a href>恶意链接</a>

这里是设置了白名单的代码:

import xss from "xss";const userInput = '<script>alert("恶意代码");</script><p>这是用户输入的文本内容</p><a href="http://example.com">正常链接</a><a href="javascript:alert(\'XSS攻击\')">恶意链接</a>';const options = {  whiteList: {    a: ['href']  },  onTagAttr: (tag, name, value, isWhiteAttr) => {    if (tag === 'a' && name === 'href' && !/^https?:\/\//.test(value)) {      return `${name}="#"`;    }  }};const output = xss(userInput, options);console.log(output); //<script>alert("恶意代码");</script><p>这是用户输入的文本内容</p><a href="http://example.com">正常链接</a><a href="#">恶意链接</a>

classnames

classnames是用来处理 css 类名组合的一个库,提供了一种方便的方式来动态添加或者移除类名,实现样式的灵活控制。

比如说我们的一个按钮,它有按下跟 hover 两种状态,对应不同的样式。对于没有用 classnames 来说,可能会这么写

let btnClass = 'btn';if (isPressed) btnClass += ' btn-pressed';else if (isHovered) btnClass += ' btn-over';return (    <button className={btnClass}>        按钮    </button>);

这种写法都算好的,更常见的是在 className 中用三元表达式+模版字符串来拼接,更是惨不忍睹。用上 classnames 之后,常常可以这么写:

const btnClass = classnames({    btn: true,    'btn-pressed': isPressed,    'btn-over': !isPressed && isHovered,});return (    <button className={btnClass}>        按钮    </button>);


copy-text-to-clipboard

copy-text-to-clipboard是一个轻量级的复制文本到剪贴板的库,仅仅只有 0.2KB ,提供了简单的 API ,非常易用,每周也是有着 37W+ 的下载量。

它兼容了不同的浏览器,没有任何外部依赖,在一些浏览器中,复制文本到剪贴板需要用户授权,该库提供了相应的错误处理机制。

import copy from 'copy-text-to-clipboard';button.addEventListener('click', () => {	copy('复制一些东西');});

uuid

uuid 用于生成符合 RFC 4122 标准的 UUID(通用唯一标识符)。UUID 是一种全局唯一的标识符,在分布式系统中的是唯一的。

uuid 库支持多种 UUID 版本,包括 版本 1 、 版本 3 、 版本 4 和 版本 5 ,每种版本都有不同的生成算法和格式。它提供了简洁的 API ,使得生成 UUID 变得非常简单和方便。

同时,它在生成 UUID 时具有很高的性能,可以快速生成大量的 UUID 。

它也是支持多端的,包括浏览器端跟 Node.js ,不仅如此,它还支持多种 UUID 的表示格式,包括标准的 UUID 字符串、二进制格式、数组格式等。

import { v4 as uuidv4 } from 'uuid';uuidv4(); //  d702159f-384c-4d09-bf16-89f42e27ca30

Quill

我相信做过中后台产品的同学一定会遇到的一个场景,就是有一个编辑框需要用到富文本编辑框,但是呢,他又不需要跟那些在线文档功能那么齐全强大,这个时候我们一般就是去找一些开源的富文本组件来解决。

这个时候我一般都会选择quill,它提供了丰富的编辑功能,包括文本样式(粗体、斜体、下划线等)、列表、链接、图像插入、表格、代码块等。

而且提供了丰富的事件和钩子,我们可以监听编辑器的各种操作事件,实现自定义的业务逻辑和交互效果。

以及它支持插件和扩展,可以通过第三方插件或自定义扩展来增强编辑器的功能和特性,满足更复杂的编辑需求

使用起来也很简单,如果你仅仅是需要一个能用的富文本框,并不需要定制什么东西,那下面的示例就已经满足

crypto-js

crypto-js提供了多种加密算法和常用的加密功能。包括对称加密算法(如 AES 、 DES )、哈希算法(如 MD5 、 SHA-1 、 SHA-256 )等。

除了提供多种加密算法之外,它的 API 设计也十分简单易用,以及对于各个平台的兼容性也十分好。

它的性能也很好,在加解密的过程中,可以快速处理大量的数据,不会对性能造成明显影响。

举一些例子,比如常用的MD5哈希算法:

import CryptoJS from "crypto-js";const data = 'Hello, world!';const md5Hash = CryptoJS.MD5(data);console.log(md5Hash.toString());

对称加密:

import CryptoJS from "crypto-js";const key = CryptoJS.enc.Utf8.parse("1234567890123456");const iv = CryptoJS.enc.Utf8.parse("1234567890123456");const plaintext = "Hello, world!";const ciphertext = CryptoJS.AES.encrypt(plaintext, key, {  iv: iv,  mode: CryptoJS.mode.CBC,  padding: CryptoJS.pad.Pkcs7,});console.log("加密后的数据:", ciphertext.toString()); //yWUReRP6G/jD2zWIXJMtTw==const decrypted = CryptoJS.AES.decrypt(ciphertext, key, {  iv: iv,  mode: CryptoJS.mode.CBC,  padding: CryptoJS.pad.Pkcs7,});console.log("解密后的数据:", decrypted.toString(CryptoJS.enc.Utf8)); //Hello, world!

viewerjs

图片预览需求想必很多同学都遇到过,这里介绍一个功能强大的图片预览库——viewerjs。

该库支持缩放、拖动、旋转等交互功能,可以通过鼠标或触摸屏进行操作,自由调整图片的大小和位置;而且支持缩略图导航功能,可以通过缩略图预览图片,快速导航到指定的图片。

它还提供了丰富的定制选项,可以根据需要自定义显示效果、交互行为和样式样式,满足不同项目的需求。

localforage

localstorage 相信大家都知道,但是它只有 5M 的存储空间,如果想在浏览器本地存储更多的东西,那就应该使用 indexDB 或者 WebSQL 。

localforage就是一个封装浏览器存储引擎的库,它的设计目的就是为了让开发者能够以简易的API来使用浏览器的本地存储来存储数据。

它可以自动地选择合适的存储引擎( IndexedDB 、 WebSQL 或 localStorage )来进行数据存储。

它支持自动数据类型转换,可以将对象、数组等复杂数据结构转换成适合存储的格式,并在取出数据时自动转换回原始格式。

它支持异步操作,所有的存储操作都是非阻塞的,可以避免因为数据存取操作而阻塞 UI 线程,支持回调函数的方式和 Promise 的方式来处理异步。

读操作:

try {    const value = await localforage.getItem('key');    console.log(value);} catch (err) {    console.log(err);}

写操作:

try {    const value = await localforage.setItem('key', [1, 2, 3]);} catch (err) {    console.log(err);}

vconsole

我们平时在开发的时候一般都是 F12 打开开发者工具来调试,但是当我们的 Web 项目跑在真机移动端中,是没有这个开发者工具的。那应该怎么调试呢?

这个时候就可以用到vconsole这个库,它可以在手机浏览器中实时查看日志、错误信息、网络请求等调试信息,帮助我们快速定位和解决问题。

在引入的时候,我有一个小技巧可以分享,最好是使用 cdn的 方式引入,这样你就很容易根据一些特征去做动态导入,这种包没必要打包进主包里面。

比如说:

  const loadVConsole = () => {    const url = "https://unpkg.com/vconsole@latest/dist/vconsole.min.js";    if (!location.href.includes("debug")) {      return;    }    const script = document.createElement("script");    script.src = url;    script.onload = () => {      new window.VConsole();    };    document.body.appendChild(script);  };

当然,这个 cdn 包的资源最好你自己维护一份。

最后

以上就是我开发工作过程中经常会用到的一些库,你平时会用到那些库呢?评论区一起交流一下吧!