npm 包 @egjs/flicking 使用教程

面试官：小伙子，你的数组去重方式惊艳到我了

介绍

@egjs/flicking 是一款前端轮播图插件，基于 Vanilla JS 编写，轻量、灵活、易用，支持无限循环滚动、响应式布局、自定义动画等功能。

它可以用来展示图片、广告、产品等轮播内容，在网站、移动应用、桌面应用等场景中经常被使用。

如果你想在你的项目中使用轮播图，那么 @egjs/flicking 是一个不错的选择。

安装

可以使用 npm 或 yarn 进行安装：

--- ------- --------------
---- --- --------------

快速开始

引入

在 HTML 文件中引入 @egjs/flicking 的 CSS 和 JS 文件：

---- --- ---
----- ---------------- -----------------------------------------------------

---- -- ---
------- ----------------------------------------------------------------

HTML 结构

在 HTML 文件中添加轮播图的结构：

---- -----------------
  ---- --------------------------
    ---- ------------------------
      ---- ---------------------------- -------
      ---- ---------------------------- -------
      ---- ---------------------------- -------
    ------
  ------
------

其中：

  • .flicking：最外层容器，用于初始化 Flicking 对象。
  • .flicking-viewport：可视区域，用于控制显示区域的尺寸和位置。
  • .flicking-camera：相机，所有 .flicking-panel 的容器，用于设置轮播图的总宽度。
  • .flicking-panel：每个轮播元素的容器，可以添加图片、文字等内容。

JavaScript 初始化

在 JavaScript 文件中初始化 Flicking：

----- -------- - --- -------------------------

至此，一个基本的轮播图就完成了。

配置

@egjs/flicking 提供了一系列的配置选项，可以让你根据自己的需求进行自定义。

核心配置项

  • horizontal: (boolean, default: true)：是否横向滚动。
  • circular: (boolean, default: false)：是否无限循环滚动。
  • bound: (boolean, default: false)：是否限制滚动边界。
  • boundSize: (number|string, default: 0)：边缘范围的尺寸，可以设置数字或百分比。
  • adaptive: (boolean, default: false)：是否响应式布局，即根据父容器的尺寸来自动调整轮播元素的尺寸。
  • autoResize: (boolean, default: false)：是否自动调整大小，即当尺寸发生变化时，自动重新计算位置和尺寸。
  • moveType: (string, default: snap)：滚动动画类型，包括 snap、freeScroll、snapFreeScroll。
  • duration: (number, default: 500)：动画过渡时间。
  • ease: (string, default: "cubic-bezier(0.25, 0.1, 0.25, 1.0)")：动画过渡函数。
  • deceleration: (number, default: 0.0075)：动画减速度。
  • inputType: (Array<string>|string, default: [ "touch", "mouse" ])：触发滚动的操作类型。
  • threshold: (number, default: 40)：触发滚动的阈值。
  • iOSEdgeSwipeThreshold: (number, default: 30)：iOS 边缘滚动阈值。
  • preventClickOnDrag: (boolean, default: true)：是否在拖动时禁用点击事件。

回调函数

  • beforeMove: ((e: FlickingEvent) => void, default: null)：移动前的回调函数。
  • moved: ((e: FlickingEvent) => void, default: null)：移动后的回调函数。
  • willChangeEvent: ((e: WillChangeEvent) => void, default: null)：将发生变化的回调函数。
  • changedEvent: ((e: ChangedEvent) => void, default: null)：变化后的回调函数。
  • moveStart: ((e: FlickingEvent) => void, default: null)：开始移动时的回调函数。
  • move: ((e: { delta: number, axis: "flick"|"dimmension"|"scroll" }, state: State) => void, default: null)：移动时的回调函数。
  • moveEnd: ((e: FlickingEvent) => void, default: null)：结束移动时的回调函数。

方法

@egjs/flicking 提供了一些实用的方法，可以让你在代码中对轮播图进行控制和操作。

goTo(index: number, duration?: number, event?: boolean)

移动到指定索引的轮播元素。

  • index：索引。
  • duration：过渡时间。
  • event：是否触发事件。

getNextElement(): HTMLElement

获取下一个轮播元素。

getPrevElement(): HTMLElement

获取上一个轮播元素。

getCurrentElement(): HTMLElement

获取当前轮播元素。

示例代码

下面是一个完整的示例代码：

--------- -----
----- ----------
------
  ----- ----------------
  --------------------- ------------
  ----- ---------------- -----------------------------------------------------
  -------
    --------------- -
      ------ -----
      ------- ------
      ----------------- -----
      -------- -----
      ---------------- -------
      ------------ -------
      ---------- ----
    -
    ------------------------------- -
      ----------------- -----
    -
  --------
-------
------
  ---- -----------------
    ---- --------------------------
      ---- ------------------------
        ---- ---------------------------- -------
        ---- ---------------------------- -------
        ---- ---------------------------- -------
      ------
    ------
  ------

  ------- ----------------------------------------------------------------
  --------
    ----- -------- - --- ------------------------ -
      ----------- -----
      --------- -----
      --------- ----
      ---------- --------- --------
    ---
  ---------
-------
-------

这样，就可以在网页中显示一个基本的轮播图了。可以通过调整配置选项和添加回调函数来实现更多自定义的功能。

来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/5eedcbb1b5cbfe1ea061265f

阅读全文

猜你喜欢

  • Fastify 入门：安装和使用指南

    Fastify 是 Node.js 上一个快速且低延迟的 Web 框架，主要用于构建高效的 Restful API。与其他 Node.js 框架相比，Fastify 的性能更加强大，支持异步编程，具有...

    1 天前
  • 怎样在 Ubuntu 系统中安装 PM2

    PM2是一款开源的Node.js进程管理器，可以帮助我们更方便的管理我们的Node.js应用程序，减少Node.js应用程序宕机的可能性。本文将详细介绍如何在Ubuntu系统上安装PM2，并提供相关示...

    1 天前
  • React 测试工具 Enzyme：一个入门指南

    在前端开发中，我们经常需要对 React 组件进行测试来确保其行为与预期一致。而 Enzyme 就是一款广受欢迎的 React 测试工具，它提供了强大的 API 来帮助我们进行组件测试。

    1 天前
  • 解析 ES12 引入的数字分隔符

    随着 JavaScript 语言的不断发展，ES12 （即 ECMAScript 2021）引入了新的语法：数字分隔符。这个新的语法允许使用下划线（_）来分隔数字，使得数字更加易读和易于理解。

    1 天前
  • 如何在 PWA 中添加自定义的缓存策略？

    随着移动设备的普及和网络技术的不断进步，越来越多的应用程序开始采用 Progressive Web App（PWA）技术。PWA可以将网站应用程序转化为离线可访问、快速响应和具有本地化功能的应用程序，...

    1 天前
  • 如何使用 Babel 将代码转换成 ES2015

    在前端开发中，越来越多的开发者开始将目光投向了新一代的 JavaScript 语言规范 ES2015（也叫作 ECMAScript 6）。ES2015 引入了许多新特性和语言功能，可以让我们写出更加简...

    1 天前
  • Express.js 实现登陆验证教程

    随着互联网的发展，越来越多的网站和应用需要实现用户注册和登录功能。这些功能对于网站和应用的安全性和用户体验至关重要。本文将介绍如何使用 Express.js 实现登陆验证功能，让你的网站和应用更加安全...

    1 天前
  • Redux 中如何使用中间件？

    什么是 Redux 中间件？ Redux 中间件是 Redux 应用程序中的可插入功能，它允许在派发和处理 Redux Action 之间添加其他操作和逻辑。中间件可以处理异步操作、调用 API，添加...

    1 天前
  • 使用 Jest 测试插件——vue-test-utils

    Vue.js 是一个流行的前端 JavaScript 框架，可以帮助我们构建交互式的 web 应用程序。在开发过程中，测试是一个重要的步骤，有助于确保我们的代码在不同情况下的正确性。

    1 天前
  • Sequelize 够用吗？ORM 到底是不是好东西？

    随着前端技术的不断发展，越来越多的开发者开始使用 ORM（对象关系映射）框架来管理数据库。其中，Sequelize 是一个广泛使用的 ORM 框架之一，它可以让你使用 JavaScript 来操作数据...

    1 天前
  • PostgreSQL 10 的新功能和性能优化

    PostgreSQL 是一款功能强大、可扩展性好的关系型数据库，被广泛地用于各种 web 应用和企业应用中。在最新的 PostgreSQL 10 版本中，新增了一些重要的新功能和性能优化，本文将详细介...

    1 天前
  • 如何使用 Socket.io 和 MongoDB 实现聊天室？

    前端技术的发展让实时聊天变得越来越普遍，我们可以通过使用 Socket.io 和 MongoDB 实现一个简单的实时聊天室。在本文中，我们将介绍如何使用这两个技术来实现聊天室。

    1 天前
  • 详解：Dockerfile 中 ADD 与 COPY 的区别

    详解：Dockerfile 中 ADD 与 COPY 的区别 在 Dockerfile 文件中，ADD 和 COPY 都是用于将文件从本地复制到 Docker 镜像中。然而，它们有着不同的用法和作用。

    1 天前
  • Kubernetes 中 RBAC 实现权限控制的方法及注意事项

    在 Kubernetes 中，RBAC 是一种用于授权用户访问 API 资源的方法。通过 RBAC，用户可以设置不同的访问权限，以便于控制 Kubernetes 集群中各种资源的访问情况。

    1 天前
  • 解决 CSS Flexbox 实现横向滚动条的问题

    在开发 Web 应用时，经常需要在页面中实现横向滚动条，使得页面内容能够轮廓展示。实现过程中，CSS Flexbox 布局经常被使用。然而，在使用 Flexbox 实现横向滚动条时，往往会遇到一些问题...

    1 天前
  • 常见错误解决方案 - Express.js 使用

    Express.js 是 Node.js 最流行的 Web 应用程序框架，它提供了简单而强大的 API 来构建 Web 应用。然而，即使是最流行的框架也只是一种工具，使用不当或者疏忽都容易出现问题。

    1 天前
  • Cypress 自动化测试实战：端到端测试篇

    Cypress 是一个现代化的端到端测试工具，它是专门为现代 Web 应用程序打造的。Cypress 拥有丰富的 API，易于使用和学习，同时提供了一个交互式的测试运行器和强大的调试工具。

    1 天前
  • 如何使用 ES11 中的 Promise.allSettled 方法实现批量异步请求

    如何使用 ES11 中的 Promise.allSettled 方法实现批量异步请求 在前端开发中，经常需要发送多个异步请求，这时候我们可以使用 Promise.all 方法来处理，但是如果其中一个请...

    1 天前
  • Next.js HMR 原理解析

    在前端开发中，HMR（热模块替换）已经成为了一个常见的开发技术，可以大大提高开发效率和代码质量。Next.js 是一个流行的 React 服务端渲染框架，它也提供了 HMR 的支持。

    1 天前
  • Redux 中如何处理持久化数据？

    Redux 是一个流行的 JavaScript 应用程序状态管理库，但是我们如何在 Redux 中处理持久化数据？在本文中，我们将探讨一些在 Redux 中处理持久化数据的方法，并提供一些示例代码和最...

    1 天前

相关推荐