Dynamic Carousel
An auto-populated carousel that dynamically loads content items as slides. Similar to Dynamic Card Group but presents results in a rotating slider format. Useful for featured content rotations driven by content queries.
The examples below show Dynamic Carousel renderings sourced from a search block. The first example uses the default carousel options (fade transition, autoplay, indicators, and navigation buttons enabled). The second example disables the fade transition and autoplay to show a standard slide effect with manual navigation only.
Usage Notes
- The Dynamic Carousel uses the same
DynamicContainer.cshtmlview as Dynamic Card Group and Dynamic Components. The view iteratesModel.Placeholders["dynamicsection"]and renders each child component via the rendering engine’s component factory. - The datasource should be a Search Block item (located under
/Home/api/search/). The search block defines the query criteria that populate the carousel slides. - The
ComponentTypeparameter is a Droplink to a dictionary item that tells the rendering contents resolver which component rendering to use for each slide. - The
PageSizeparameter limits the number of slides rendered. If empty, all results from the search block are shown. Carousel-ShowIndicatorsshows dot indicators below the carousel when enabled (default: checked).Carousel-ShowButtonsshows previous/next navigation arrows (default: checked).Carousel-Autoplayenables automatic slide progression (default: checked).Carousel-CarouselFadeuses a crossfade transition instead of the default slide animation (default: checked).Carousel-DarkVariantswitches to dark-themed carousel controls for use on light backgrounds (default: unchecked).ExplicitItemsallows manually specifying content items to include.AppendItemscontrols whether explicit items are appended to or replace search results.
Control Properties
Standard Values / Defaults
| Parameter | Default Value |
|---|---|
| Carousel-ShowIndicators | Checked (1) |
| Carousel-ShowButtons | Checked (1) |
| Carousel-Autoplay | Checked (1) |
| Carousel-CarouselFade | Checked (1) |
| Carousel-DarkVariant | (unchecked) |
| ComponentType | (empty) |
| PageSize | (empty — shows all results) |
| AdministrativeTags | (empty) |
| ExplicitItems | (empty) |
| AppendItems | (unchecked) |
Rendering Parameters
| Parameter | Type | Description |
|---|---|---|
| Carousel-ShowIndicators | Checkbox | Shows dot indicators below the carousel for navigating between slides. |
| Carousel-ShowButtons | Checkbox | Shows previous/next navigation arrow buttons on the carousel. |
| Carousel-Autoplay | Checkbox | Enables automatic slide progression. |
| Carousel-CarouselFade | Checkbox | Uses a crossfade transition instead of the default slide animation. |
| Carousel-DarkVariant | Checkbox | Applies dark-themed controls for use on light backgrounds. |
| ComponentType | Droplink (dictionary) | Selects which component rendering is used to render each slide item from the search block. |
| PageSize | Integer | Limits the number of slides displayed. Leave empty to show all results. |
| AdministrativeTags | Multilist | Filters results by administrative tag taxonomy items. |
| ExplicitItems | Multilist | Manually specified content items to include in the carousel. |
| AppendItems | Checkbox | When checked, explicit items are appended to search results rather than replacing them. |
Template Properties
The Dynamic Carousel rendering does not use a traditional datasource template with content fields. Instead, the datasource is a Search Block item (based on the Foundation/AzureSearch/JsonBuildingBlock template) that defines the query criteria. The search block’s template fields (query path, template filter, sort order, etc.) determine which content items are returned and rendered as carousel slides.
The actual slide content fields depend on the rendering specified by the ComponentType parameter. Each result item’s fields are mapped by the selected component rendering’s model.