为什么捐赠
API 资源管理器
轮播

QCarousel 组件允许您使用幻灯片显示更多信息,同时占用更少的空间。也可用于创建向导或图片库。

正在加载 QCarousel API...
正在加载 QCarouselControl API...
正在加载 QCarouselSlide API...

用法

提示

如果 QCarouselSlide 内容也包含图像,并且您希望使用滑动操作进行导航,则可能需要向其中添加 draggable="false",否则浏览器原生行为可能会产生负面影响。

保持活动状态

  • 如果您需要此行为,请注意 QCarousel 的布尔值 keep-alive 属性。不要在 QCarouselSlide 上使用 Vue 的原生 <keep-alive> 组件。
  • 如果您需要 keep-alive-includekeep-alive-exclude 属性,则 QCarouselSlide 的 name 必须是有效的 Vue 组件名称(不允许使用空格,不要以数字开头等)。

基本用法

下面是一个几乎精简的基本轮播(它只是动画化的,并且只指定了自定义过渡),没有嵌入导航。出于这个原因,我们通过模型来控制当前幻灯片。

基本用法



过渡效果

在下面的示例中

  • 只演示了一些过渡效果。有关过渡效果的完整列表,请访问过渡效果页面。
  • 您也可以用手指滑动(或用鼠标滑动——点击并快速向左/右拖动然后释放)。
过渡效果、底部导航、箭头和自动填充



垂直方向

垂直模式



控件类型

这里的“控件”指的是箭头和导航按钮。由于它们是按钮,您也可以选择它们的类型以更好地匹配您的设计。您还可以使用control-colorcontrol-text-color属性。

控件类型



导航位置



自定义导航

有关navigation-icon插槽属性的完整列表,请参阅API卡片。

自定义导航



自动填充

下面是一个示例,您可以使用它来玩不同的QCarousel设置,以便您可以看到填充(或缺少填充)的效果。

填充



媒体内容

图片幻灯片



多图片幻灯片



标题



视频幻灯片



在下面的示例中,正在自动生成缩略图。缩略图仅适用于图片幻灯片。

缩略图



提示

不要将navigation属性与thumbnails属性一起使用,因为前者会覆盖后者,因此不会显示缩略图。

无限循环和自动播放

当指针悬停在轮播图上或悬停在感兴趣区域上时,您可以暂停自动播放。

自动播放



控件

控件



与QScrollArea一起使用

请注意以下两个示例中如何使用QScrollArea。还要注意第二个示例中的q-carousel--padding CSS辅助类。

使用QScrollArea和填充



在整个幻灯片上使用QScrollArea



全屏

全屏