图片轮播框

注意:这是本网站使用的组件页面

组件页面一般通过[[include]]方式使用。

请不要随意编辑此页面以免造成不必要的崩溃。

如果你需要报告错误,请前往页面讨论区。

评分: +1+x

source.svg

本页面的图片使用方式不是CC BY-NC-SA 4.0协议!
图片保留所有权利,请不要随意使用、引用或者转载此页图片。

这是什么

这是一个性能完备而且使用方式简单、适配全面的图片轮播框。此轮播框的特性包括:

  • 使用简单且功能方便:你只需要分别按顺序填入两组链接,分别是你希望显示的图片点击图片后跳转的链接,组件就能自动生成轮播框体和指示器。
  • 适配性强:你可以任意指定轮播框体的大小,从而极大方便了你在不同设备间实现设计同步的需求。
  • 使用者友好:此组件使用最广泛支持的特性与逻辑制作,使其能满足绝大多数用户的正常浏览需求;此外组件已经做防抖处理,你不会因为多次点击前进导致轮播框抽搐;鼠标悬停时,自动轮播会停止以方便用户细致查看内容。
  • 性能方面:组件已经最大限度减少了DOM树的操作并采用异步函数生成框体以优化本身性能;然而受制于Wikidot的页面渲染逻辑和文件请求带宽限制,若要令你的轮播框工作良好,请使用小体积的图片以及减少一个页面中组件的出现次数(最好一个页面只有一个)。

开发者信息

此组件由SenioriouscSenioriousc于2024年3月1日开发。

参数信息与说明

  • 链接栈imgStacklinkStack必须使用完整的URL地址;
  • 两个链接之间应以半角逗号,分隔;
  • 图片总数与链接总数应该相等,否则组件无法正常工作。
  • 剩余尺寸参数皆为纯数值,不应该再指定单位。

完整参数列表

一般类型(长类型)

[[include :arknights:component:carousel-base |long-type=--]
|imgStack = img1,img2… 图片地址列表,请参照上述说明
|linkStack = links1, links2… 跳转链接列表,同上
|phaseLength = 800 轮播框的宽度,单位为px
|viewportRatio = 4/1 轮播框的宽高比(宽/高)
|autoInterval = 3000 自动播放的时间间隔,单位为ms
|transformSpeed = 500 两个图片跳转的过渡时长,单位为ms
]]


侧边栏类型(短类型)

[[include :arknights:component:carousel-base |short-type=--]
|imgStack = img1,img2… 图片地址列表,请参照上述说明
|linkStack = links1, links2… 跳转链接列表,同上
|phaseLength = 800 轮播框的宽度,单位为px
|viewportRatio = 4/1 轮播框的宽高比(宽/高)
|autoInterval = 3000 自动播放的时间间隔,单位为ms
|transformSpeed = 500 两个图片跳转的过渡时长,单位为ms
|indicatorColor = <color> 选填。指定指示器块的颜色,可以使用所有颜色格式
]]

效果预览

长类型

短类型

注意事项

  • 本组件的“长类型”和“短类型”只是为了区别使用场景而做了不同的操作逻辑,其中:
    • 长类型适用于普通页面,可以用按钮手动操作轮播图前进与后退。
    • 短类型适用于特殊的 div 容器或者侧边栏内,可以用鼠标拖拽控制轮播图前进与后退。
  • 本组件不做移动端适配,请根据需求自定义播放框的大小来实现设备兼容。
  • 本组件展示页的图片不遵循CC BY-NC-SA 4.0协议,请勿以任何方式使用。
除非特别注明,本站内容采用 Creative Commons Attribution-NonCommercial-ShareAlike 4.0 协议授权。