DxCarousel.ActiveItemIndex Property

Specifies the active item index.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.2.dll

NuGet Package: DevExpress.Blazor

Declaration

[DefaultValue(0)]
[Parameter]
public int ActiveItemIndex { get; set; }

Property Value

Type	Default	Description
Int32	0	The active item index.

Remarks

Use the ActiveItemIndex property to activate a particular Carousel item programmatically. Handle the ActiveItemIndexChanged event to respond to the property change.

Razor

<DxCarousel Width="500px"
            Height="300px"
            Data="@GetCarouselData()"
            ActiveItemIndex="@CarouselItemIndex"
            LoopNavigationEnabled="true"
            ImageSizeMode="CarouselImageSizeMode.FillAndCrop"
            ActiveItemIndexChanged="OnActiveItemIndexChanged">
</DxCarousel>

<div>@ItemIndexInfo</div>

DataSource

int CarouselItemIndex { get; set; } = 1;
string ItemIndexInfo { get; set; }

void OnActiveItemIndexChanged(int newItemIndex) {
    CarouselItemIndex = newItemIndex;
    ItemIndexInfo = "You switched to item " + (newItemIndex + 1);
}
List<CarouselData> GetCarouselData() {
    List<CarouselData> result = new List<CarouselData>();
    result.Add(new CarouselData("../images/image1.jpg", "image 1"));
    result.Add(new CarouselData("../images/image2.jpg", "image 2"));
    result.Add(new CarouselData("../images/image3.jpg", "image 3"));
    result.Add(new CarouselData("../images/image4.jpg", "image 4"));

    return result;
}

public class CarouselData {
    public string Src { get; set; }
    public string Alt { get; set; }

    public CarouselData(string src, string alt) {
        Src = src;
        Alt = alt;
    }
}