How-to
Website
Web app
Show a carousel
Show pictures or panels one at a time, with buttons to move between them and, if you want, advancing on their own. Wrap each slide in a Carousel.Slide inside a Carousel. This page shows three photographs that advance every five seconds:
Needs: one.jpg, two.jpg and three.jpg in public/. It claims /: paste it into a new project, or replace the starter's src/pages/Home.wf with it.
page Gallery(path: "/", title: "Gallery", description: "Three pictures.") {
Heading("Gallery").h1
Carousel(label: "Recent work", autoplay: true, interval: 5000) {
Carousel.Slide { Image(src: "/one.jpg", alt: "A bridge at dusk") }
Carousel.Slide { Image(src: "/two.jpg", alt: "The harbour from above") }
Carousel.Slide { Image(src: "/three.jpg", alt: "Rain on the market") }
}
}
How it works
- Each
Carousel.Slideis one slide, shown one at a time. - The controls come with it. A carousel has a named previous button, a named next button, and a dot per slide.
label:names it. Itslabel:names the region for screen readers. It is aregiondescribed as a carousel, unless you set itsrole:oraria-roledescription:yourself.autoplayadvances it everyinterval:milliseconds. Withautoplay, the carousel also has a button that stops it. It pauses while the pointer or the keyboard focus is on it, and it does not advance at all for a reader who asked for reduced motion.