# Effects (切换效果)

# effect

  • 类型:string
  • 默认:slide
  • 可选值:slide(普通位移切换), fade(淡入), cube(方块), coverflow(3d 流), flip(3d 翻转), cards(卡片式), creative(创意性)。

设置 Slide 的切换效果

options: {
    effect: 'fade'
},

# fadeEffect

fade 效果参数。可选参数:crossFade。

默认:false。关闭淡出。过渡时,原 slide 透明度为 1(不淡出),过渡中的 slide 透明度从 0->1(淡入),其他 slide 透明度 0。

可选值:true。开启淡出。过渡时,原 slide 透明度从 1->0(淡出),过渡中的 slide 透明度从 0->1(淡入),其他 slide 透明度 0。

当你的 slide 中图片大小不同时可以用到。

  • 类型:object
options: {
    effect: 'fade',
    fadeEffect: {
        crossFade: true,
    }
},

# cubeEffect

cube 效果参数,可选值:

slideShadows:开启 slide 阴影。默认 true。

shadow: 开启投影。默认 true。

shadowOffset:投影距离。默认 20,单位 px。

shadowScale: 投影缩放比例。默认 0.94。

  • 类型:object
options: {
    effect: 'cube',
    cubeEffect: {
        slideShadows: true,
        shadow: true,
        shadowOffset: 100,
        shadowScale: 0.6
    },
},

# coverflowEffect

  • 类型:object

coverflow 效果参数,可选值:

参数名 默认 描述
rotate 50 slide 做 3d 旋转时 Y 轴的旋转角度
stretch 0 每个 slide 之间的拉伸值,越大 slide 靠得越紧。可使用%百分比
depth 100 slide 的位置深度。值越大 z 轴距离越远,看起来越小。
modifier 1 depth 和 rotate 和 stretch 的倍率,相当于 depthmodifier、rotatemodifier、stretch*modifier,值越大这三个参数的效果越明显。
options: {
    effect: 'coverflow',
    slidesPerView: 3,
    centeredSlides: true,
    coverflowEffect: {
        rotate: 30,
        stretch: 10,
        depth: 60,
        modifier: 2
    },
},

# flipEffect

  • 类型:object

3d 翻转参数:

limitRotation:限制最大旋转角度为 180 度,默认 true。

options: {
    effect: 'flip',
    flipEffect: {
        limitRotation: true,
    }
},

# cardsEffect

  • 类型:object

卡片参数:

rotate:卡片是否发生旋转偏移,默认为 true。

perSlideOffset:每张幻灯片的偏移距离,默认为 8。

perSlideRotate:每张幻灯片的旋转角度,默认为 2。

options: {
    effect: 'cards',
    cardsEffect: {
        rotate: false,
        perSlideOffset: 8,
        perSlideRotate: 2
    }
},

# creativeEffect

  • 类型:object

设置 effect 为 creative 后开启创意切换。由于创意切换的 Slide 全部层叠在当前窗口,因此你还需要设置 creativeEffect 来制作想要的效果。

参数名 类型 默认 描述
prev CreativeEffectTransform prve(左、上)Slide 的变形方式
next CreativeEffectTransform next(右、下)Slide 的变形方式
limitProgress number 1 设置 progress 应用的数量限制(变形数量)。默认 1,上一页/下一页之后的所有 Slide 都具有相同的状态。如果设置 2,则前/后第二张开始的所有 Slide 具有相同的状态。
perspective boolean true 开启景深。如果你的切换包含 3D 变形(translateZ, rotateX, rotateY )时不可禁止此参数。
progressMultiplier number 1 设置 progress 的乘数(变形强度)。例如效果是 200,乘数为 2 则效果变成了 400。

prev 参数详情:

translate: (string | number)[]; // 位移,例如["5%", 0, -200]
rotate ? : number[]; //旋转,单位deg,例如[0, -100, 90]
opacity ? : number; //透明度
scale ? : number; //缩放
shadow ? : boolean; //Slide内部阴影
origin ? : string; //变形中心点,例如'left bottom'

next 参数详情:

translate: (string | number)[]; // 位移,例如["5%", 0, -200]
rotate ? : number[]; //旋转,单位deg,例如[0, -100, 90]
opacity ? : number; //透明度
scale ? : number; //缩放
shadow ? : boolean; //Slide内部阴影
origin ? : string; //变形中心点,例如'left bottom'