npm 包 @gabrielsiedler/react-slick 使用教程

阅读时长 7 分钟读完

介绍

@gabrielsiedler/react-slick 是一个基于 react 和 slick.js 的响应式轮播组件。使用这个组件可以方便地创建漂亮的轮播图,并且具有丰富的配置选项和 API。

安装

使用

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

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

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

配置选项

@gabrielsiedler/react-slick 提供了丰富的配置选项,可以用来定制轮播组件的外观和行为。

accessibility

类型:boolean,默认:true

是否启用辅助功能支持。

adaptiveHeight

类型:boolean,默认:false

轮播组件的高度是否根据当前显示的幻灯片自适应。

arrows

类型:boolean,默认:true

是否显示左右箭头。

autoplay

类型:boolean,默认:false

是否自动播放幻灯片。

autoplaySpeed

类型:number,默认:3000

自动播放下一张幻灯片的时间间隔(毫秒)。

centerMode

类型:boolean,默认:false

是否启用居中模式。启用后,当前幻灯片会在轮播组件的中央,两侧的幻灯片会部分显示。

centerPadding

类型:string,默认:'50px'

居中模式时两侧幻灯片的间距。

className

类型:string,默认:''

轮播组件的 class 名称。

dots

类型:boolean,默认:false

是否显示分页器(小圆点)。

dotsClass

类型:string,默认:'slick-dots'

分页器的 class 名称。

draggable

类型:boolean,默认:true

是否支持拖拽。

fade

类型:boolean,默认:false

是否使用淡入淡出效果。

focusOnSelect

类型:boolean,默认:false

是否在点击幻灯片时自动聚焦。

infinite

类型:boolean,默认:true

是否无限循环幻灯片。

initialSlide

类型:number,默认:0

初始显示的幻灯片索引。

lazyLoad

类型:string,可选值:'ondemand', 'progressive',默认:null

设定图片懒加载方式,使用场景:动态插入幻灯片。

swipe

类型:boolean,默认:true

是否支持滑动。

swipeToSlide

类型:boolean,默认:false

是否允许滑动到中间的幻灯片。

touchMove

类型:boolean,默认:true

是否支持触摸滑动。

API

@gabrielsiedler/react-slick 还提供了一些方便的 API,可以控制轮播组件的行为。

slickNext()

切换到下一张幻灯片。

slickPrev()

切换到上一张幻灯片。

slickGoTo(index: number)

切换到指定索引的幻灯片。

示例代码

下面是一个完整的轮播组件示例,包含了常用的配置选项和 API。

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

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

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

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

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

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

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

结语

@gabrielsiedler/react-slick 是一个非常好用的轮播组件库,它提供了丰富的配置选项和 API,并且支持多种不同的轮播效果。在实际开发中,我们可以根据实际情况选择合适的配置选项和 API 来满足需求。

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

纠错
反馈