幻灯片

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

QCarousel API

Loading QCarousel API...

QCarouselControl API

Loading QCarouselControl API...

QCarouselSlide API

Loading QCarouselSlide API...

用法

TIP

如果您在 QCarouselSlide 中添加了可以滑动导航的图片,那么您可能需要设置 draggable="false",否则浏览器的默认行为可能会产生负面影响。

Keep Alive

  • 请注意 QCarousel 组件的 keep-alive 属性,如果您使用这个功能,就不要再使用 vue3 原生的<keep-alive> 组件来包裹 QCarousel 组件。

  • 如果您需要 keep-alive-includekeep-alive-exclude 属性,那么 QCarouselSlide 的 name 属性必须是有效的 Vue 组件名称(不允许空格,不要以数字开头等)。

基础

下面是一个不带导航按钮的最基础的幻灯片示例(只带有动画和自定义的过渡效果),通过 v-model 来控制当前展示的画面。




过渡

下面的示例中:

  • 这里只展示了部分的过渡动画,完整的列表请见Transitions页面.
  • 除了点击按钮来切换页面,您也可以使用手指滑动(或者使用鼠标滑动,按下鼠标后瞬速左右拖动后松开)。



垂直




控件类型

这里的控件是指的是箭头和导航按钮,虽然它们是按钮元素,但是仍可以选择它们的类型来更好地应对您的设计。control-colorcontrol-text-color属性也会对您有帮助。




导航的位置




自定义导航

关于navigation-icon插槽的完整属性列表,请见页面上方的 API 卡片




自动填充

下面的示例中您可以对 QCarousel 做出不同的设置后观看控件间 padding 的变化:




媒体内容













在下面的示例中,加入thumbnails属性,会自动生成缩略图,缩略图只适用于图片内容的幻灯片。




TIP

不要将navigation导航属性和thumbnails缩略图属性一起使用,因为第一个会取代后者,这样就不会显示缩略图。

无限滚动和自动播放

您可以将鼠标移到幻灯片上来暂停自动播放




控件




搭配 QScrollArea

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







全屏