Carousel
Move through a collection one view at a time, at your own pace.
Preview
Choose an example destination. The preview updates locally without leaving this page.
Slide 1 of 2
Example
<.carousel><:item>First slide</:item><:item>Second slide</:item></.carousel>
API contract
carousel/1
uses declared Phoenix attributes and slots. This table is generated from the compiled component metadata.
| Attribute | Type | Required | Default | Accepted values |
|---|---|---|---|---|
align |
:atom |
No | nil |
[nil, :start, :center, :end] |
direction |
:atom |
No | :horizontal |
[:horizontal, :vertical] |
class |
:any |
No | nil |
Any value matching the declared type |
rest |
:global |
No | — |
Any value matching the declared type |
| Slot | Required | Slot attributes |
|---|---|---|
item |
Yes | id: :string, class: :any |
States and behavior
Default and caller-supplied variants preserve semantic daisyUI colors and additive classes.
Keyboard and accessibility
Behavioral tests
These automated checks are applied to this component by the package and documentation test suites.
-
ExUnit
Carousel structure
Renders the carousel root, item children, orientation, and alignment modifiers.
test/vaylan_ui/catalog_test.exs -
Browser
Rendered interaction
Uses the labelled Next and Previous controls, verifies the announced slide changes, and confirms the carousel scroll position moves.
examples/docs/assets/test/browser-smoke.mjs -
Docs
Preview behavior contract
Classified as navigation. Choose an example destination. The preview updates locally without leaving this page.
examples/docs/test/vaylan_ui_docs_web/controllers/page_controller_test.exs -
Docs
Stable public component page
Renders the component name, example, API contract, accepted values, and keyboard and accessibility guidance at its stable URL.
examples/docs/test/vaylan_ui_docs_web/controllers/page_controller_test.exs