npm 包 react-calendar-timeline-extended-drop 使用教程

阅读时长 6 分钟读完

介绍

react-calendar-timeline-extended-drop 是 React 开发的一个时间轴组件,支持拖拽、缩放等交互操作,非常适合用于展示时间相关的数据,如日程安排、时间线等。

安装

使用 npm 进行安装:

使用

基本用法

在组件中引入组件库的 Timeline 组件,传入需要展示的时间轴数据,就可以生成一个基本的时间轴了:

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

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

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

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

上述代码中,groups 数组表示要展示的时间轴分组,每个分组至少包含 idtitle 两个属性。items 数组表示要展示的时间轴条目,每个条目至少包含 idgrouptitlestart_timeend_time 五个属性。其中,group 表示该条目所属的分组的 id 值,start_timeend_time 表示该条目的开始和结束时间。

defaultTimeStartdefaultTimeEnd 属性表示默认展示的时间轴范围。在上述代码中,时间线的范围是从 0 到 200。

拖拽和缩放

react-calendar-timeline-extended-drop 组件支持使用鼠标进行拖拽和缩放操作。使用鼠标左键可以拖拽整个时间轴,使用鼠标右键可以进行时间轴的缩放。

自定义样式

可以通过修改组件的 classname 或使用 styled-components 等方式来自定义时间轴的样式:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

组件事件

react-calendar-timeline-extended-drop 组件支持多种事件,可以用来实现拖拽、缩放等复杂操作。以下是常用事件及其使用方式:

  • onItemDrag:当某个时间轴条目被拖拽时触发,可以获取拖拽前和拖拽后的条目信息和位置。
  • onItemResize:当某个时间轴条目被缩放时触发,可以获取缩放前和缩放后的条目信息和位置。
  • onTimeChange:当时间轴范围发生变化时触发,可以获取变化前和变化后的时间轴范围。

以下是一个示例,用于演示如何监听 onItemDrag 事件并弹窗显示拖拽前后的条目信息:

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

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

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

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

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

结语

react-calendar-timeline-extended-drop 是一个非常实用的时间轴组件,可以用于展示时间相关的数据,支持拖拽、缩放等交互操作。本教程介绍了组件的基本用法、拖拽和缩放功能、自定义样式和组件事件等内容,希望对大家有所帮助。

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

纠错
反馈