幻灯片
QCarousel 组件允许您使用幻灯片以更少的空间显示更多信息,对于创建向导或图库也很有用。
QCarousel API
QCarouselControl API
QCarouselSlide API
用法
TIP
如果您在 QCarouselSlide 中添加了可以滑动导航的图片,那么您可能需要设置 draggable="false"
,否则浏览器的默认行为可能会产生负面影响。
Keep Alive
请注意 QCarousel 组件的
keep-alive
属性,如果您使用这个功能,就不要再使用 vue3 原生的<keep-alive>
组件来包裹 QCarousel 组件。如果您需要
keep-alive-include
或keep-alive-exclude
属性,那么 QCarouselSlide 的name
属性必须是有效的 Vue 组件名称(不允许空格,不要以数字开头等)。
基础
下面是一个不带导航按钮的最基础的幻灯片示例(只带有动画和自定义的过渡效果),通过 v-model
来控制当前展示的画面。
过渡
下面的示例中:
- 这里只展示了部分的过渡动画,完整的列表请见Transitions页面.
- 除了点击按钮来切换页面,您也可以使用手指滑动(或者使用鼠标滑动,按下鼠标后瞬速左右拖动后松开)。
垂直
控件类型
这里的控件是指的是箭头和导航按钮,虽然它们是按钮元素,但是仍可以选择它们的类型来更好地应对您的设计。control-color
和 control-text-color
属性也会对您有帮助。
导航的位置
自定义导航
关于navigation-icon
插槽的完整属性列表,请见页面上方的 API 卡片
自动填充
下面的示例中您可以对 QCarousel 做出不同的设置后观看控件间 padding 的变化:
媒体内容
在下面的示例中,加入thumbnails
属性,会自动生成缩略图,缩略图只适用于图片内容的幻灯片。
TIP
不要将navigation
导航属性和thumbnails
缩略图属性一起使用,因为第一个会取代后者,这样就不会显示缩略图。
无限滚动和自动播放
您可以将鼠标移到幻灯片上来暂停自动播放
控件
搭配 QScrollArea
请注意下面两个示例中如何使用QScrollArea。还要注意第二个示例中的q-carousel--padding
CSS 类名。