QCarousel 组件允许您使用幻灯片显示更多信息,同时占用更少的空间。也可用于创建向导或图片库。
用法
提示
如果 QCarouselSlide 内容也包含图像,并且您希望使用滑动操作进行导航,则可能需要向其中添加 draggable="false"
,否则浏览器原生行为可能会产生负面影响。
保持活动状态
- 如果您需要此行为,请注意 QCarousel 的布尔值
keep-alive
属性。不要在 QCarouselSlide 上使用 Vue 的原生<keep-alive>
组件。 - 如果您需要
keep-alive-include
或keep-alive-exclude
属性,则 QCarouselSlide 的name
必须是有效的 Vue 组件名称(不允许使用空格,不要以数字开头等)。
基本用法
下面是一个几乎精简的基本轮播(它只是动画化的,并且只指定了自定义过渡),没有嵌入导航。出于这个原因,我们通过模型来控制当前幻灯片。
过渡效果
在下面的示例中
- 只演示了一些过渡效果。有关过渡效果的完整列表,请访问过渡效果页面。
- 您也可以用手指滑动(或用鼠标滑动——点击并快速向左/右拖动然后释放)。
垂直方向
控件类型
这里的“控件”指的是箭头和导航按钮。由于它们是按钮,您也可以选择它们的类型以更好地匹配您的设计。您还可以使用control-color
和control-text-color
属性。
导航位置
自定义导航
有关navigation-icon
插槽属性的完整列表,请参阅API卡片。
自动填充
下面是一个示例,您可以使用它来玩不同的QCarousel设置,以便您可以看到填充(或缺少填充)的效果。
媒体内容
在下面的示例中,正在自动生成缩略图。缩略图仅适用于图片幻灯片。
提示
不要将navigation
属性与thumbnails
属性一起使用,因为前者会覆盖后者,因此不会显示缩略图。
无限循环和自动播放
当指针悬停在轮播图上或悬停在感兴趣区域上时,您可以暂停自动播放。
控件
与QScrollArea一起使用
请注意以下两个示例中如何使用QScrollArea。还要注意第二个示例中的q-carousel--padding
CSS辅助类。