Swiper 更新日志

12.0.1 (2025-09-11)

错误修复

• 导航: 调整相邻导航样式 (98440d9)

12.0.0 (2025-09-11)

错误修复

• 核心: 修复 slidesOffsetBefore & slidesOffsetAfter 与 centeredSlides、slidesPerView & loop 组合使用时的问题 (#8038) (74cc297)，关闭 #7298 #7956 #6916
• 卡片效果: 修复未设置旋转时垂直方向的偏移 (a248ca1)，关闭 #8075
• 获取设备: 调整正则表达式 (60bb79b)，关闭 #8057
• 类型: 修正 getSlideTransformEl 的类型 (b34bdce)，关闭 #8054

新特性

• a11y: 添加 wrapperLiveRegion 参数，用于在无障碍模块中禁用 wrapper 实时区域 (#8061) (d03044e)
• 将导航图标改为 SVG (264603c)，关闭 #6652 #4990
• 删除 LESS 和 SCSS 样式，改用 CSS (118ec66)
• 虚拟: 为 fixed slide dimensions 与 slidesPerView auto 结合添加 slidesPerViewAutoSlideSize 参数 (d472144)，关闭 #8041 #7796

11.2.10 (2025-06-28)

错误修复

• 核心: 修复 grid 下的 clickedIndex (863d8bd)

11.2.9 (2025-06-27)

错误修复

• 核心: 清除 loopCreate() 中的空白 slide (#8033) (377d53c)
• 核心: 转换类名为选择器时转义方括号 (#8014) (0c53ee8)
• 核心: 当 grid.rows > 1 时，slideTo 函数无法工作 (#8030) (1fde9d3)
• 核心: 修复 loop 和 slideToClickedSlide / slideToLoop 与 centeredSlides 结合使用时的问题 (b6692e2)，关闭 #8031
• 元素: 不在布尔值上设置子属性 (090caa1)，关闭 #8003
• 键盘: 在键盘模块中检测 contenteditable 元素 (#8006) (fcd434a)
• vue: 添加缺失的事件 (839cafb)，关闭 #8002

11.2.8 (2025-05-23)

错误修复

• 虚拟: 修复虚拟 slide 中的错误 (7a53208)，关闭 #7997

11.2.7 (2025-05-19)

错误修复

• 核心: 修复 slideResetTransition 事件 (#7989) (473ec25)
• 核心: 使用可信类型设置 innerHTML (8a46954)，关闭 #7961
• react,vue: 修复启用虚拟模式时，效果中未渲染的 slide (e4e1680)，关闭 #7730
• 类型: 在 swiper-class.d.ts 中添加 enabled 属性 (#7973) (ccd96dc)
• 类型: coverflow 效果可以是数字或百分比字符串 (#7931) (4d988d8)
• 类型: 修复 effect 参数类型 (#7945) (42eec07)
• vue: 添加缺失的 props (#7966) (6aa8d05)

11.2.6 (2025-03-19)

错误修复

• 卡片/循环: 改进卡片效果下的循环行为 (9a258d4)，关闭 #7917
• 核心: 修复循环模式下，当 slide 数量不足以填充时，initialSlide 的问题 (16818e2)，关闭 #7780
• 核心: 修复 RTL 模式下的 touchReleaseOnEdges (d841428)，关闭 #7179

11.2.5 (2025-03-04)

错误修复

• 文档: 修正 pagination render 函数的结构 (b259723)，关闭 #7897 #7896
• 缩略图: 修正缩略图重新初始化 (1cf24d4)，关闭 #7880
• 缩放: 修复 zoom.in() 函数的 transform origin (#7904) (f7febe1)

新特性

• 检查 loopDestroy 中 slidesEl 是否定义 (#7906) (ced30cb)

11.2.4 (2025-02-14)

错误修复

• 恢复与 ES2019 的兼容性 #7891 (#7892) (b4fbbb3)

11.2.3 (2025-02-12)

错误修复

• 元素: 移除循环中的无限预加载器 (#7886) (c0d3ece)

新特性

• 核心: 导出 swiper-vars.scss 以实现可覆盖性 (#7883) (0b688a1)，关闭 #7882
• 更新 ssr-window 到最新版本 (c521888)

11.2.2 (2025-01-31)

错误修复

• 卡片: 修复循环模式下 slide 交换问题 (e012e34)，关闭 #7823
• 核心: 修复自由模式下 slidePrev 问题 (a3fee36)，关闭 #7869
• 虚拟: 修复 Safari 中元素无法滑动的问题 (5abdbfd)，关闭 #7679

11.2.1 (2025-01-10)

错误修复

• 核心: 添加对 HTMLSlotElement 支持的检查 (#7840) (56700e5)
• 核心: 自动播放参数中的拼写错误 (#7848) (69113c9)

11.2.0 (2025-01-02)

错误修复

• 核心: 修复 elementIsChildOf 对嵌套 Web 组件返回 false 的问题 (#7762) (8136607)，关闭 #7761
• 缩放: 确保 zoom 模块的数组在 onTouchEnd 时清空，以修复 #7304 (#7830) (21610bd)

新特性

• 核心: 允许使用 CSS 选择器作为 breakpointsBase (#7818) (44d3443)
• 缩放: 添加在鼠标移动时平移图像的功能 (#7831) (c4619bb)，关闭 #7306

11.1.15 (2024-11-18)

错误修复

• react: react 严格模式下缩略图双重初始化错误 (#7789) (9dece7d)
• scss: Dart Sass 3.0.0 兼容性 (fbd2ba4)，关闭 #7772 #7771
• 类型: 移除 'Lazy' 声明 (#7739) (40a705e)
• 类型: slidesEl、slidesGrid 和 slidesSizesGrid 的类型定义 (#7768) (fb59a41)

11.1.14 (2024-09-12)

错误修复

• 核心: 修复在不同输入框上触摸开始时移动端输入框失焦的问题 (66c5dd1)，关闭 #7728
• 元素: 查询 swiper.hostEl 获取导航按钮 (#7714) (#7716) (d0b6abd)
• 缩放: 在超时中调用 allowTouchMove 之前添加 sanity check (#7723) (869bb84)

11.1.12 (2024-09-01)

错误修复

• 卡片: 修复卡片效果样式泄露 (0be4c6a)，关闭 #7712

新特性

• a11y: 添加 containerRole 参数 (#7708) (1542c01)

11.1.11 (2024-08-28)

错误修复

• 当 slidesPerView: 'auto' 且 swiper-container 宽度大于 slide 宽度时，centeredSlides 与 centeredSlidesBounds 无法正确工作 (#7696) (c11172a)
• 元素: 修复元素样式以保持正确的覆盖顺序 (f26036f)，关闭 #7704
• 虚拟: 修复启用虚拟模式时绕过初始平移检查的问题 (df957bb)，关闭 #7699

11.1.10 (2024-08-21)

错误修复

• 分页: 修复 swiper 无限循环滚动跳动问题 (#7690)
• 缩放: 修复 currentScale 设置为 1 后 zoomIn 的问题 (#7663) (94173da)

11.1.9 (2024-07-31)

错误修复

• 核心: 修复 centeredSlides 导致循环缺失 slide 的问题 (4847fcb)，关闭 #7584
• 核心: 修复 swiper-effect-utils.d.ts 的类型 (#7655) (4875f26)
• 鼠标滚轮: 修复 Swiper 销毁后事件处理的问题 (82ae434)，关闭 #7654

新特性

• 为 minTranslate 和 maxTranslate 函数添加类型 (#7647) (450c57a)

11.1.8 (2024-07-26)

错误修复

• 核心: 修复 utils/elementIsChildOf 中的拼写错误 (#7649) (575e715)

11.1.7 (2024-07-24)

错误修复

• 核心: 修复元素子节点检测 (7ec975c)，关闭 #7636

11.1.6 (2024-07-23)

错误修复

• 控制器: 修复元素中的双向控制 (6eec16b)，关闭 #7628

新特性

• a11y: 为 a11y 模块添加新属性 - scrollOnFocus (#7632) (f4f7da0)
• 元素: 添加对使用 slot 作为 swiper wrapper 的支持 (#7624) (e374e06)

11.1.5 (2024-07-15)

错误修复

• 元素: 修复 observer 监视 slide 的问题 (7cffede)，关闭 #7598
• 改进 Safari 中的 3d 旋转修复 (cb83879)，关闭 #7532
• 更新 navigation.scss 以移除 SASS 弃用警告 (#7612) (a3e0bf8)
• vue: 添加 breakpointsBase 类型 (4adb85b)，关闭 #7607

11.1.4 (2024-05-30)

错误修复

• a11y: 修复启用循环模式时焦点滑动的问题 (fc8ed1a)，关闭 #7540
• 核心: 检查销毁队列中的 swiper.el (39a3e53)，关闭 #7530
• 导航: 点击导航按钮时阻止隐藏 (c0f7bb6)，关闭 #7559
• vue: 在循环 + 虚拟模式下，当 slide 数量较少时，避免两次渲染相同的 slide vnode (#7556) (5737f03)
• 缩放: 修复缩放时可能发生的 slide 切换问题 (f67308c)

11.1.3 (2024-05-13)

错误修复

• 修复类型导入 (57923db)，关闭 #7529

11.1.2 (2024-05-13)

错误修复

• 自动播放: 触摸移动时保持 0 过渡，超时延迟为 0 (8ccb08e)，关闭 #7515
• 核心: centerInsuffientSlides 考虑偏移量 (#7437) (5a271ff)
• 类型: 修复 SwiperModule、slideTo、effectInit 类型 (#7428) (bc61bce)

性能改进

• 不移除和重新添加未更改 slide 的可见性类，以防止不必要的样式重新计算（这种性能差异在用鼠标或触摸移动 slide 时最明显，因为每次键盘/触摸事件都会触发 updateSlidesProgress）(#7505) (2c08227)

11.1.1 (2024-04-09)

错误修复

• 缩放: 修复缩放平移无法阻止使用触摸切换 slide 的问题 (f73cc2a)，关闭 #7308

11.1.0 (2024-03-28)

错误修复

• a11y: 修复箭头导航中“enter”键无法工作的问题 (aac2dcf)，关闭 #7423
• a11y: 阻止错误的焦点处理程序 (a7c260a)，关闭 #7406
• 核心: 仅在更改时添加/移除 slide 类 (3312fba)，关闭 #7356
• 核心: 不要对简单的尺寸调整修复循环 (641793f)，关闭 #7325
• 核心: 修复销毁的 swiper 调用 slideTo 方法时抛出的错误 (8c6a3c6)，关闭 #7416
• 核心: 在断点中处理 grabCursor (e853908)，关闭 #7364
• 核心: 在 translateTo 调用时重置 animating 标志 (7da50bf)，关闭 #7403
• 滚动条: 修复警告 (e5371f7)，关闭 #7415
• 缩略图: 修复 thumbs .swiper 类型属性以接受字符串 (5b0fa84)，关闭 #7421
• 虚拟: 当设置 initialSlide 时不渲染第一个 slide (bab9230)，关闭 #7353
• 缩放: 修复 SVG 元素的平移 (eed8a5b)，关闭 #7352

11.0.7 (2024-02-27)

错误修复

• 核心: 修复 centeredSlides 和 slidesPerView auto 时初始 slide 索引偏移的问题 (#7319) (cae9c2d)
• 历史: 修复虚拟 slide 中设置历史记录的问题 (d4de17b)，关闭 #7327
• react: 确保虚拟模式下的 key 是唯一的 (829a253)，关闭 #7329

新特性

• 添加 swiper-effect-utils (df5f873)，关闭 #7336
• 缩放: 添加将最大缩放限制为原始图像大小 100% 的功能 (#7311) (645f266)

11.0.6 (2024-02-05)

错误修复

• 添加可选的 swiperElementNodeName 参数，以实现更灵活的 Web 组件使用 (#7284) (178511f)
• 修复 'initialSlide:0' 和 'slidesPerView:auto' 组合会导致第一个 slide 位置偏移的行为 (e5c04c3)，关闭 #7216
• Safari Webview 的 3D 修复 (d42ce05)，关闭 #7167
• 滚动条: 在 changeDirection 上正确更新滚动条 (6bbb73d)，关闭 #7263
• SwiperOptions 文档中关于 loopAddBlankSlides 的说明 (#7289) (cbc3dba)

新特性

• 核心: 阻止 Swiper 销毁时运行 .slideTo 方法 (05f9c64)，关闭 #7265

11.0.5 (2023-11-22)

错误修复

• 核心: slidesPerView: auto 时滑动到最后一个 (#7183) (2e3f47d)
• 模块/a11y: 过滤掉错误的分页元素 (#7201) (a044626)

新特性

• 核心: 新增 slidesUpdated 事件 (8a0c7c4)

11.0.4 (2023-11-09)

错误修复

• effectx: 修复 Safari 在旋转到 90 度时的问题 (e005b69)，关闭 #7167

11.0.3 (2023-10-26)

错误修复

• 核心: 修复旧版条件下，启用缩放时阻止触摸移动的问题 (2f64043)，关闭 #7137
• 核心: 阻止循环修复时的观察者更新 (7a5eacc)，关闭 #7135

11.0.2 (2023-10-25)

错误修复

• 核心: 正确处理 loopAdditionalSlides 参数 (3f5e05d)

11.0.1 (2023-10-24)

错误修复

• 类型: 修复 eventsPrefix 类型 (fd0f601)

11.0.0 (2023-09-24)

错误修复

• 自动播放: 修复停止/开始后负自动播放值，修复自由模式下的自动播放 (8bef84d)，关闭 #7084
• 自动播放: 修复过渡期间悬停时 pauseOnPointerEnter 的问题 (5080d95)，关闭 #7107
• 核心: 在行更改时移除 grid 类 (2f65e89)，关闭 #7053
• 元素: 正确响应对象参数赋值 (f23c742)
• 滚动条: 允许滚动条参数中包含多个类 (89a6f71)，关闭 #7096

新特性

• 核心: 添加完全可见的 slide 类 (902a4c4)，关闭 #6773
• 核心: 添加对原生触摸事件的处理 (74bb1cc)，关闭 #6478 #6381 #6897
• 核心: grid 的循环支持，新增 loopAddBlankSlides 参数 (b5db223)
• 核心: 移除 loopedSlides 参数，添加 loopAdditionalSlides 参数 (d647985)
• 核心: 重新设计循环模式 (2a99dbd)
• 核心: 更新循环模式逻辑并降低要求 (703ede6)
• 元素: 使 eventPrefix 参数默认值为 swiper (88d463a)
• 核心: 将默认容器溢出设置回 hidden (88941a8)

10.3.1 (2023-09-28)

错误修复

• 自动播放: 修复 disableOnInteraction 激活时自动播放停止的问题 (ecfb3fb)，关闭 #7060 #7059
• 类型: 自定义 HTML 标签的检测 (#7055) (c55f76d)

10.3.0 (2023-09-21)

错误修复

• 核心: 在断点上正确销毁或创建循环 (12a44fb)，关闭 #6967
• 核心: 如果 runCallbacksOnInit 禁用，不要在 initialIndex 上调用 realIndexChange (48c4e0a)，关闭 #6976
• 核心: 修复使用元素 slide slot 时 slideToClickedSlide 的问题 (af0519c)，关闭 #6958
• 核心: 修复稍后初始化的 slide 中懒加载预加载器的问题 (e4fddc0)，关闭 #6946
• 核心: 修复 centeredSlides slide 到开头时的循环 (c496835)，关闭 #7011
• 核心: 修复循环和 cssMode 中的 loopFix (8180a52)，关闭 #6919
• 核心: 修复循环模式下忽略 allowSlidePrev/Next 的问题 (1b74619)，关闭 #6987
• 核心: 在行更改时移除 grid 类 (908becc)，关闭 #7053
• 元素: 正确响应对象参数赋值 (2ef1ff5)
• 元素: 不要冒泡 hashchange 事件 (106a3d7)，关闭 #6943
• 元素: 修复布尔模块参数更新问题 (1cc359e)，关闭 #6947
• 导航: 修复启用时的 lock 类 (ea39c33)，关闭 #7009
• react: 添加 breakpointsBase 参数 (0eb4122)，关闭 #7014
• react: 修复 react 组件 props 类型 (1cd412e)，关闭 #7000
• 滚动条: 为 swiper-scrollbar 添加 'touch-action: none' (#7024) (9542d09)
• 虚拟: 修复循环模式和 initialSlide 启用时的问题 (f4afd9d)，关闭 #6945
• 虚拟: 修复移除嵌套 slide 的问题 (c3321e1)，关闭 #7005
• 虚拟: 在 removeSlide 时重新计算缓存 (96e5166)，关闭 #7020
• vue: 添加 breakpointsBase 参数 (6800dbb)
• 缩放: 修复文档滚动时缩放原点的问题 (2cf3fc2)，关闭 #6950 #6955

新特性

• 核心: 允许 createElements 处理带 {enabled: true} 的对象参数 (abf8405)
• 核心: 使 slidesPerViewDynamic 公开 (ae434b0)，关闭 #7036

10.2.0 (2023-08-17)

错误修复

• 自动播放: 修复过渡期间自动播放暂停的问题 (db9b17f)，关闭 #6896
• 控制器: 修复循环模式问题 (fbb84fe)，关闭 #6659
• 核心: 修复当 swiper-wrapper 启用 transition-delay 时触摸移动和循环行为的问题 (ac27d02)
• 核心: 处理 contextmenu 事件 (721ccaf)，关闭 #6692
• 元素: 修复动态添加元素时缺少 part 的问题 (db5b5d6)，关闭 #6899
• 元素: 修复传递给组件根目录的元素上的视差效果 (265e466)
• 元素: 修复懒加载预加载器和图像的查找不正确问题 (64513ac)，关闭 #6901
• 元素: 修复 fade 效果中 pointer-events:none 的问题 (2dcb802)，关闭 #6908
• 分页: 修复循环模式下有时会带过渡切换 slide 的问题 (3d7dc58)，关闭 #6856

新特性

• 分页: 允许使用多个 clickableClass (703d13b)，关闭 #6741

10.1.0 (2023-08-01)

错误修复

• 核心: 修复循环模式边缘位置的闪烁问题 (bf29843)，关闭 #6673
• 核心: 仅在 swiper-container 上设置 isElement (#6870) (2f61fda)
• 包: 修复 ES 模块的源映射 (#6866) (#6863) (5e88c4b)
• 模块: 过滤掉错误元素 (#6823) (e1b7254)
• 鼠标滚轮: 修复自由模式下的 releaseOnEdges (8a83360)，关闭 #6770 #6799
• 缩放: 修复元素中的图像移动 (89d9aa5)，关闭 #6847

新特性

• 元素: 支持将 slide 作为 slot (697b028)
• 类型: 使 VirtualOptions 泛型化 (#6852) (068ee68)

10.0.4 (2023-07-08)

错误修复

• 元素: 修复 Safari < 16.4 中的问题 (e53fc07)，关闭 #6831

v10.0.3 (2023-07-03)

新特性

• 为目标浏览器不支持 clip 时添加 overflow:hidden 作为 fallback (#6807) (5d8d6f9)
• 元素: 如果不支持 adopted stylesheet，则使用普通的 <style> 标签 (18613df)

v10.0.2 (2023-07-03)

错误修复

• 类型: 修复模块导入 (a1b4cf6)，关闭 #6803

v10.0.1 (2023-07-03)

错误修复

• 类型: 修复 swiper/modules 的类型 (fa6e597)

10.0.0 (2023-07-03)

新特性

• 调整 browserslist 到 iOS >= 15 (96a4e7e)
• 重新设计包以使用 .mjs 文件，所有脚本和样式均已压缩 (a267785)
• 彻底重构包中的脚本结构 (2c87f13)
• 将包文件从 .esm.js 重命名为 .mjs (7a17821)
• 浏览器 ES 模块 (ab20bd1)
• 将 swiper 容器的 overflow 更改为 clip (#6738) (a8447b7)
• 元素: 属性可以接受 JSON 字符串 (5b93954)
• 元素: 高度重构 Swiper web 组件 (a6f8a0f)
  • 导航箭头使用 SVG 代替字体
  • 将 Shadow DOM 布局更改为在内部包含 <div class="swiper">
  • 组件样式现在使用 adoptedStylesheets 添加
  • 不再进行全局样式注入
• 为 iOS 设备设置 wrapper 的 transform 3d (90c590d)
• 调整类型导出以兼容 Node 16+ (30ce8e0)

错误修复

• package.json 的 TypeScript 导出 (#6626) (e9e8039)

10.0.0-beta.5 (2023-06-26)

新特性

• 调整 browserslist 到 iOS >= 15 (96a4e7e)

10.0.0-beta.3 (2023-06-23)

新特性

• 重新设计包以使用 .mjs 文件，所有脚本和样式均已压缩 (a267785)

10.0.0-beta.2 (2023-06-23)

新特性

• 彻底重构包中的脚本结构 (2c87f13)
• 将包文件从 .esm.js 重命名为 .mjs (7a17821)

10.0.0-beta.1 (2023-06-23)

错误修复

• package.json 的 TypeScript 导出 (#6626) (e9e8039)

新特性

• 浏览器 ES 模块 (ab20bd1)
• 将 swiper 容器的 overflow 更改为 clip (#6738) (a8447b7)
• 元素: 属性可以接受 JSON 字符串 (5b93954)
• 元素: 高度重构 Swiper web 组件 (a6f8a0f)
  • 导航箭头使用 SVG 代替字体
  • 将 Shadow DOM 布局更改为在内部包含 <div class="swiper">
  • 组件样式现在使用 adoptedStylesheets 添加
  • 不再进行全局样式注入
• 为 iOS 设备设置 wrapper 的 transform 3d (90c590d)
• 调整类型导出以兼容 Node 16+ (30ce8e0)

9.4.1 (2023-06-13)

错误修复

• 核心: 修复 9.4.0 引入的 freeMode 调用问题 (581eea8)，关闭 #6751

9.4.0 (2023-06-12)

错误修复

• 核心: lazyPreloadPrevNext 在 grid 模式下不工作 (883f006)，关闭 #6725
• 核心: 修复 centeredSlidesBounds 在 slide 数量不足时的问题 (93b4279)，关闭 #6689
• 核心: 修复隐藏滑块中 swiperSlideSize 的错误 (36ef2e6)，关闭 #6718
• 核心: 修复 RTL 模式下 allowSlideNext 的问题 (d61da52)，关闭 #6737
• 核心: 修复断点中导航可以禁用问题 (1fd36ad)，关闭 #6746
• 核心: 修复在活动 slide 之前预加载 lazyPreloadPrevNext 的问题 (d2f718c)，关闭 #6684
• 核心: lazyPreloadPrevNext 在循环模式下不工作 #6724 (#6726) (69acab4)
• 卡片效果: 修复 RTL 模式下的问题 (e402f05)，关闭 #5534
• 哈希导航: 如果未启用虚拟模式，则使用旧方法获取活动 slide 元素 (#6704) (db7e72f)

新特性

• 核心: cssMode 现在支持 freeMode (abe1ec7)
• 元素: 为分页小点添加 part="bullet[-active]" (8b4cccd)，关闭 #6717

9.3.2 (2023-05-15)

错误修复

• 核心: 如果 spv !== auto 且无 autoHeight，则不在懒加载时调用 update() (378a3c6)
• 核心: 在 css 模式下，不在懒加载时调用 update() (efc294c)
• 核心: 修复 Support 模块中 smoothScroll 检查的问题 (e0f4ae4)
• 元素: 修复 injectStylesUrls 无法正常工作的问题 (6a50d45)，关闭 #6662
• 元素: 根据 prop 值移除/重新添加导航、分页、滚动条元素 (45f8d4a)，关闭 #6672
• 哈希导航: 处理滑动到不存在的哈希值 (#6681) (7f3fa96)

新特性

• 为 effect 参数添加 string 类型 (7340629)，关闭 #6676
• 鼠标滚轮: 添加 noMousewheelClass 参数 (0fcd210)
• 鼠标滚轮: 支持 swiper-no-mousewheel 忽略类 (#6671) (c9130c3)
• react: 从 'swiper/react' 导出 SwiperClass 类型 (6768efe)，关闭 #5500

9.3.1 (2023-05-10)

错误修复

• 元素: 修正 types 中 HTMLElementEventMap 的正确扩展 (d6a0aca)，关闭 #6657

新特性

• 元素: 在 TS 声明中添加所有事件参数 (abb0688)

9.3.0 (2023-05-08)

错误修复

• a11y: 将通知 span 添加到 Swiper 元素中的 shadow root (aa83a03)，关闭 #6634
• 核心: 修复 spaceBetween 设置为 % 时的情况 (446af7e)，关闭 #6647
• 元素: 不要重新初始化被父级 swiper 循环重新排列的嵌套 swiper (926828a)，关闭 #6642
• 元素: 不要在每次 connected 时渲染 swiper (5a5ebb4)

新特性

• 元素: 元素事件类型 (83774fa)
• 元素: 添加 shadow parts (e4f3def)，关闭 #6594
• 元素: 更复杂的 ts 定义 (4cab52d)

9.3.0-beta.1 (2023-05-08)

错误修复

• a11y: 将通知 span 添加到 Swiper 元素中的 shadow root (aa83a03)，关闭 #6634
• 核心: 修复 spaceBetween 设置为 % 时的情况 (446af7e)，关闭 #6647
• 元素: 不要重新初始化被父级 swiper 循环重新排列的嵌套 swiper (926828a)，关闭 #6642
• 元素: 不要在每次 connected 时渲染 swiper (5a5ebb4)

新特性

• 元素: 添加 shadow parts (e4f3def)，关闭 #6594
• 元素: 更复杂的 ts 定义 (4cab52d)

9.2.4 (2023-04-21)

错误修复

• 核心: 修复虚拟 slide 中的 autoHeight (dd30829)，关闭 #6570
• 循环: 当 spv 为 "auto" 时，在循环修复之前更新 slide grids (035e79d)，关闭 #6599
• 虚拟: 修复虚拟 slide 中的最后一个 slide 索引检查 (154f048)，关闭 #6595

新特性

• 哈希导航: 新增 getSlideIndex，用于通过哈希指定 slide 索引 (3eb0ae2)，关闭 #6588

9.2.3 (2023-04-17)

错误修复

• 自动播放: 使用本地作用域处理自动播放 resize timeout (4f665bd)，关闭 #6590
• 将 defineProperty 设置为可配置，因为它在压缩时会中断。(#6586) (26cfbaa)
• 分页: 修复循环中可点击分页的问题 (479a7f5)，关闭 #6518 #6460 #6587 #6451

9.2.2 (2023-04-14)

错误修复

• 元素: 修复重新定义 injectStyles 的问题 (36ddaf2)，关闭 #6584

9.2.1 (2023-04-14)

错误修复

• 控制器: 添加条件，如果 swiper 控制器被销毁，则提前返回 (#6555) (3fbec6e)
• 控制器: 每个滑块的正确插值 (706fdf8)，关闭 #6506
• 控制器: 修复 0 转换时的控制器乘数 (4b8bd02)，关闭 #6498
• 元素: 添加 injectStyles 以作为 props 接受 (7c1c5d3)，关闭 #6578
• 分页: 在方向改变时更新分页方向类 (e6247d9)，关闭 #6511
• vue: 修复深层 slot (642b455)，关闭 #6574

新特性

• 虚拟: 对使用虚拟 slide 的超大滑块进行补丁 (#6533) (e48daa5)

9.2.0 (2023-03-31)

错误修复

• 控制器: 添加 null 类型 (3177936)，关闭 #6505
• 控制器: 阻止受控 swiper 在销毁时被调用 (#6501) (a266b78)，关闭 #6491
• 鼠标滚轮: 将 lastClickTime 初始化为很旧的时间 (#6497) (0983ded)，关闭 #6496
• 分页: 修复 pagination.d.ts render 函数返回类型 (#6499) (34973a1)
• 缩放: 修复敏感触摸屏双击缩放的问题 (7f5c626)
• 缩放: 缩放时重置 transform origin (7f7f57e)

新特性

• 核心: lazyPreloadPrevNext 选项用于预加载前/后图像 (#6544) (1cb3233)
• lazyPreloadPrevNext 选项用于预加载前/后图像 (6d08635)
• 缩放: 大幅改进 pinch-zoom 手势处理 (6016a50)

9.1.1 (2023-03-16)

错误修复

• 核心: 修复使用自定义 slideActiveClass 时的循环 (#6495) (756ecdb)
• 元素: 在 disconnectedCallback 时重置 initialized 标志 (#6474) (1e4a235)
• 循环: 修复受控 swiper 的 loopFix (d7c0ef7)，关闭 #6491
• 循环: 修复移除最后一个 slide 时 slide 关闭的问题 (1a02271)，关闭 #6477
• 分页: 正确支持多个小点分页 (e24bd8c)，关闭 #6462
• 分页: 转义分页类中的 + 字符 (d0beb9f)，关闭 #6486
• 分页: 支持多个小点类 (20b05fa)，关闭 #6447
• react: 修复 slide 数量不足时虚拟循环的问题 (57d8eea)，关闭 #6487

新特性

• 元素: 添加 eventsPrefix prop，以避免与原生事件冲突 (d5df91f)，关闭 #6450
• 分页: 添加 border-radius 变量 (#6476) (c912590)

9.1.0 (2023-02-28)

错误修复

• 自动播放: 修复超时期间自动播放消失时导致的 resize 崩溃问题 (#6431) (adb40f4)
• 核心: 正确计算 slide 的 DOM 索引，对元素有效 (18b1f2b)
• 核心: 修复当 slidesPerGroup 与 slide 数量不一致时的循环问题 (f998115)，关闭 #6412
• 核心: 阻止 grab cursor 触发观察者 (9597442)，关闭 #6423
• 核心: 将 iOS 的 pointercancel 作为 pointerup 处理 (50b65f6)，关闭 #6414 #6382
• 创意效果: 修复原点 (7883408)，关闭 #6439
• 元素: 修复忽略 on 事件处理程序的问题 (898f76c)，关闭 #6399
• 分页: 再次检查小点是否存在 (a335a41)，关闭 #6422
• 分页: 修复 slidesPerView > 1 和循环时的可点击分页问题 (cf8cdf5)，关闭 #6415
• 虚拟: 修复虚拟 slide 内容中的 HTML 转义问题 (a61638a)，关闭 #6404
• 缩放: 修复指针离开时缩放卡住的问题 (6700980)，关闭 #6396

新特性

• 元素: 新增全局 window.SwiperElementRegisterParams 方法，用于注册可接受的元素 props (fb63358)

9.0.5 (2023-02-13)

错误修复

• 滚动条: 修复滚动条重复问题 (e99361d)，关闭 #6386

9.0.4 (2023-02-10)

错误修复

• 自动播放: 修复自动播放未定义错误 (#6366) (f2a0572)
• 分页: 修复分页小点子元素点击问题 (8bcff39)，关闭 #6361
• 虚拟: 仅从 wrapper 子元素获取 DOM slide (d59183d)
• 缩放: 修复手势缩放原点 (c89b2dd)，关闭 #6371

9.0.3 (2023-02-06)

错误修复

• 核心: 如果 swiper 销毁，则不继续懒加载 (4ea0102)，关闭 #6322
• 核心: 修复虚拟模式下的循环处理 (69462d2)，关闭 #6343
• 元素: 修复布尔/字符串参数转换为模块对象的问题 (192e0d4)，关闭 #6328
• 导航: 允许导航选项中包含多个类 (#6345) (ca49b9f)，关闭 #6344
• 缩略图: 确保有 slide 可以添加类 (c6294ad)，关闭 #6335

新特性

• 历史: 允许空字符串 key (a335b09)，关闭 #6338

9.0.2 (2023-02-03)

错误修复

• 核心: 修复自由模式下鼠标滚轮的循环行为 (336d908)，关闭 #6323
• 类型: spaceBetween 也可以是字符串 (446fb06)，关闭 #6286
• vue: autoplayTimeLeft 事件的声明 (8467397)，关闭 #6333

9.0.1 (2023-02-02)

错误修复

• 核心: 修复 setBreakpoints 中类的移除问题 (6cb79cf)，关闭 #6319
• 虚拟: 修复 undefined document 的问题 (9cee290)，关闭 #6318

9.0.0 (2023-02-01)

核心

• 新增 oneWayMovement 参数
• 移除 Dom7 依赖
• 全新循环模式，无需复制 slide
• 移除图像加载功能: preloadImages, updateOnImagesReady 参数

框架

• 全新 Swiper Element (WebComponent)
• 移除 Swiper Solid 组件 (改用 Swiper WebComponent)
• 移除 Swiper Angular 组件 (改用 Swiper WebComponent)
• 移除 Swiper Svelte 组件 (改用 Swiper WebComponent)

自动播放

• 全新自动播放模块

控制器

• 现在 controller.control 参数也接受 HTMLElement 或带有 swiper 选择器的 CSS 字符串来控制

懒加载

• 懒加载模块已移至核心并简化，以支持原生 loading="lazy"

导航

• 更多 CSS 变量来控制外观和位置

视差

• 支持视差 rotate

缩略图

• 现在 thumbs.swiper 参数也接受 HTMLElement 或带有缩略图 swiper 选择器的 CSS 字符串

虚拟 slide

• 新增循环模式支持
• 改进性能
• 现在将处理最初在 DOM 中渲染的幻灯片

缩放

• swiper.zoom.in(ratio) 方法现在接受自定义缩放比例

功能

• 在 React 和 Vue 组件中为 swiper-wrapper 添加 wrapperClass (7aaa0d1)，关闭 #6254 #5942
• 核心: 添加 loopPreventsSliding 参数 (6533890)

• 核心: 新增 oneWayMovement 参数 (ce2ea7f)
• 导航: 更多 CSS 变量来控制外观和位置 (6db9439)
• 分页: 更多 CSS 变量来控制外观和位置 (c8b1228)
• 滚动条: 更多 CSS 变量来控制外观 (cfad536)
• 添加元素核心版本 (de6c7f7)
• 导出元素 CSS 样式 (51334a3)
• injectStyles 和 injectStylesUrls 参数 (71b10b2)
• 视差: 支持视差旋转 (4949163)，关闭 #6126
• 缩放: in 方法现在接受自定义缩放比例 (d88df61)，关闭 #5527
• 核心: 添加 loopedSlides 参数 (1b076d9)
• 元素: 添加选项以避免样式注入 (2291ec8)
• 缩略图: 在 DOM 中显示时初始化缩略图 (a6b4cf7)
• 元素: 添加独立样式 (284b130)
• 控制器: 支持更新循环 (6059e48)
• 控制器: 支持更新循环 (03d9895)
• 控制器: 支持更新循环 (e73b577)
• 核心: 基于触摸移动方向“修复”循环 (5ab7217)
• 元素: 为 Swiper Element 的模块添加 CSS 样式 (6c36c80)
• 核心: 添加 --swiper-wrapper-transition-timing-function CSS 变量 (797bcda)
• 导航: 更多 CSS 变量 (f41abe6)
• 分页: 更多 CSS 变量 (6f63fe2)
• 滚动条: 更多 CSS 变量 (875b35a)
• 虚拟: renderSlide 支持幻灯片外部 HTML 和 HTML 元素 (fdcd644)
• 核心: 支持“swiper-slide-transform”元素，以更好地兼容 CSS 模式的效果 (18b3e3f)
• 核心: 移除 Dom7 (44de97b)
• 核心: 移除 Dom7 (7cdcebf)
• 核心: 在循环模式下动画时，不要阻止 slidePrev/Next (b358737)
• 自动播放: 正确支持虚拟幻灯片延迟 + 修复点击停止自动播放的问题 (43bf429)
• 元素: 通过 autoplay-delay 形式的属性支持复杂参数 (8161c57)
• 虚拟: 支持 DOM 虚拟幻灯片 (59da65c)
• 虚拟: 支持虚拟幻灯片循环模式 (f890f1e)
• 自动播放: 全新的自动播放模块 (1b4ac21)
• 核心: 移除未使用的 slide*DuplicateClass 参数 (8007e1a)
• 核心: 全新无幻灯片重复的循环模式 (f57aa3b)
• 移除 postinstall 脚本 (12255cf)
• 核心, 缩放: 将触摸处理逻辑重构为仅限 PointerEvents (ede6b6d)
• 核心: 将 threshold 参数默认设置为 5 (dfce8a3)
• 懒加载: 简化懒加载模块，支持原生 loading="lazy" (d46d5d0)
• 将新懒加载模块移至核心 (d51e1ce)
• React: 为 SwiperSlide 添加布尔值 lazy 属性以渲染懒加载预加载器 (f5d137f)
• 移除图片加载功能：preloadImages, updateOnImagesReady (4d02653)
• Vue: 为 SwiperSlide 添加布尔值 lazy 属性以渲染懒加载预加载器 (e36b580)
• 添加新的 Swiper Custom Element (47f9518)
• 移除 Angular 和 SolidJS 组件 (1329c10)
• 移除 Swiper Svelte 组件 (52433ac)

错误修复

• 效果-立方体: 修复 iOS 16.2 固定透视问题 (2f5ed48)，关闭 #6293

• 历史: 修复初始化时处理 popstate 问题 (483534f)
• 核心: 当 translate 小于 1px 差异时，isBeginning 和 isEnd 为 true (b2313d5)，关闭 #6287
• React: 修复 React 18 兼容类型问题 (4c916d4)，关闭 #5799
• 虚拟: 修复 CSS 模式下 initialSlide > 0 时的虚拟功能 (5ddf1d8)

8.4.7 (2023-01-30)

错误修复

• Svelte: 自动播放选项 TypeScript 问题 (#6294) (3317f5e)

8.4.6 (2023-01-17)

功能

• 添加 swipeDirection (#6290) (3774a64)
• Angular: slidesPerGroupAuto (#6243) (750f41c)

8.4.5 (2022-11-21)

错误修复

• a11y: 修复 JS 错误“swiper.a11y is undefined” (#6226) (02c1502)
• 触摸 focusableElements 跳过元素 (#6139) (339f52e)

功能

• Svelte: 添加 tag 和 wrapperTag 属性 (71e7f5a)，关闭 #6181

8.4.4 (2022-10-12)

功能

• 添加直接 JS/CSS 核心和捆绑包导出 (f519f80)

8.4.3 (2022-10-06)

错误修复

• a11y: 点击幻灯片内部元素时不要聚焦幻灯片 (c8e22f7)，关闭 #6116

功能

• 构建配置: 允许通过 process.env.SWIPER_BUILD_MODULES 自定义模块 (#6043) (b3c51c5)
• Solid: 修复动态幻灯片处理问题 (708133d)，关闭 #6031
• Solid: 将 solid 组件保留在 .jsx 中 (d7f7f65)

8.4.2 (2022-09-15)

错误修复

• onTouchStart.js: 修复目标元素分配问题 (#6065) (cb46a9a)

8.4.1 (2022-09-15)

错误修复

• 核心: 修复在嵌套 shadow dom 上滑动的问题 (7d09ab0)，关闭 #6063
• React: 修复检查子元素的问题 (37a94ea)，关闭 #6064

8.4.0 (2022-09-14)

错误修复

• a11y: 在指针事件上不处理焦点 (b251601)，关闭 #5962 #5814 #5524 #5490 #5437
• Angular: slidesPerGroupAuto 在 Angular 参数列表中缺失 (#5933) (b80352a)
• 核心: 修复 beforeSlideChangeStart 事件路由问题 (0e8a8b8)，关闭 #5913
• event.path => event.composedPath (8df7edf)，关闭 #5925
• 类型: 添加 isLocked 定义 (f2bbae6)，关闭 #5941
• 类型: 添加缺失的 AutoplayMethods 成员 (#5956) (6220c22)
• Vue: 修复 Vue swiperSlide 的 swiperRef 问题 (#5994) (a2bcbb1)

功能

• 构建: 升级 deps 和 cjs 到 esm (#5927) (921809b)
• 卡片效果: 添加 perSlideRotate 和 perSlideOffset 参数 (db08a70)，关闭 #5939
• 核心: 新的 loopedSlidesLimit 参数，用于重新复制幻灯片 (1afa4b8)
• React: 允许 SwiperSlide 子元素，只要 displayName 包含 SwiperSlide (#5954) (d1f7582)
• Solid: 将 solid 组件保留在已编译中 (18c6670)，关闭 #5943

回滚

• 回滚 "chore(deps): upgrade angular to v14 (#5926)" (#5929) (ae429c4)，关闭 #5926 #5929

8.3.2 (2022-07-26)

错误修复

• a11y: 修复 focus 处理问题 (8a3dfee)，关闭 #5905
• 自动播放: 如果 swiper 隐藏，不要运行自动播放 (4f2e30f)，关闭 #5907

功能

• 核心: 新增 loopedSlidesLimit 参数和增加重复幻灯片的新功能 (5156071)

8.3.1 (2022-07-13)

错误修复

• 包: 在 /solid 和 /react 中添加 index.js (#5863) (6e94701)
• Solid: 修复响应性问题 (502c152)，关闭 #5862
• Solid: 在 SolidJS 中不使用循环的滑块停止使用 cloneNode (#5860) (d14c432)

8.3.0 (2022-07-06)

功能

• 由 @TiagoCavalcante 带来的全新 Swiper SolidJS 组件 🎉
• 将 React/Vue/Svelte/Solid 的通用辅助函数移至单个文件 (90e8da1)
• a11y: 允许禁用 slideRole (#5838) (b376aa1)

8.2.6 (2022-06-29)

错误修复

• 缩略图: 激活类被移除 (#5826) (3267616)
• Vue: virtualUpdate 事件未声明 (#5830) (8b00333)

功能

• 核心: 添加 changeLanguageDirection 方法，用于在初始化后将其更改为 RTL/LTR (f5bb7af)，关闭 #3279
• 导航: 添加 navigationPrev 和 navigationNext 事件 (d0c6365)，关闭 #5832

8.2.5 (2022-06-27)

错误修复

• 分页: 双重检查 $el (baafb55)

8.2.4 (2022-06-13)

错误修复

• Angular: 回滚构建到 Angular 13 (3f14d67)，关闭 #5792 #5791

8.2.3 (2022-06-10)

功能

• a11y: 允许 slideLabelMessage: null (#5783) (78a8d90)
• Angular: 更新到 angular v14 (097390d)
• 滚动条: 为滚动条容器添加方向类 (083a83f)

8.2.2 (2022-06-01)

错误修复

• 滚动条: 修复可拖动滚动条 (28cd6c2)，关闭 #5759

回滚

• 回滚 "fix(autoplay): immediate proceed autoplay when autoplay.delay = 0" (d942e83)
• 回滚 "fix(autoplay): fix swiper getting stuck with 0 autoplay delay" (56e050b)

8.2.1 (2022-05-31)

错误修复

• 核心: 修复导航/分页 enabled 属性问题 (af9ed85)

8.2.0 (2022-05-31)

错误修复

• 自动播放: 修复 0 自动播放延迟导致 swiper 卡住的问题 (61db26f)
• 核心: 修复 slideToLoop 中的 Number 类型问题 (#5732) (1e1336b)

功能

• 导航: 允许在断点中启用/禁用导航 (052f863)
• 分页: 允许在断点中启用/禁用分页 (d748d49)
• 滚动条: 允许在断点中启用/禁用滚动条 (3f09fc7)

8.1.6 (2022-05-25)

错误修复

• a11y: 幻灯片数量变化时更新幻灯片 a11y (31e2005)，关闭 #5692
• 自动播放: 当 autoplay.delay = 0 时立即进行自动播放 (81a4cc8)
• 懒加载: loadPrevNext 修复 slidesPerView 为小数时的问题 (94d4c9e)，关闭 #5712
• 懒加载: swiper 销毁时取消设置懒加载类 (81d7fc4)，关闭 #5737
• 类型: 添加 snapIndex 和 snapGrid 属性 (ee3d2dc)，关闭 #5733

功能

• 导航: 隐藏导航按钮的默认 opacity: 0 样式 (85f72f4)

8.1.5 (2022-05-16)

错误修复

• 核心: 添加缺失的类型注释 (340f716)，关闭 /github.com/nolimits4web/swiper/issues/5688#issuecomment-1118316055
• 核心: 在 updateAutoHeight 中检查 visibleSlides 是否存在 (3909c45)
• 核心: 修复 getWrapper $el 检查问题 (7702178)，关闭 #5711
• 导航: 移除重复规则 (#5657) (333a3ae)
• React: 将导航、分页、滚动条移至容器末尾 (2d3255f)
• Svelte: 修复事件分派中的不正确参数 (#5716) (b7961a3)
• Svelte: 将导航、分页、滚动条移至容器末尾 (c8a4f67)
• Vue: 将导航、分页、滚动条移至容器末尾 (0d219f4)

功能

• 历史: 插件修复和新选项添加 (#5665) (798c7c0)

8.1.4 (2022-04-24)

错误修复

• 核心: 如果 watchSlidesProgress 启用，在可见幻灯片中动画预加载器 (8174b5a)
• 核心: 更多检查 swiper 何时被销毁 (de47f09)，关闭 #5656 #5635
• 懒加载: 在不可见幻灯片中动画预加载器 (865529b)

8.1.3 (2022-04-20)

错误修复

• 效果: 改进立方体和翻转效果的动态幻灯片阴影重新创建 (98b8a3e)

8.1.2 (2022-04-20)

错误修复

• 效果: 修复 Safari 中立方体和翻转效果幻灯片阴影闪烁问题 (52f5ef7)

功能

• 立方体效果: 在 swiper-wrapper 上设置 --swiper-cube-translate-z CSS 属性 (758ad28)

8.1.1 (2022-04-15)

错误修复

• 懒加载: 修复 iOS 15 中的懒加载预加载器问题 (794a625)
• 虚拟: 修复启用虚拟时泄漏的效果平移 (a0e8dd4)，关闭 #5588

8.1.0 (2022-04-08)

错误修复

• 分页: 格式化函数现在接受字符串作为返回值 (#5610) (629c1c4)
• Vue: 添加缺失事件 (bda673f)，关闭 #5558
• enabled 不工作 (修复 #5611) (#5612) (6a0554b)

功能

• a11y: 添加 id 参数 (213c8fe)，关闭 #5586
• Angular: 支持 swiperSlide 中的 [ngClass] (#5562) (5d4ffdc)
• 卡片效果: 添加 rotate 参数 (5f4ca8a)，关闭 #5575

8.0.7 (2022-03-04)

错误修复

• 分页: 使用方向类 (95c882c)，关闭 #5489

功能

• 卡片效果: 支持与虚拟幻灯片一起使用 (69a8870)
• 虚拟: 更好地支持除了 slide 之外的其他效果 (2dae84f)

8.0.6 (2022-02-14)

错误修复

• Angular: swiper angular 事件 (#5462) (adc99a5)
• Vue: HMR 错误 (#5460) (0374228)

8.0.5 (2022-02-10)

错误修复

• 核心: 修复短滑动手势 (8e1c12e)

8.0.4 (2022-02-10)

错误修复

• 核心: 将 resize observer 回调封装在 requestAnimationFrame 中 (#5441) (0567641)，关闭 #5440

功能

• Angular: 事件类型 (#5424) (d8631d8)
• Angular: 锁定输出 (#5442) (3bc27a4)
• 核心: 允许 SASS 中的样式嵌套 (#5438) (c973bc8)
• 核心: 滑动时倒带 (#5422) (1a2f83b)

8.0.3 (2022-02-03)

错误修复

• React: useSwiper 上下文值 (#5421) (60cbe75)
• React: 将自动播放添加到观察模块中 (#5419) (16059ad)
• Svelte: 将自动播放添加到观察模块中 (1463e05)
• Vue: 将自动播放添加到观察模块中 (da4d3cc)

8.0.2 (2022-02-02)

错误修复

• 核心: 修复启用 observer 后滑块冻结的问题 (8ff2691)，关闭 #5414

8.0.1 (2022-02-01)

错误修复

• Angular: 修复 angular 导出问题 (8785e2b)，关闭 #5414
• React: useSwiper 和 useSwiperSlide 钩子的类型 (2cbf82c)，关闭 #5413

功能

• Angular: 移除弃用的 index 属性 (#5412) (63642a1)

8.0.0 (2022-02-01)

错误修复

• a11y: 锁定/解锁时更新 aria-disabled (8183466)，关闭 #5383
• Angular: [@output](https://github.com/output) 事件触发 (#5225) (a34eb7a)
• Angular: 获取参数类型 (#5390) (8731204)
• Angular: 切换输入 (#5229) (#5254) (03acbe2)
• 核心: 当 allowTouchMove: false 时，不要阻止可聚焦元素的点击 (f0eac04)，关闭 #5358
• 核心: 不要滑动 <select> 元素 (faeb14a)，关闭 #5268
• 懒加载: 仅当幻灯片激活时才激活预加载器旋转动画 (#5203) (b7d89ea)，关闭 #5202
• React: 兼容 React 18 严格模式 (68bcec8)，关闭 #5398
• React: 在 control 属性数组更改时更新 controller.control (7c53de8)，关闭 #5368
• Svelte: swiperSlide 槽数据与上下文 (89f14ab)
• 类型: bullets 类型应为 Dom7Array (#5405) (d248a14)

功能

• a11y: 在非活动幻灯片中，自动切换焦点幻灯片 (Tab) (1288271)，关闭 #3149
• Angular: 更新到 angular 13 并启用 tsconfig strict (#5231) (23ee4b3)
• 自动播放: autoplayPause 和 autoplayResume 事件 (aea56ed)
• 自由模式: 在自由模式下发生触摸事件时停止滚动 (80958d5)，关闭 #4616
• React: useSwiper 和 useSwiperSlide 上下文钩子 (#5364) (18bb89b)
• Svelte: swiper 和 swiperSlide 上下文 (#5391) (b5c2d3b)
• Svelte: 导入索引 (c91f222)，关闭 #4976 #4975
• 虚拟: 支持虚拟幻灯片的 rewind 功能 (e52de28)
• Vue: useSwiper 和 useSwiperSlide 上下文钩子 (987a32e)
• 新的 maxBackfaceHiddenSlides 参数，以防止 Safari 中的闪烁 (d679a98)
• 新的 maxBackfaceHiddenSlides 参数，以防止 Safari 中的闪烁 (8c05e6d)
• Svelte: Swiper 槽 virtualData 的类型 (682f56f)
• Svelte: SwiperSlide 槽数据的类型 (1fa70e1)，关闭 #5349
• Vue: 提供 - 注入 swiper 和 swiperSlide 上下文 (#5377) (f3145b1)
• 更新 dom7 到最新版本 (a6b1a47)

7.4.1 (2021-12-24)

错误修复

• 类型: 修复 rewind 描述 (83574e1)

7.4.0 (2021-12-24)

错误修复

• 核心: autoHeight 不应忽略零高度幻灯片 (b3697f1)，关闭 #5281
• 分页: 修复启用 loop 时动态子弹位置问题 (3d377c2)，关闭 #5304

功能

• 核心: 添加 rewind 功能 (38fdd15)，关闭 #5003 #5270

7.3.4 (2021-12-22)

错误修复

• Angular: setElement 检查 (#5305) (51c4a49)
• Angular: 修复 nativeElement 检查 (d48fb1b)

7.3.3 (2021-12-16)

错误修复

• Angular: setElement 调用 updateInitSwiper bug (#5296) (99be5ea)

7.3.2 (2021-12-13)

错误修复

• Angular: 切换输入 (#5229) (ab3a4ad)

功能

• a11y: 为当前子弹添加 aria-current (#5258) (b5df68e)
• 更新 dom7 和 ssr-window 到最新版本 (627ca3a)

7.3.1 (2021-11-24)

功能

• Angular: 支持 on 参数 (#5224) (3553c41)

7.3.0 (2021-11-18)

错误修复

• 文档: property -> properly (#5187) (2824b0c)
• 缩放: 仅使用一个元素进行缩放 (60a9886)，关闭 #5170
• 核心: 如果没有子元素，将 $selector 回退到 $wrapperEl (#5173) (d8b4ca1)
• 类型: 修复 typo progressMultipler -> progressMultiplier (#5158) (815e837)

功能

• React: 导出 SwiperProps 和 SwiperSlideProps 类型 (d543020)，关闭 #5141

7.2.0 (2021-10-27)

功能

• 添加 "main" 和 "module" 包字段 (f228391)
• 更新 dom7 和 ssr-window 到最新版本 (7d45076)

7.1.0 (2021-10-25)

错误修复

• 核心: 使用 creative-effect 时 centeredSlides 不起作用 (#5115) (264ca64)
• Coverflow 效果: 接口 CoverflowEffectOptions 已更新。 (#5123) (b1c317a)

功能

• 核心: 添加对带槽元素的循环支持 (#5117) (33c411e)

7.0.9 (2021-10-18)

错误修复

• 核心: 将 opacityString 和 scaleString 更改为 originalProgress (#5095) (244cc2e)
• Vue: 修复 SwiperSlide 类型问题 (114fee7)，关闭 #5069

7.0.8 (2021-10-04)

功能

• 虚拟: 改进 cssMode 下的行为 (b478058)

7.0.7 (2021-09-29)

错误修复

• Angular: 移除多余的 setIndex 调试代码 (nolimits4web#5006) (#5007) (59e44ae)
• Vue: 使 swiperRef 在 SwiperSlide vue 组件中不是必需的 (#4992) (1cd6af8)

7.0.6 (2021-09-16)

错误修复

• Angular: 弃用 [(index)] 和 setIndex() (#4951) (7ee3d58)
• 效果-创意: 修复通过观察所有幻灯片过渡结束来自动播放的问题 (86e6fb6)，关闭 #4961
• 类型: 添加缺失的 cards 效果 (#4950) (c18aa08)

功能

• Angular: enabled 属性 (#4949) (6c0a3e5)
• Angular: 支持 data-swiper-autoplay (#4946) (d665fb9)

7.0.5 (2021-09-09)

错误修复

• 核心: 不要在 destroy/init 时自动创建元素 (b4cdea8)
• 核心: 传入的 modules 不应扩展原型 (f07d43f)，关闭 #4928

7.0.4 (2021-09-08)

错误修复

• 核心: 修复 Safari 14 中的 cssMode 动画 (7fd04fe)，关闭 #4925
• 虚拟: 修复 React、Vue 和 Angular 中的虚拟幻灯片问题 (e80925e)，关闭 #4899

功能

• 分页: 更多分页子弹 CSS 变量 (#4927) (25416de)

7.0.3 (2021-09-03)

错误修复

• 类型: effect-creative translate (#4907) (ad8fae3)

7.0.2 (2021-08-31)

错误修复

• a11y: 修复 initNavEl() 方法的参数问题 (#4884) (2987700)
• 核心: 当 slidesPerView 切换到 auto 时重置幻灯片大小 (2c8784b)，关闭 #4881
• 描述错字 (#4887) (d3c4764)

7.0.1 (2021-08-26)

错误修复

• 自动播放: 添加缺失的 .start() 方法 (dda14bc)，关闭 #4865
• 分页: 销毁前检查子弹 (ea06b4c)，关闭 #4859

7.0.0 (2021-08-25)

错误修复

• Angular: 容器类名 (#4854) (fd092dc)
• Angular: 演示 (9fa84e6)
• Angular: 尝试构建/类型路径 (04b4eae)
• Angular: tsignore (9011756)
• 类型: 使 loopSlides & loopCreate & loopDestroy 内部化 (d6fdd1b)
• 缩放: 仅在 swiper-zoom-container 中缩放元素 (a4e351f)，关闭 #4847
• 键盘: 修复键盘模块不工作的问题 (31ee849)
• 分页: 避免向其他 swiper 的分页添加方向类 (f1c8c89)
• 核心: 阻止 watchOverflow 解锁 slidePrev/Next (f1b7397)
• 滚动条: 修复 centeredSlides 下的滚动条大小 (91f2f2f)
• 核心: 修复 CSS 模式和居中幻灯片中的幻灯片进度 (1b0165a)
• 核心: 更好地处理启用 cssMode 时的循环修复 (ff84073)
• 核心: 修复带断点的自动创建元素功能 (3b50feb)
• 组件: 添加 modules 属性 (596e2a1)
• 类型: 添加 modules 参数 (0d599e2)
• 核心: 抓取光标应根据 touchEventsTarget 设置 (cffc3aa)
• 核心: 在 smoothScroll 检测中双重检查 documentElement (ac09e38)

功能

• 创意效果: 添加 shadowPerProgress 参数 (980c4c7)
• Angular: 更好的类型化 (e132ee8)
• Angular: 更好的类型化 (6b562fa)
• Angular: 支持 'strictTemplates' 标志 (613f12c)
• 效果-创意: 添加 progressMultiplier 选项 (ed3bd7a)
• Angular: 部分 ivy 构建 (#4834) (e86b2b3)
• 核心 swiper-container 类到 swiper (ad8002c)
• 核心 swiper-container 类到 swiper (c763c9c)
• 核心: watchOverflow 现在默认启用 (b97286f)
• 核心: 改进 watchOverflow 检测 (627ae4c)
• 创意效果: 添加阴影 (cce4f23)
• 卡片效果: 添加幻灯片阴影 (09666c8)
• 卡片效果: 新的卡片效果 (21af858)
• 创意效果: 添加 limitProgress 和 perspective 选项 (1c7d49e)
• 核心: 新的“创意”效果 (f72f5ba)
• Svelte: 添加 Svelte 组件类型定义 (5a64bdc)
• 核心: 新的 slidesPerGroupAuto 功能 (2b6f133)，关闭 #4168
• Coverflow 效果: 支持 cssMode (e13d268)
• 淡入淡出效果: 支持 cssMode (18b49cc)
• 翻转效果: 支持 cssMode (82859a1)
• 分页: 当分页在容器外部时保持其样式 (1b11429)，关闭 #3736
• 核心: 更好地支持 CSS 模式中的 RTL (3503ced)
• 核心: 支持 CSS 模式中的 centeredSlides (c940953)
• 核心: 支持 CSS 模式中的 coverflow 效果 (8300225)
• 核心: 支持 CSS 模式中的虚拟幻灯片 (0e26d52)
• 核心: 为自定义滚动动画使用缓动函数 (f40a370)
• 缩放: 支持 CSS 模式中的缩放 (4639702)
• 核心: watchSlidesProgress 和 watchSlidesVisibility 合并为单个 watchSlidesProgress (33dbf62)
• 核心: 为不支持平滑滚动的 CSS 模式提供自定义动画 (a61da6a)
• 核心: 移除 isEdge 浏览器检测 (9c9970c)
• 核心: 将幻灯片操作方法移至操作模块 (74873f1)
• 核心: 将 slidesPerColumn 功能移至新的 Grid 模块 (0f1df44)
• 核心: 增加包构建目标 (65f96c1)
• 核心: 调整 browserslist (82a23a5)
• 核心: 将 A11y 转换为功能模块 (5906115)
• 核心: 将自动播放转换为功能模块 (ace1e54)
• 核心: 将 FreeMode 转换为功能模块 (4d307c0)
• 核心: 将键盘转换为功能模块 (ed63a3b)
• 核心: 将懒加载转换为功能模块 (8d4f99a)
• 核心: 将 Mousewheel 转换为功能模块 (1e4bf98)
• 核心: 将导航转换为功能模块 (e4aa156)
• 核心: 将分页转换为功能模块 (1c718d0)
• 核心: 将滚动条转换为功能模块 (96b8b17)
• 核心: 将缩略图转换为功能模块 (bea5ac2)
• 核心: 将虚拟转换为功能模块 (6899e83)
• 核心: 将缩放转换为功能模块 (eb1437e)
• 核心: 移除对象语法模块支持 (287d14a)
• 核心: touchEventsTarget 现在默认为 wrapper (71ffcb5)，关闭 #4751 #3816
• 核心: 将效果转换为功能模块 (b6f64a5)
• 核心: 将 HashNavigation 转换为功能模块 (ac384c6)
• 核心: 将 History 转换为功能模块 (7e7c95a)
• 核心: 将 Observer 转换为功能模块 (a31b80e)
• 核心: 将视差转换为功能模块 (a7c26b5)
• 核心: 将 Resize 转换为功能模块 (133047c)
• 核心: 新的功能模块语法 (e45285a)
• 核心: 移除 mouse 事件监听器，改用指针事件 (b9254ab)
• 核心: 移除 MutationObserver 支持检测（认为它在任何地方都受支持） (6ed6786)
• 核心: 移除 pointerEvents 支持检测 (b7d171b)
• 核心: resizeObserver 默认不启用 (552a7ea)
• 包: 使用 type: module (e8d89f2)
• 核心: 移除 CJS 格式 (3978367)
• 核心: 移除 Less 和 SCSS 变量，改用 CSS 变量 (91e8ea1)
• 自由模式: 初始化 (#4240) (895da28)
• slidesPerColumn: 初始化 (#4508) (c469d29)

6.8.4 (2021-08-23)

错误修复

• 改进类型定义 (b0fb310)

6.8.3 (2021-08-20)

错误修复

• 修复 swiper/types 中缺少 package.json 的问题

6.8.2 (2021-08-16)

错误修复

• 核心: 支持 tailwind 类中的 ! (0cfbc53)，关闭 #4812
• Vue: 将缺失的 emitted 事件（enable & disable）添加到 'emits' 选项中 (95665cc)
• Vue: 修复 focusableElements 属性类型问题 (7f1b1b9)，关闭 #4822

6.8.1 (2021-08-03)

错误修复

• 核心: 在 slidesPerColumn 断点上重置幻灯片 margin-top (c94a115)，关闭 #4044
• 核心: 修复 HTMLElement 的服务器端检查 (关闭 #4787) (#4788) (ca4f6b8)

功能

• 分页: 隐藏 1 点分页 (#4786) (cc5e417)

6.8.0 (2021-07-22)

错误修复

• a11y: 在循环选项中计算 aria-label，不包含重复项 (4bd7461)，关闭 #4782 #4781
• angular： 嵌套 Swiper (#4785) (2be958c)
• 核心： 在 SSR 中不扩展 HTML 元素 (#4784) (adac257)
• 哈希导航： 评论和函数名中的错别字 (#4779) (07b8dc3)
• svelte： 通过 module 组件属性安装模块 (#4768) (ddaa069)，关闭 #4767
• 缩放： 修复 RTL 中的缩放平移 (08bcd05)，关闭 #4074

6.7.5 (2021-07-01)

Bug 修复

• 懒加载： 启用无侧边阻力时懒加载 (1949a9e)，关闭 #4729
• 缩放： 兼容 slidesPerView，仅缩放点击的幻灯片 (aa1a778)，关闭 #4716

新特性

• vue： 添加 Vue 组件类型定义 (#4707) (c452c08)，关闭 #3916

6.7.1 (2021-06-23)

Bug 修复

• angular： 不在 wrapper 元素上设置主 class (1285195)，关闭 #4679
• 核心： 不扩展 HTML 元素 (#4691) (32ae99b)
• 核心： 当 slidesPerColum 改变时，取消幻灯片的上边距 (1ced4f7)，关闭 #4658
• react： 动态启用/禁用导航/分页/滚动条 (d87ac0c)，关闭 #4681
• react： 虚拟幻灯片渲染后更新视差效果 (ce210f3)，关闭 #4673
• react, svelte, vue： 允许接受 enabled 属性 (76dd086)，关闭 #4633
• svelte： 动态启用/禁用导航/分页/滚动条 (8711bb9)
• 类型定义： 修复导航、分页和滚动条的方法定义 (77d6909)
• vue： 动态启用/禁用导航/分页/滚动条 (4821008)
• vue： 虚拟幻灯片渲染后更新视差效果 (b78c6e0)

新特性

• 核心： 添加 ParallaxOptions 类型 (7cc22fe)，关闭 #4684
• 核心： 允许 wrapperClass 为多个类 (0d578b0)，关闭 #4680
• 核心： 使 focusableElements 可配置 (6ff0866)，关闭 #4677
• 核心： 使用 window.matchMedia 检测断点窗口宽度 (1a4afe0)，关闭 #4682

6.7.0 (2021-05-31)

Bug 修复

• angular： 虚拟模式在 ngZone 内运行 changeDetecton (#4601) (4f37a61)
• 懒加载： 滚动监听器使用被动监听器 (cbe7a59)
• 缩略图： 改进带有 slidesPerGroup 的缩略图 (b2b31b3)，关闭 #3704 #4007 #4615 #4208
• vue： “lock” 和 “unlock” 事件的定义 (46d35f7)，关闭 #4596

新特性

• 核心： 初始 HTML 布局可选，新增 createElements: true 参数 (#4507) (aef2865)
• 自动播放： 如果 disableOnInteraction 和 pauseOnMouseEnter 都启用，交互时将停止自动播放 (e7e5031)，关闭 #4598
• vue： 添加支持将 Swiper 用作异步组件 (ff53797)，关闭 #4613

6.6.2 (2021-05-19)

Bug 修复

• 自动播放： 修复鼠标移入暂停后恢复的问题 (3d480be)，关闭 #4569
• 导航： 更好的 SCSS 插值 (a1337df)
• svelte： 幻灯片属性更改时自动更新虚拟幻灯片 (ddf11b8)，关闭 #4564

6.6.1 (2021-05-11)

Bug 修复

• 核心： 修复断点 enabled 检测 (0be8099)，关闭 #4543

6.6.0 (2021-05-11)

Bug 修复

• 核心： 使 autoHeight 与虚拟幻灯片协同工作 (6925acf)，关闭 #4525
• 缩放： 不在没有缩放容器的幻灯片上切换缩放 (e1de61b)，关闭 #4535

新特性

• 自动播放： 新增 pauseOnMouseEnter 参数，用于在鼠标移入容器时暂停自动播放 (1a10247)，关闭 #4482
• 核心： 新参数和方法，用于动态启用/禁用 Swiper (575bc84)，关闭 #4356 #4311
• react： 添加缺失的渲染函数类型 (cfa1459)

6.5.9 (2021-04-30)

Bug 修复

• angular： 自定义导航和分页 (c96bcf6)
• angular： 销毁时不删除 Swiper 样式 (96ad4f0)，关闭 #4443
• angular： 扩展当前参数 (71be609)
• angular： pagination true 应该有效 (434a19c)
• angular： 更新值 (20e25b5)
• 构建： 大小计算 (769e9df)
• 文档： postinstall bakers->backers 错别字 (839aea4)
• 哈希导航： 修复在 freeMode 无过渡时使用的问题 (c90a7bd)，关闭 #4478
• 历史： 修复在 freeMode 无过渡时使用的问题 (2902ea9)
• react： 子组件更改时加载懒加载图片（如果启用） (ca0347b)，关闭 #4463
• vue： 子组件更改时加载懒加载图片（如果启用） (335daff)

新特性

• angular： 支持 ID 输入 (ad51e32)
• core-js postinstall 脚本 (fd5c01d)
• angular： 在 <swiper> 组件上使用 class 和 ngClass (66c5a55)

6.5.8 (2021-04-23)

Bug 修复

• 组件： 修复导航、分页、滚动条自定义元素在初始化后添加的问题 (cfd4efd)，关闭 #4458
• react： 使事件具有响应性 (301ffb0)，关闭 #3762

新特性

• a11y： 添加 a11y.slideRole 参数用于自定义幻灯片角色 (097109f)，关闭 #4435
• 历史： 新增 root 参数，用于避免根路径检测问题 (e6d1202)，关闭 #3205

6.5.7 (2021-04-16)

Bug 修复

• react： 修复在 React.StrictMode 中运行 Virtual、Controller 和 Thumbs 的问题

新特性

• 核心： 新增 swiper.setProgress 方法，用于设置整个 Swiper 的过渡进度（0 到 1）

6.5.6 (2021-04-09)

Bug 修复

• angular： 自定义 html 元素支持 (b7d0c1f)
• angular： 自定义 html 元素支持 (dec54c2)

6.5.5 (2021-04-08)

Bug 修复

• 核心： 从 peerDependencies 中移除 Svelte
• 工具： dom 不可写入 (8775c1a)

6.5.4 (2021-04-05)

Bug 修复

• 核心： 修复分页和 a11y 类转义问题 (49e06f9)，关闭 #4403
• svelte： 不在服务器端销毁 (8a8fb62)，关闭 #3961

6.5.3 (2021-03-31)

Bug 修复

• 导航： 修复导航按钮位置错误 (ef97693)，关闭 #4393

6.5.2 (2021-03-30)

Bug 修复

• 核心： 修复参数扩展导致 Swiper 实例丢失的问题 (32092ae)，关闭 #4384

6.5.1 (2021-03-29)

Bug 修复

• a11y： 更正 aria-roledescription 属性名称 (1b73c3b)，关闭 #4371
• 核心： 修复 proto 污染问题 (ec358de)
• 核心： 修复 proto 污染问题 (9dad273)
• isObject 跨窗口 (7c36077)
• isObject 跨窗口 (95b5dfe)
• 更新虚拟幻灯片 (e33242c)
• 核心： 替换不支持的 Object.entries (6dff71d)，关闭 #4341
• 核心： 使用 getComputedStyle 助手 (9698e58)，关闭 #4337

新特性

• a11y.slideLabelMessage (9fd6e68)
• 自定义 html 元素支持 (f96db02)
• 导航： 如果导航元素是 <button> 元素，则在其上设置 disabled 属性 (7536fbd)，关闭 #4312

6.5.0 (2021-03-05)

Bug 修复

• a11y： 空格键应触发按钮角色 (3d4039b)
• 核心： 当幻灯片包装器中存在其他元素时，正确更新 slideIndex (21e7713)
• 核心： 在过渡期间不切换缩放 (16f185e)，关闭 #4259
• 核心： 滑块锁定后不尝试移动 (51fd048)，关闭 #4284
• e2e： initSwiper (9915f8b)
• 懒加载： 修复 freeMode 无惯性停止时懒加载的问题 (82bcc5c)，关闭 #4274 #4275
• 导航： 点击分页时不隐藏导航 (7b7cccf)，关闭 #4285
• 分页： 点击导航时不隐藏分页 (68b8a93)，关闭 #4285
• svelte： 修复 Svelte cjs 导出问题 (478289c)，关闭 #4297

新特性

• 组件： 添加“resizeObserver”布尔选项/属性以启用 ResizeObserver (f03ffbb)，关闭 #4244
• 核心： 添加支持使用 ResizeObserver，新增“resizeObserver”参数 (5f80052)，关闭 #4244
• 核心： 可以基于容器宽度（而不是窗口宽度）启用断点 (42db86d)，关闭 #4244
• 初始化 cypress (6159524)

6.4.15 (2021-02-18)

Bug 修复

• angular, vue, svelte： 将“observer”等添加到参数列表 (8f1cd29)
• 核心： 正确存储类名 (02265ec)，关闭 #4247

6.4.14 (2021-02-17)

Bug 修复

• svelte： 将“observer”参数支持添加到 props (703ea53)
• vue： 将“observer”参数支持添加到 props (1d37ff7)
• 修复 CJS 模块打包错误 (0cda5e4)，关闭 #4242
• react： 将“observer”等添加到参数列表 (205c14e)

新特性

• angular： 缩略图和控制器支持 (76acd28)

6.4.12 (2021-02-16)

Bug 修复

• angular： 自动播放 SSR (4f1e9c4)
• angular： 虚拟启用时，不启用观察者 (8810b18)
• angular： 虚拟 SSR (63fed99)

性能改进

• angular： 在 angular 外部调用 swiperRef (4e544ef)

6.4.11 (2021-02-06)

Bug 修复

• angular： BrowserAnimationsModule 幻灯片删除 (fef6ebd)
• react： 当 #4181 时，导航、分页和滚动条未禁用 (460787d)
• react： 正确检查虚拟参数 (92c0137)
• react： 支持包装在高级组件中的 SwiperSlider 组件，并修复嵌套片段错误 #4144
• vue： 在 nextTick 上更新虚拟幻灯片 (5208b1a)，关闭 #4172
• svelte/vue：当 false #4181 时，导航、分页和滚动条未禁用 (ffedb6b)

新特性

• angular： 使用观察者在幻灯片更改时更新 swiper (962a0c0)
• angular： 使用 swiper 观察者 (30dd7c9)

6.4.10 (2021-01-29)

Bug 修复

• 核心： 尝试在不存在的元素上初始化时不抛出错误 (31aa87a)
• 核心： 修复“滚动容器”问题 (c3d0b97)，关闭 #4161
• react： 修复虚拟幻灯片无法正常工作的问题 (c24f7ef)，关闭 #4162
• vue： 修复虚拟数据更改时更新虚拟幻灯片的问题 (5979102)

6.4.9 - 2021 年 1 月 28 日发布

Bug 修复

• angular： 无法设置未定义的 'classNames' 属性 (13bcf39)
• angular： 内容滑块 ngIf (4ca13e4)
• angular： tsconfig 路径 (f2dcf16)
• angular： 缩放容器自定义类 (5d4f11c)
• 核心： 为 free mode 禁用额外的网格项 (9159d89)，关闭 #4010
• 文档： 更改 url api -> swiper-api (3dc9203)
• 文档： 标题级别 (e8157e6)
• 滚动条： 修复当使用空的 scrollbar.el 初始化时，销毁时会抛出错误的问题
• svelte： slots 容器开始和结束 (b23b4e1)
• 缩放： 考虑窗口滚动以进行偏移 (60cd60a)，关闭 #4039

新特性

• 添加所有贡献者 (95b49b1)
• angular： 自定义类 (acc678a)

6.4.8 - 2021 年 1 月 22 日发布

• 核心
  • 改进了 Windows 触摸屏设备的默认行为
• 类型
  • 一些文档注释修复

6.4.7 - 2021 年 1 月 21 日发布

• 类型
  • 添加了所有 Swiper 参数的完整文档注释
• Angular
  • 正确支持缩放功能，需要额外的“zoom”元素。可以通过幻灯片上的 zoom 属性启用，例如 <ng-template swiperSlide [zoom]="true">
  • 修复了 SSR 问题
  • 修复了自定义 pagination.el 不起作用的问题

6.4.6 - 2021 年 1 月 20 日发布

• 核心
  • edgeSwipeDetection 参数现在可以接收字符串 'prevent' 以阻止系统滑动返回导航
  • 修复了当 slidesPerView 为小数时，最后一张幻灯片从未收到“active”类/状态的问题
  • 立方体
    • 修复了 Chrome 中的阴影渲染问题
• React/Svelte/Vue/Angular
  • 修复了虚拟幻灯片与断点一起使用时的渲染问题
• 小幅修复

6.4.5 - 2020 年 12 月 18 日发布

• 修复了 postinstall 脚本问题

6.4.4 - 2020 年 12 月 18 日发布

• 修复了 postinstall 脚本问题
• 现在所有组件也提供 .css 文件
• Svelte
  • 修复了包中 .svelte 文件位置错误的问题
• Angular
  • 类型修复
  • 添加了 [config] 支持，以单个对象传递所有 Swiper 参数 (https://github.com/nolimits4web/swiper/commit/f7d21c5f49860fdca62a31ccb62b01a790fd0df3)
  • 添加了 (index) 活动幻灯片绑定 (https://github.com/nolimits4web/swiper/commit/86670bd7c1b95268919147662383804e664011a7)
• 小幅修复

6.4.1 - 2020 年 12 月 9 日发布

• 修复了 6.4.0 中引入的类型错误

6.4.0 - 2020 年 12 月 8 日发布

• 所有新的 Swiper Angular 组件（感谢 @vltansky）🎉
• React
  • 现在 Swiper 在销毁时不会清除样式
• Svelte
  • 现在 svelte 包包含源 .svelte 组件
  • 现在 Swiper 在销毁时不会清除样式
• Vue
  • 现在 Swiper 在销毁时不会清除样式
• 懒加载
  • 现在它有选项可以检查 Swiper 在加载图像之前是否也在视图中（感谢 @ygj6）
• 构建
  • 修复了 sourcemap 缺少原始源的问题
• 许多小修复

6.3.5 - 2020 年 10 月 30 日发布

• 构建
  • 修复了 Windows 上的构建问题
• 核心
  • 修复了 shadow 组件中没有 swiping 类的问题 (#3868)
  • slideTo 的 index 参数类型检查

6.3.4 - 2020 年 10 月 20 日发布

• Vue
  • 修复了 Maximum recursive updates 问题

6.3.3 - 2020 年 10 月 9 日发布

• 核心
  • 修复了幻灯片带有内部滚动条时幻灯片计算错误的问题
• 自动播放
  • 现在，如果它到达末尾并且稍后将添加新幻灯片，它将继续自动播放
• React
  • 修复了幻灯片渲染函数数据仅在交互后才设置的问题
• 小幅修复

6.3.2 - 2020 年 9 月 28 日发布

• Svelte
  • 修复了使用断点时抛出错误的问题

6.3.1 - 2020 年 9 月 25 日发布

• 核心

  • A11y
    • 在所有其他模块初始化后初始化模块

6.3.0 - 2020 年 9 月 25 日发布

• 核心

  • A11y
    • 添加了新参数 containerMessage、containerRoleDescriptionMessage 和 itemRoleDescriptionMessage（#3834 感谢 @jenemde）

• React

  • 现在 SwiperSlide 组件需要设置唯一的 virtualIndex，以便 Swiper 确切知道渲染了哪个幻灯片

• Vue

  • 修复了与 v-for 一起使用时 SwiperSlide 未渲染的问题
  • 现在 SwiperSlide 组件需要设置唯一的 virtualIndex，以便 Swiper 确切知道渲染了哪个幻灯片

• 所有新的 Swiper Svelte 组件

  <Swiper spaceBetween="{50}" slidesPerView="{3}">
    <SwiperSlide>Slide 1</SwiperSlide>
    <SwiperSlide>Slide 2</SwiperSlide>
    ...
  </Swiper>
  <script>
    import { Swiper, SwiperSlide } from 'swiper/svelte';
  </script>
  

6.2.0 - 2020 年 9 月 4 日发布

• 所有新的 Swiper Vue.js (v3) 组件

  <template>
    <swiper :space-between="50" :slides-per-view="3">
      <swiper-slide>Slide 1</swiper-slide>
      <swiper-slide>Slide 2</swiper-slide>
      ...
    </swiper>
  </template>
  <script>
    import { Swiper, SwiperSlide } from 'swiper/vue';
  
    export default {
      components: {
        Swiper,
        SwiperSlide,
      },
    };
  </script>
  

6.1.3 - 2020 年 9 月 3 日发布

• 核心
  • 分页
    • 现在它不会在自定义渲染的子弹上设置 a11y 属性
• React
  • 修复了循环模式和断点未重新计算幻灯片的问题

6.1.2 - 2020 年 8 月 17 日发布

• React
  • 修复了在 Next.js 中生成 useLayoutEffect 警告的问题
  • 修复了 RTL 模式下虚拟列表的问题

6.1.1 - 2020 年 7 月 31 日发布

• 修复了 ESM/CJS 导入路径

6.1.0 - 2020 年 7 月 31 日发布

• 核心
  • 鼠标滚轮
    • 新的鼠标滚轮参数 thresholdDelta 和 thresholdTime (#3720)
  • 修复了 Navigation 和 Pagination .less 文件的问题 (#3724)
  • 修复了设置正确的 sideEffects 导致某些打包器不包含导入样式的问题 (#3708)
• React
  • 现在 SwiperSlide 接受带有 isActive、isVisible、isPrev、isNext、isDuplicate 属性的渲染函数

    <Swiper>
      <SwiperSlide>
        {({ isActive }) => <div>Current slide is {isActive ? 'active' : 'not active'}</div>}
      </SwiperSlide>
      <SwiperSlide>...</SwiperSlide>
      ...
    </Swiper>
    

• 小幅修复

6.0.4 - 2020 年 7 月 15 日发布

• 修复了 Swiper React 组件的 TS 定义 (#3692)

6.0.3 - 2020 年 7 月 14 日发布

• Dom7 更新到最新版本，带有正确的 __proto__ setter/getter

6.0.2 - 2020 年 7 月 9 日发布

• React
  • 现在，如果 pagination.el、scrollbar.el、navigation.nextEl 和 navigation.prevEl 从稍后可用的引用传递，Swiper 将自动更新

6.0.1 - 2020 年 7 月 7 日发布

• 核心

  • SCSS：修复了 Navigation 和 Pagination 中缺少 $colors 变量的问题

• React

  • 修复了事件处理程序属性中 Swiper 实例参数的类型定义
  • 添加了模块事件的事件处理程序属性定义

6.0.0 - 2020 年 7 月 3 日发布

• 新的 NPM 包结构

  • 所有脚本都转译为 ES5

  • 新的和重命名的文件 (BREAKING CHANGE)

    • swiper.less - 核心 Swiper LESS
    • swiper.scss - 核心 Swiper SCSS
    • swiper-bundle.css - Swiper 包 CSS
    • swiper-bundle.js - UMD 格式的 Swiper 包 JavaScript
    • swiper-bundle.cjs.js - CommonJS 格式的 Swiper 包 JavaScript
    • swiper-bundle.esm.js - ESM 格式的 Swiper 包 JavaScript
    • swiper.cjs.js - CommonJS 格式的 Swiper 核心 JavaScript
    • swiper.esm.js - ESM 格式的 Swiper 核心 JavaScript

  • 现在可以使用以下导入

    • import Swiper from 'swiper' - 导入核心版本
    • import Swiper from 'swiper/bundle' - 导入捆绑版本
    • import Swiper from 'swiper/core' - 导入核心版本

  • 组件可以从核心版本使用命名导入，或使用直接导入

    import { Navigation } from 'swiper';
    // or
    import Navigation from 'swiper/components/navigation';
    
    // and styles (Less or SCSS only)
    import 'swiper/components/navigation/navigation.less';
    

• 完全支持服务器端渲染 (SSR)，带新参数

  • userAgent - 设备用户代理，某些初始检测所需
  • url - 如果使用哈希导航或历史模块，则需要正确检测和设置初始幻灯片

• 新的 loopPreventsSlide 布尔参数（默认启用），在过渡进行中时阻止 slidePrev/Next 过渡

• 完全支持 Node.js DOM 库，如 JSDOM 和 Domino

• 添加了新的 onAny(callback) 监听器，用于监听任何 swiper 事件

• 所有事件现在都将 swiper 实例作为第一个参数发出 (BREAKING CHANGE)

• 添加了官方 TypeScript 定义

• 更新为使用下一代 dom7 和 ssr-window 库

• 所有新的 Swiper React 组件

  import { Swiper, SwiperSlide } from 'swiper/react';
  
  export default () => {
    return (
      <Swiper
        spaceBetween={50}
        slidesPerView={3}
        onSwiper={(swiper) => console.log(swiper)}
        onSlideChange={() => console.log('slide change')}
      >
        <SwiperSlide>Slide 1</SwiperSlide>
        <SwiperSlide>Slide 2</SwiperSlide>
        ...
      </Swiper>
    );
  };
  

5.4.5 - 2020 年 6 月 16 日发布

• 核心
  • 修复了 checkOverflow 方法在未安装 Navigation 模块时可能抛出错误的问题 (#3621)
• 键盘
  • 新参数 pageUpDown，用于启用/禁用 pageUp 和 pageDown 键（默认启用）

5.4.3 - 2020 年 6 月 13 日发布

• 核心
  • 从代码中删除了 UIWebView 文本
  • 修复了 resize 处理程序在不应该时将 slideTo 调用到最后一页的问题

5.4.2 - 2020 年 6 月 3 日发布

• 鼠标滚轮
  • 修复了启用 forceToAxis 也会反转滚动的问题
• Coverflow 效果
  • 添加了对 scale 参数的支持 (#3598)
• 分页
  • 修复了 uniqueNavElements 的检测问题 (#3590)

5.4.1 - 2020 年 5 月 20 日发布

• 修复了依赖版本问题

5.4.0 - 2020 年 5 月 15 日发布

• 哈希导航
  • 添加了 hashChange 和 hashSet 事件 (#3557)
• 懒加载
  • 添加了对 <picture> 懒加载的支持 (#3560)
• 鼠标滚轮
  • 可能改善了 Windows/Linux 操作系统上的垂直滚动问题
• 将 ssr-window 和 dom7 依赖项更新到最新版本
• 小幅修复

5.3.8 - 2020 年 4 月 24 日发布

• 核心
  • 修复 iOS 在 free mode 惯性反弹时的双重反弹 bug
• A11y
  • 修复了导航按钮上的焦点环 (#3544)
  • 修复了 paginationBulletMessage 中的 RegExp 问题 (#3540, #3541)
• 缩略图
  • 添加了 thumbs.autoScrollOffset 参数，允许设置活动幻灯片距离边缘的缩略图数量。它应该自动移动滚动缩略图
• 小幅修复

5.3.7 - 2020 年 4 月 10 日发布

• 核心
  • 修复了 RTL 布局中 cssMode 行为的问题
• 缩放
  • 修复了虚拟幻灯片双击切换不起作用的问题
• 小幅修复

5.3.6 - 2020 年 2 月 29 日发布

• 核心
  • 修复了启用 centeredSlides 时自动高度计算错误的问题
• 懒加载
  • 现在，懒加载图片加载后将更新自动高度（如果启用）(#3466)
• 缩放
  • 修复了 previously active slide 可以通过 zoom.in() API 缩放的问题 (#3451)
  • 修复了 <picture> 元素缩放不起作用的问题 (#3456)
  • 添加了通过为自定义缩放目标元素添加 swiper-zoom-target 类来支持自定义缩放目标元素
• Coverflow 效果
  • stretch 参数现在可以设置为 % (#3468)
• 小幅修复

5.3.1 - 2020 年 2 月 8 日发布

• 核心
  • 修复了滑块在最后一页后可能会卡住的问题 (#3414)
  • 将 label 添加到表单事件列表，以保持其上的点击 (#3407)

5.3.0 - 2020 年 1 月 11 日发布

• 核心
  • 新的 slidesPerGroupSkip 行为 (#3361)
  • 新的基于比率的断点 (#3389)
  • 添加了 SCSS 插值 (#3373, #3374)
• 鼠标滚轮
  • 修复了加载时可能失败的问题 (#3383)
• 小幅修复

5.2.1 - 2019 年 11 月 16 日发布

• 核心
  • 新的循环事件 beforeLoopFix 和 loopFix
  • 新参数 updateOnWindowResize（默认 true），将在窗口大小调整/方向改变时更新/重新计算 swiper
  • 在不从源构建时为 --swiper-theme-color 变量添加了 SCSS 插值 (#3334)
  • 引用 SCSS 颜色名称 (#3316)
  • 修复了 .once 可能被调用多次的问题 (#3322)
• 鼠标滚轮
  • 修复了滚轮意外冻结效果 (#3328)
• 缩略图
  • 新的 multipleActiveThumbs（默认 true）选项，用于控制是否可以激活多个缩略图幻灯片。
• 小幅修复

5.2.0 - 2019 年 10 月 26 日发布

• 核心
  • 新的 centeredSlidesBounds 参数，启用后将使第一张和最后一张幻灯片保持在边界内
  • 修复了 freeMode 在调整大小后可能破坏位置的问题 (#2708, #3303)
  • 修复了 freeModeSticky 的过渡持续时间问题 (#3302)
  • 修复了非完整组时错误的行/列问题 (#3294)
  • 修复了 watchOverflow 和 slidesOffsetBefore/slidesOffsetAfter 无法协同工作的问题 (#3291)
• 鼠标滚轮
  • 更快更流畅的鼠标滚轮惯性滚动 (#3304)
• 包
  • 为包构建添加了源映射 (#3306)
  • 添加了 browser.esm.bundle 的压缩版本
• 小幅修复

5.1.0 - 2019 年 10 月 16 日发布

• 核心
  • 修复了 iOS 13 上的触摸问题
  • 新的 translateTo 方法 #3268
• 分页
  • 改进了 loop: true 时动态子弹的行为 #3255
• 缩放
  • 修复了 Android 上捏合缩放的问题
• 小幅修复

5.0.4 - 2019 年 9 月 30 日发布

• 核心
  • 现在，在导航按钮上的短滑动手势将被视为导航按钮点击 (#3237 by @robpop)
  • 修复了传递浮点型 slidesPerView 可能破坏循环模式的问题 (#3225 by @robpop)
• 滚动条
  • 修复了滚动条点击时“指针”位置计算错误的问题
• 自动播放
  • 修复了从隐藏标签返回后 paused 的问题
• 小幅修复

5.0.3 - 2019 年 9 月 19 日发布

• 核心
  • touchEventsTarget 默认回退为 container
  • 添加了 touchcancel 事件的处理 #3219
  • 修复了 slidesPerColumnFill: 'row' 模式下顺序计算错误的问题
  • 修复了虚拟模式下幻灯片预加载时幻灯片错位的问题
  • 修复了移动设备上缩放图片仍会滑动到另一张幻灯片的问题

5.0.1 - 2019 年 9 月 17 日发布

• 核心
  • 修复了代码中的错别字

5.0.0 - 2019 年 9 月 17 日发布

• 核心
  • 全新的 CSS Scroll Snap 模式（可以通过 cssMode: true 启用）。它不支持 Swiper 的所有功能，但在简单配置中可能会带来更好的性能
  • 完全移除 Internet Explorer 支持
  • breakpointsInverse 参数已移除，现在 breakpoints 的行为与以前的 breakpointsInverse: true 相同。
  • touchMoveStopPropagation 参数现在默认为 false
  • click 事件不再有 300 毫秒的延迟。现在它将与 tap 事件同时触发
  • 当 slidesPerColumnFill: 'column' 时，现在使用 flex-direction: column 布局，这需要 swiper-container 指定高度
  • touchEventsTarget 现在默认为 wrapper（以前是 container）
  • slidesPerColumn 现在可以与断点一起使用
  • 现在 Swiper 样式使用 CSS 自定义属性（CSS 自定义变量）来指定 swiper 的颜色主题（导航按钮/分页的颜色）。现在是 --swiper-theme-color: #007aff;
  • 改进了 es 模块的“tree-shake-ability”
  • 新的 swiper.esm.browser.bundle.js 包可以直接在浏览器中使用（import Swiper from 'swiper.esm.browser.bundle.js'）
• 自动播放
  • 现在，当文档隐藏（在非活动标签中）时，它将暂停，并在文档可见时再次继续
• 懒加载
  • Swiper 预加载器图像替换为更简单的加载器。现在其颜色可以通过 --swiper-preloader-color CSS 自定义属性更改（默认为 --swiper-theme-color）
• 分页
  • 活动分页子弹和分页主题颜色现在使用 CSS 自定义属性。可以通过 --swiper-pagination-color 属性定义（默认为 --swiper-theme-color）
• 导航
  • 导航图标通过内置（base64）图标字体重新设计。它允许应用任何颜色和大小，而无需替换图像
  • 导航按钮颜色现在使用 CSS 自定义属性。可以通过 --swiper-navigation-color 属性定义（默认为 --swiper-theme-color）
  • 通过 --swiper-navigation-size（默认为 44px），现在可以更改导航按钮（和图标）的大小
• 小幅修复和改进

4.5.1 - 2019 年 9 月 13 日发布

• 核心
  • 修复了回调在初始化时触发，即使它被禁用 (#2807)
  • 修复了“swiper-slide-visible”类名在某些情况下不应显示时出现的问题
  • slidesPerColumnFill: 'row' 现在考虑组 (#3077)
• 缩略图
  • 修复了有时在使用缩略图时出现的“无法读取未定义的 indexOf 属性”错误
• 键盘
  • 添加了 PageUp/PageDown 键绑定。
• 自动播放
  • 修复了窗口大小调整停止自动播放的问题
• 视差
  • 修复了视差不透明度不起作用的问题 (#3147)
• 小幅修复和改进

4.5.0 - 2019 年 2 月 22 日发布

• 核心
  • 新的 swiper.changeDirection() 方法，用于动态改变方向（从水平到垂直，反之亦然）
  • direction 参数可在断点中使用
• 虚拟幻灯片
  • swiper.virtual.appendSlide 现在接受幻灯片数组
  • swiper.virtual.prependSlide 现在接受要前置的幻灯片数组
  • 新的 swiper.virtual.removeSlide(indexes)，用于移除虚拟选定的幻灯片
  • 新的 swiper.virtual.removeAllSlides()，用于移除所有虚拟幻灯片
• 导航
  • 现在，在导航隐藏/显示时，它会发出 navigationHide 和 navigationShow 事件
• 分页
  • 现在，在分页隐藏/显示时，它会发出 paginationHide 和 paginationShow 事件
• Dom7 更新到最新 2.1.3
  • 修复了使用 .off 解绑后 .once 绑定的事件仍然存在的问题
• 源
  • 源样式现在除了 LESS 之外，还提供 SCSS
• 小幅修复和改进

4.4.6 - 2018 年 12 月 19 日发布

• 核心
  • 修复了某些情况下幻灯片大小计算错误的问题

4.4.5 - 2018 年 12 月 14 日发布

• 核心
  • 新参数 observeSlideChildren，用于在幻灯片子元素更新时启用自动更新
  • 修复了计算大小时未考虑幻灯片填充的问题
  • 修复了 Windows Chrome 上触摸支持检测错误的问题
  • 修复了多行模式下幻灯片网格计算错误的一些问题
• 缩放
  • 现在发出 zoomChange 事件，带有 scale、imageEl 和 slideEl 参数
• 小幅修复

4.4.2 - 2018 年 11 月 1 日发布

• 新参数 touchStartForcePreventDefault，用于强制阻止 touch start 事件的默认行为
• 断点修复，当断点键为字符串时
• 修复了桌面 Safari 上可拖动滚动条可能不起作用的问题
• 修复了虚拟幻灯片排序错误的问题
• 小幅修复

4.4.1 - 2018 年 9 月 14 日发布

• 修复了阻止 touchstart 事件的问题

4.4.0 - 2018 年 9 月 14 日发布

• 核心
  • 新参数 centerInsufficientSlides，用于在幻灯片数量少于 slidesPerView 时居中幻灯片
  • 新参数 breakpointsInverse（布尔值），如果启用，则会反向计算断点，例如，当窗口宽度大于指定断点时，将覆盖参数
• 虚拟幻灯片
  • 新参数 addSlidesBefore 和 addSlidesAfter，用于增加预渲染幻灯片的数量
• 缩略图
  • 全新“缩略图”模块/组件，旨在以比控制器模块更逻辑和正确的方式控制滑块缩略图。
• 许多小修复

4.3.5 - 2018 年 7 月 31 日发布

• 核心
  • iOSEdgeSwipeThreshold 参数重命名为 edgeSwipeThreshold。旧的 iOSEdgeSwipeThreshold 名称仍然受支持
  • 如果同时发生许多突变，观察者性能得到改善。感谢 @rayvincent-bsd
• 控制器
  • 修复了自动高度调整错误的问题
• 滚动条
  • 修复了使用主动事件监听器而不是被动事件监听器的问题。感谢 @nyon
• 小幅修复

4.3.3 - 2018 年 6 月 5 日发布

• 核心
  • 修复了 slidePrev 转到错误幻灯片的问题 #2650
  • 修复了 roundLength 未被考虑用于网格计算的问题 #2656
  • 修复了 API 中的错别字 #2659

4.3.2 - 2018 年 6 月 1 日发布

• 核心
  • 添加了 addSlide(index, slide) 方法，用于在所需位置添加幻灯片。感谢 @kochizufan
  • 修复了循环问题 #2647。感谢 @kochizufan
• 分页
  • 新的 formatFractionCurrent(number) 参数，用于格式化分数分页中的当前数字
  • 新的 formatFractionTotal(number) 参数，用于格式化分数分页中的总数字
• 小幅修复

4.3.0 - 2018 年 5 月 27 日发布

• 核心
  • 修复了 swipeBack 有时滑动到错误幻灯片的问题
  • 修复了窗口大小调整可能破坏 Coverflow 效果布局的问题
  • 修复了 iOSEdgeSwipeDetection 检测错误的问题。感谢 @langjun
• Dom7 更新到最新 v2.0.6
  • 修复了未添加事件监听器时删除事件监听器的问题
• 小幅修复

4.2.6 - 2018 年 5 月 1 日发布

• console.log 清理

4.2.5 - 2018 年 4 月 29 日发布

• 核心
  • 当 swiper 锁定时，阻止应用抓取光标
  • 修复了循环断点在初始化时获取错误的 realIndex
  • 修复了“已转换”幻灯片大小计算问题，这可能会导致 Coverflow 效果出现问题
• 自动播放
  • 修复了可能导致内存泄漏的问题
• Dom7 更新到最新版本
  • 改进了内部事件代理逻辑，以实现更好的内存管理
• 小幅修复

4.2.2 - 2018 年 4 月 1 日发布

• 核心
  • 调用 Swiper 的 .update() 方法时，尊重并更新断点
• 分页
  • 新参数 progressbarOpposite，用于使分页进度条与 direction 参数相反，这意味着水平 Swiper 方向的垂直进度条和垂直 Swiper 方向的水平进度条
• 鼠标滚轮
  • 修复了 loop + freeMode 中循环未正确设置的问题
• 小幅修复

4.2.0 - 2018 年 3 月 16 日发布

• 核心
  • swiper.updateAutoHeight(speed) 现在支持 speed 参数，以根据持续时间调整 swiper 包装器大小
  • 修复了 free mode 中 freeModeSticky 无法吸附到最近吸附点的问题
  • 新的 swiper.slideToClosest() 方法，用于在幻灯片处于中间位置时滑动到最近的吸附点
• A11y (可访问性)
  • 现在默认启用（如果已安装）
• 控制器
  • 修复了 RTL 问题，当垂直 swiper 控制水平 swiper 时
• 懒加载
  • 修复了窗口大小调整时懒加载并非总是触发的问题
• 小幅修复

4.1.6 - 2018 年 2 月 11 日发布

• 修复了触摸设备上的 onTouchMoveOpposite 事件

4.1.5 - 2018 年 2 月 10 日发布

• 改进了对带有触摸屏的桌面 Windows 设备的触摸事件支持
• 改进了滑块处于自由模式时的“循环修复”
• 新参数 noSwipingSelector，可用于替代 noSwipingClass
• 新参数 preventIntercationOnTransition，用于在幻灯片切换过渡期间阻止交互
• 新方法 .slideToLoop，用于循环模式
• 修复了幻灯片未实际更改时触发 slideChange 事件的问题
• 滚动条
  • 现在，当桌面设置为 draggable 时，不需要启用 simulateTouch
• 键盘
  • 修复了 swiper 是否在视口中的检测语句
• 分页
  • 为动态子弹分页添加了新的多主子弹支持
• 缩放
  • 现在支持虚拟幻灯片
• 小幅修复

4.1.0 - 2018 年 1 月 13 日发布

• 改进了 IE 10 支持。但建议使用 proto polyfill
• 改进了 Edge 的触摸支持
• 新参数 watchOverflow（默认禁用）。启用后，如果幻灯片不足以滑动，Swiper 将被禁用并隐藏导航按钮
• 自动播放
  • 新参数 reverseDirection，用于启用反向自动播放
  • 新参数 waitForTransition，自动播放将等待包装器过渡才能继续（默认启用）。在您的滑块可能没有过渡的情况下，可以禁用虚拟翻译
• 键盘
  • 新增了 onlyInViewport 参数（默认启用）。启用后，它将控制当前在视口中的滑块。

4.0.7 - 发布于2017年11月28日

• 修复了在 iOS 上 touchReleaseOnEdges 未能正确工作的问题。
• 修复了在断点处 allowSlideNext/Prev 更改未能工作的问题。
• 修复了使用自定义 dragSize 时滚动条拖动不正确的问题。
• 小幅修复

4.0.6 - 发布于2017年11月13日

• 修复了 Coverflow 效果与断点一起使用时的问题。
• iOSEdgeSwipeDetection 也将考虑右边缘滑动。
• 修复了 RTL 模式下 freeModeSticky 的行为。
• Swiper 现在在断点更改时会发出 breakpoint 事件。
• 小幅修复

4.0.5 - 发布于2017年11月7日

• 修复了 noSwiping 参数未能工作的问题。
• 视差现在考虑 slidesPerGroup 参数。
• 缩放：改进了手势处理。
• 分页：修复了幻灯片不足时动态子弹位置不正确的问题。
• 修复了启用 breakpoints 时某些效果被破坏的问题。
• 小幅修复

4.0.3 - 发布于2017年10月27日

• 修复了视差不透明度和缩放过渡。
• 通过使用虚拟 document 对象，更好地兼容 SSR。
• 修复了 RTL 模式下动态分页按钮的样式。
• 修复了在 slidesPerView: 'auto' 时最后一个分页按钮未激活的问题。
• 重命名了构建任务：build-dev -> build:dev，build-prod -> build:prod。

4.0.2 - 发布于2017年10月18日

• 虚拟幻灯片的懒加载支持。
• 添加了 beforeResize 事件。
• 小幅修复

4.0.1 - 发布于2017年10月11日

• 修复了循环模式下分页功能失效的问题。
• 重构了 realIndex 的计算顺序。
• ES 模块文件已重命名（**可能存在破坏性更改**）。
  • swiper.module.js -> swiper.esm.bundle.js (默认导出)。
  • swiper.modular.js -> swiper.esm.js。
• 小幅修复

4.0.0 - 发布于2017年10月4日 🎉

• 新 API（查看文档）。
• 虚拟幻灯片 - 新模块，仅在 DOM 中保留所需数量的幻灯片。
• 源代码已完全用 ES-next 语法重写。
• 分发包包含额外的 ES-next 模块。
  • swiper.module.js - 用于 import Swiper from 'swiper' 的 swiper 包。
  • swiper.modular.js - 用于仅使用所需组件的 Swiper 模块化版本。
• 新的 scripts/build-config.js 用于创建具有所需组件和自定义颜色主题的自定义 Swiper 构建。
• Swiper 的 jQuery 版本已移除。
• 改进了与服务器端渲染的兼容性。
• 数百项改进和修复。

4.0.0-beta.4 - 发布于2017年9月20日

• 修复了 RTL 布局中可拖动滚动条的问题。
• 小幅修复

4.0.0-beta.3 - 发布于2017年9月13日

• Dom7 更新到最新版本。
• 对核心进行了一些小的重构，以在 tree-shaking 打包中获得更好的结果。

4.0.0-beta.2 - 发布于2017年9月2日

• 默认禁用 a11y。
• 修复了多个 swiper 之间事件共享的问题。
• 修复了销毁后调整大小处理的问题。
• 少量次要修复。

4.0.0-beta.1 - 发布于2017年8月30日

• 4.0.0 首次发布。

3.4.2 - 发布于2017年3月10日

• 修复了 swiper 销毁时懒加载回调的问题。
• 新增 onAfterResize 和 onBeforeResize 回调。
• 使用键盘控制时新增 onKeyPress 回调。
• 修复了 Chrome+Windows 中带有“title”属性的链接无法点击的问题。
• 小幅修复

3.4.1 - 发布于2016年12月13日

• 修复了 RTL 模式下的缩放。
• 改进了启用循环时 slideToClickedSlide 的行为。
• 小幅修复

3.4.0 - 发布于2016年10月16日

• 自定义构建可用。现在您可以使用以下模块创建自定义 Swiper 构建：效果、懒加载、滚动条、控制器、哈希导航、历史记录、键盘、鼠标滚轮、视差、缩放、a11y。使用 cli gulp custom -zoom,effects,lazy-loading。
• 新增缩放功能，支持双击和捏合缩放幻灯片内部图像。
  • 缩放所需的幻灯片布局。

    <div class="swiper-slide">
      <div class="swiper-zoom-container">
        <img src="path/to/image">
      </div>
    </div>
    

  • 新增缩放参数。
    • zoom - 启用缩放功能。
    • zoomMax - 最大图像缩放倍数，默认为 3。
    • zoomMin - 最小图像缩放倍数，默认为 1。
    • zoomToggle - 启用/禁用双击幻灯片进行缩放。
  • zoomMax 也可以通过在特定幻灯片上使用 data-swiper-zoom 属性进行覆盖。
• 新增 swiper.enableTouchControl() 和 swiper.disableTouchControl() 方法来启用/禁用触摸控制（它会切换 onlyExternal 参数）。
• 除了 swiper.activeIndex 之外，新增 swiper.realIndex 属性，它返回考虑循环的活动幻灯片的索引。
• 新增历史 API 和 history 参数。它使用 history pushState 来设置活动幻灯片 URL。
• 新增 hashnavWatchState 参数，用于通过浏览器历史记录或直接设置文档位置上的哈希值来导航幻灯片（当哈希导航启用时）。
• 新增 replaceState 参数，与哈希导航或历史记录一起使用，用新的 URL 状态替换当前 URL 状态，而不是将其添加到历史记录中。
• 新增方法 s.unsetGrabCursor() 和 s.setGrabCursor() 来启用/禁用抓取光标。
• 当 simulateTouch:false 时，可拖动滚动条现在可以工作。
• 新增 normalizeSlideIndex 参数以改进控制器的工作（参见 #1766）。
• lazyLoadingInPrevNextAmount 现在与 slidesPerView: 'auto' 一起工作。
• 新增 passiveListeners 参数，用于使用被动事件监听器以提高移动设备上的滚动性能。默认启用。
• 新增 freeModeMomentumVelocityRatio 参数来控制动量速度。
• 现在可以通过在幻灯片上使用 data-swiper-autoplay 属性来为每个（或特定）幻灯片指定自动播放延迟。
• 懒加载现在也遵循 sizes 响应式图像属性。
• 改进了鼠标滚轮的跨浏览器行为（参见 #1797）。
• 新增 mousewheelEventsTarged 参数（默认为 'container'），您可以在其中指定鼠标滚轮事件目标。
• 新增 onScroll 事件/回调，当使用鼠标滚轮进行滑动/滚动时触发。
• 新增 touchReleaseOnEdges 参数，用于在滑块边缘位置（开始、结束）释放触摸事件，并允许进一步页面滚动。
• 垂直方向的多行（slidesPerColumn）支持，在这种情况下变为多列。
• paginationBulletRender 现在接受 swiper 实例作为第一个参数，paginationBulletRender(index, className) -> paginationBulletRender(swiper, index, className)。
• 新增“swiper-slide-duplicate-active”、“swiper-slide-duplicate-next”、“swiper-slide-duplicate-prev”类，这些类将在循环模式下添加到表示重复循环幻灯片的幻灯片中。
• 所有 CSS 类现在都可以通过新参数进行配置：lazyLoadingClass、notificationClass、containerModifierClass、paginationClickableClass、paginationModifierClass、lazyStatusLoadingClass、lazyStatusLoadedClass、lazyPreloaderClass、notificationClass、preloaderClass、zoomContainerClass、slideDuplicateActiveClass、slideDuplicateNextClass、slideDuplicatePrevClass。

3.3.1 - 发布于2016年2月7日

• 新增 uniqueNavElements 参数。如果启用（默认），并且导航元素的参数以字符串形式传递（例如 .pagination），那么 Swiper 将首先通过子元素查找这些元素。适用于分页、上一个/下一个按钮和滚动条。
• 新增 onPaginationRendered 回调。将在分页元素生成并添加到 DOM 后触发。
• 新增 .reLoop() 方法，它结合了 .destroyLoop() + .createLoop() 方法，并附带额外的定位修复。在更改 slidesPerView 参数后调用非常有用，它将动态重新创建循环所需的重复幻灯片。
• 新增 .nextButton 和 .prevButton 属性，其中包含带上一个/下一个按钮 HTML 元素的 Dom7/jQuery 元素。
• 修复了 IE 11 中鼠标滚轮控制失效的问题。
• 修复了窗口调整大小后懒加载图像未重新计算的问题。
• 修复了在循环模式下使用断点更改 slidesPerView/Group 参数时的问题。
• 大量小修复。

3.3.0 - 发布于2016年1月10日

• 新增 3D 翻转效果。可通过 `effect: 'flip'` 参数启用。
• 新增带新参数的分页类型。
  • paginationType - 分页类型。可以是 'bullets'（默认）或 'fraction' 或 'progress' 或 'custom'。
  • paginationFractionRender(swiper, currentClass, totalClass) - 渲染“fraction”类型分页的自定义函数。
  • paginationProgressRender(swiper, progressbarClass) - 渲染“progress”类型分页的自定义函数。
  • paginationCustomRender(swiper, current, total) - 渲染“custom”类型分页的自定义函数。
• 新增 lazyLoadingInPrevNextAmount 参数，允许在指定数量的下一个/上一个幻灯片中懒加载图像。
• 新增 autoplayStopOnLast 参数（默认为 true），指示自动播放是否应在最后一张幻灯片停止或从第一张幻灯片开始。
• 新增 onAutoplay(swiper) 回调。
• 小幅修复

3.2.7 - 发布于2015年12月7日

• 修复了在断点处使用 HTMLElements 作为 next/prevButton 参数的问题。
• 修复了使用控制器时自动高度失效的问题。

3.2.6 - 发布于2015年11月28日

• 修复了在 RTL 布局中使用 mousewheelControl 的问题。
• 修复了在 RTL 布局中使用视差的问题。

3.2.5 - 发布于2015年11月21日

• 新增“自动高度”模式，容器/包裹器会适应当前活动幻灯片的高度。可通过 autoHeight: true 参数启用。
• 修复了 Firefox 中断点的问题。
• 修复了使用效果时幻灯片位置不正确的问题。
• 修复了使用 setWrapperTranslate 后滚动条未更新的问题。
• 小幅修复

3.2.0 - 发布于2015年11月7日

• 新增使用 breakpoints 参数的响应式断点支持。现在您可以为不同的尺寸指定不同的 slidesPerView 和其他类似参数。

  slidesPerView: 5,
  spaceBetween: 50,
  breakpoints: {
    1024: {
      slidesPerView: 4,
      spaceBetween: 40
    },
    768: {
      slidesPerView: 3,
      spaceBetween: 30
    },
    320: {
      slidesPerView: 1,
      spaceBetween: 10
    }
  }
  

• 新增回调：onSlideNextStart、onSlideNextEnd、onSlidePrevStart、onSlidePrevEnd。

• 添加了 Meteor 包 meteor add nolimits4web:swiper。

• 修复了鼠标 touchMove/End 回调一直触发的问题。

• 修复了 Chrome 中鼠标滚轮的问题。

• 小幅修复

3.1.7 - 发布于2015年10月10日

• 修复了懒加载尝试下载 undefined-src 图像的问题。
• 修复了使用 jQuery 版本的幻灯片懒加载问题。
• 修复了 slideToClickedSlide 与 loop 和 centeredSlides 一起使用时的问题。
• 修复了当幻灯片数量少于 slidesPerView * slidesPerColumn 且 slidesPerColumnFill: 'row' 时，幻灯片填充不正确的问题。
• 小幅修复

3.1.5 - 发布于2015年9月28日

• 新增通过 data-srcset 属性懒加载图像 srcset 的支持。
• 修复了新 Chrome 中 WebkitCSSMatrix 的错误。
• 修复了 slideToClickedSlide 与 loop 和 centeredSlides 一起使用时的问题。
• 新增 freeModeMinimumVelocity 参数，用于设置触发自由模式动量所需的最小触摸速度。
• 通过新参数使滚动条可拖动。
  • scrollbarDraggable - (布尔值) 默认为 false。允许启用可拖动滚动条。
  • scrollbarSnapOnRelease - (布尔值) 默认为 false。控制滚动条释放时滑块的吸附。
• 小幅修复

3.1.2 - 发布于2015年8月22日

• 修复了循环和鼠标滚轮在swiper停在最后一张幻灯片时的问题。
• 改进了最新 Chrome 中的鼠标滚轮行为。
• 修复了 slidesPerView: 'auto' 和启用 loop:true 模式时，默认设置 loopedSlides 为幻灯片数量（如果未指定）的问题。
• 新增 mousewheelSensitivity: 1 参数，允许调整鼠标滚轮灵敏度。
• 修复了当滑动被锁定（使用 allowSwipeToNext/allowSwipeToPrev）时，swiper 更新的问题。
• 修复了启用 centeredSlides 时“可见”幻灯片计算不正确的问题。
• 3D 效果的 CSS 修复。
• 新增选项，用于在 iOS UIWebView 中释放 Swiper 事件以实现滑动返回功能，有两个选项：
  • iOSEdgeSwipeDetection (默认为 false) - 启用 iOS 边缘检测并释放 Swiper 事件。
  • iOSEdgeSwipeThreshold (默认值为 20) - 屏幕左边缘的 px 区域，用于释放事件。
• 改进了源映射。
• 小幅修复

3.1.0 - 发布于2015年7月14日

• 无障碍访问 (a11y)
  • 修复了按钮标签错误的问题。
  • 增加了对分页子弹的支持。
  • 新增分页标签的无障碍参数 paginationBulletMessage: 'Go to slide {{index}}'。
• 控制器
  • 新增参数 controlBy，可以是 'slide'（默认）或 'container'。定义了控制另一个滑块的方式：逐个幻灯片或根据所有幻灯片/容器（像以前一样）。
  • 现在 controlBy: 'slide'（默认）模式下的控制器将相互尊重网格。
• 分页
  • 新增 paginationElement 参数，定义将用于表示单个分页子弹的 HTML 标签。默认是 span。
• 新增 roundLengths 参数（默认为 false），用于对幻灯片宽度和高度值进行四舍五入，以防止在常规分辨率屏幕上出现模糊文本。
• 新增 slidesOffsetBefore: 0 和 slidesOffsetAfter: 0 (以 px 为单位) 参数，用于在容器内添加额外的幻灯片偏移。
• 在使用 CSS padding 在 .swiper-container 上时，对幻灯片尺寸进行正确计算。
• 修复了当滑动被锁定时 onResize 处理程序不工作的问题。
• 修复了在 touchmove 期间禁用 onlyExternal 时出现的“跳跃”效果问题。
• 修复了窗口调整大小后滑块从最后一张幻灯片跳到上一张幻灯片的问题。
• 添加了新版本 swiper.jquery.umd.js，用于同时包含 Swiper 和 jQuery 作为模块的环境。
• 小幅修复

3.0.8 - 发布于2015年6月14日

• 修复了淡入淡出效果中错误的活动索引和回调问题。
• 新增鼠标滚轮参数。
  • mousewheelReleaseOnEdges - 当 swiper 位于边缘位置（开始或结束）时，将释放鼠标滚轮事件并允许页面滚动。
  • mousewheelInvert - 反转鼠标滚轮幻灯片的选项。
• 修复了当 slidesPerView > 1 时，下一张幻灯片懒加载的问题。
• 修复了滑动被锁定时阻力边界的问题。
• 修复了多行模式下（当 slidesPerColumn > 1 时）幻灯片顺序错误的问题。
• 修复了 RTL 模式下键盘控制失效的问题。
• 修复了嵌套淡入淡出效果 swiper 的问题。
• 小幅修复

3.0.7 - 发布于2015年4月25日

• 新增 width 和 height 参数，用于强制 Swiper 大小，在初始化时隐藏时非常有用。
• 更好地支持“滚动容器”。现在 Swiper 可以用作带有单个“可滚动”/“可滑动”幻灯片的滚动容器。
• 为带有 data-background 属性的必需元素的背景图像添加了懒加载。
• 新增“自由模式粘性”（使用 freeModeSticky 参数），它将在自由模式下吸附到幻灯片位置。
• 修复了懒加载问题。
• 修复了启用循环模式时幻灯片删除的问题。
• 修复了自动播放和淡入淡出效果的问题。
• 小幅修复

3.0.6 - 发布于2015年3月27日

• 修复了在使用“淡入淡出”效果时有时幻灯片位置不正确的问题。
• .destroy(deleteInstance, cleanupStyles) 方法现在有第二个 cleanupStyles 参数，当传递时，将从幻灯片、包裹器和容器中删除所有自定义样式。如果您需要销毁 Swiper 并用新选项或不同方向重新初始化时非常有用。
• 小幅修复

3.0.5 - 发布于2015年3月21日

• 新增键盘无障碍访问模块，通过新参数为屏幕阅读器提供可聚焦的导航按钮和基本 ARIA。
  • a11y: false - 启用无障碍访问。
  • prevSlideMessage: 'Previous slide' - 上一个按钮的屏幕阅读器消息。
  • nextSlideMessage: 'Next slide' - 下一个按钮的屏幕阅读器消息。
  • firstSlideMessage: 'This is the first slide' - 当 swiper 位于第一张幻灯片时，上一个按钮的屏幕阅读器消息。
  • lastSlideMessage: 'This is the last slide' - 当 swiper 位于最后一张幻灯片时，下一个按钮的屏幕阅读器消息。
• 新增 Emitter 模块。它允许像事件一样处理回调，甚至在初始化后使用新方法添加回调。
  • .on(event, handler) - 添加事件/回调。
  • .off(event, handler) - 移除此事件/回调。
  • .once(event, handler) - 添加将只执行一次的事件/回调。
• 插件 API 回归。它允许编写自定义 Swiper 插件。
• 更好地支持不支持 flexbox 布局的浏览器。
• 新增参数 setWrapperSize（默认为 false），以提供与不支持 flexbox 的浏览器的更好兼容性。启用此选项后，插件将设置 swiper 包裹器的宽度/高度等于所有幻灯片的总大小。
• 新增 virtualTranslate 参数。启用后，swiper 将像往常一样操作，只是它不会移动。当您可能需要创建自定义幻灯片过渡时非常有用。
• 新增对多个分页容器的支持。
• 修复了 onLazyImage... 回调。
• 修复了 Android < 4.4 上幻灯片内部链接无法访问的问题。
• 修复了循环模式下指定 slidesPerGroup 时分页子弹的行为。
• 修复了 IE 10+ 触摸设备上的点击问题。
• 修复了 IE 10+ 上 Coverflow 支持的问题。
• Hashnav 现在将在过渡后更新文档哈希，以防止浏览器 UI 延迟，而不是像以前那样在开始时更新。
• 使用 swiper.jquery 版本对 IE 9 提供超基本支持。没有动画和过渡，但基本的滑动/分页/滚动条等功能可用。

3.0.4 - 发布于2015年3月6日

• 新增图像懒加载组件。
  • 带新参数 lazyLoading、lazyLoadingInPrevNext、lazyLoadingOnTransitionStart（所有默认禁用）。
  • 带新回调 onLazyImageLoad 和 onLazyImageReady。
• updateOnImages ready 分成 2 个参数。
  • preloadImages（默认为 true）- 在 swiper 初始化时预加载所有图像。
  • updateOnImages（默认为 true）- 所有图像加载后更新 swiper。
• 修复了聚焦表单元素上 touchmove 的问题。
• 新增 onObserverUpdate 回调函数，用于在观察者更新后调用。
• 修复了 jQuery 版本中键盘控制下输入框失效的问题。
• 新增 paginationBulletRender 参数，接受一个函数，允许自定义分页元素的布局。
• 哈希导航将根据 runCallbacksOnInit 参数运行回调。
• watchVisibility 参数重命名为 watchSlidesVisibility。

3.0.3 - 发布于2015年3月1日

• 修复了调用 .slideTo(runCallbacks=false) 后 onSlideChangeEnd 回调不触发的问题。
• 修复了只有一张幻灯片时 isBeginning/isEnd 的值。
• 新增淡入淡出效果的 crossFade 选项。
• 改进了对同时支持触摸和鼠标输入的设备的支持，IE 尚未支持。
• 修复了 swiper.jquery 版本中鼠标滚轮和键盘控制未能正确工作的问题。
• 新增视差模块，用于内部元素的视差效果过渡。
• 改进了 .update 和 .onResize 方法。
• 小幅修复

3.0.2 - 发布于2015年2月22日

• 修复了 Swiper.destroy 未清除键盘事件的问题。
• 为 IE 支持编码了内联 SVG 图像。
• 新增回调：
  • onInit (swiper)
  • onTouchMoveOpposite (swiper, e)
• 修复了 RTL 布局中的自由模式动量。
• .update 方法改进，以完全覆盖 onResize 的功能，实现完整且正确的更新。
• 暴露了 swiper.touches 对象，包含以下属性：startX、startY、currentX、currentY、diff。
• 新增删除幻灯片的方法：
  • .removeSlide(index) 或 .removeSlide([indexes]) - 删除选定的幻灯片。
  • .removeAllSlides() - 删除所有幻灯片。

3.0.1 - 发布于2015年2月13日

• 修复了 Firefox 循环模式下导航按钮的问题。
• 修复了 IE 10+ 中图像拖动的问题。

3.0.0 - 发布于2015年2月11日

• 全新 Swiper 3 首次发布。
• 移除的功能：
  • 放弃了对旧浏览器的支持。现在它兼容：
    • iOS 7+
    • Android 4+ (多行模式仅适用于 Android 4.4+)
    • 最新版 Chrome、Safari、Firefox 和 Opera 桌面浏览器
    • WP 8+，IE 10+ (3D 效果在 IE 上可能因为错误的嵌套 3D 变换支持而无法正常工作)
  • 滚动容器。已移除，取而代之的是纯 CSS overflow: auto 和 -webkit-overflow-scrolling: touch。
• 新功能：
  • Swiper 现在使用现代 flexbox 布局，这本身就提供了更多功能和优势。
  • Swiper 2.x 的插件，如 Hash Navigation、Smooth Progress、3D Flow 和 Scrollbar，现在已集成到 Swiper 3.x 核心中。
  • 完整的 RTL 支持。
  • 内置导航按钮/箭头。
  • 控制器。现在一个 Swiper 可以被另一个 Swiper 控制（或控制自身）。
  • 带 slidesPerColumn 选项的多行幻灯片布局。
  • 更好地支持嵌套 Swiper，现在可以使用相同方向的嵌套 Swiper，例如水平嵌套水平。
  • 幻灯片之间的间距。
  • 新的过渡效果：3D Coverflow、3D Cube 和淡入淡出过渡。
  • 幻灯片现在是 border-box，因此可以直接在幻灯片上使用边框和内边距。
  • 自动布局模式 (slidesPerView: 'auto') 现在提供更大的自由度，您甚至可以以 % 指定幻灯片大小并在其上使用边距。
  • Mutation Observers。如果启用，Swiper 将监视 Dom 中的更改并自动更新其布局。
  • 改进了滑动期间的点击预防。
• 许多 API 方法、参数和回调都已更改。
• 添加了轻量级的 Swiper jQuery/Zepto 版本，如果您在项目中使用 jQuery/Zepto，则可以使用此版本。