V Vaylan UI
Data display

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.

AttributeTypeRequiredDefault 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
SlotRequiredSlot 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