NPM 包 react-swipe-to-dismiss 使用教程

阅读时长 5 分钟读完

react-swipe-to-dismiss 是一个基于 React 的滑动删除组件,它能够让用户通过滑动手势非常容易地删除指定的列表元素。该库简单易用,且支持高级自定义配置。在本文中,我们将介绍如何使用 react-swipe-to-dismiss

1. 安装

使用 npm 安装 react-swipe-to-dismiss

2. 示例

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

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

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

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

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

在这个例子中,我们创建了一个包含固定列表项的基础 React 应用,并使用 react-swipe-to-dismiss 对它们进行滑动删除的配置。

3. 配置项

下面是 react-swipe-to-dismiss 可选配置的列表:

属性 类型 必填 默认值 描述
swipeThreshold number 30 触发删除操作的最小滑动距离,单位为像素
backAnimationDuration number 500 恢复删除操作的动画时间,单位为毫秒
offsetThreshold number 60 恢复删除操作的阈值,单位为像素
dismissWidthRatio number 0.5 触发删除操作的滑动占宽度的比例
onDismiss function 当元素被成功地滑动删除时触发的回调函数
onSwipeStart function 开始滑动操作时触发的回调函数
onSwipeEnd function 结束滑动操作时触发的回调函数
disabled boolean false 禁用滑动删除
render function undefined 自定义项元素的渲染方法

4. 自定义样式

可以使用以下 CSS 类名在样式表中定制渲染项元素:

  • .react-swipe-to-dismiss:用于包裹要滑动删除的元素
  • .react-swipe-to-dismiss-item:用于渲染正在提交的项元素
  • .react-swipe-to-dismiss-backdrop:用于渲染透明背景层
  • .react-swipe-to-dismiss-dismissed:用于指示该元素已被滑动删除

例如:

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

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

5. 结语

react-swipe-to-dismiss 的使用非常简单,但其功能强大,可自定义的配置项可以满足不同的需求。希望读者们能从本文中学习到如何使用 react-swipe-to-dismiss,并在实际开发中应用它。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6006735c890c4f7277583fea

纠错
反馈