0 follower

Final Class Yiisoft\Bootstrap5\CarouselItem

All Classes | Methods

Inheritance	Yiisoft\Bootstrap5\CarouselItem

CarouselItem represents a single item within a Bootstrap Carousel widget.

Each item can contain content, caption, and caption placeholder.

The item can be set as active and supports autoplaying intervals.

Active state: When is true, sets this item as the first visible slide.
Auto-playing: When enabled, cycling can be paused by hovering over the carousel, focusing on it, or clicking on carousel controls/indicators.

Example usage: `php <?= CarouselItem::to(

    '<img src="example.jpg" alt="Example">',
    'Image Caption',
    'Caption Placeholder'
);

// Create an active carousel item with autoplay. <?= CarouselItem::to(

    content: '<img src="example.jpg">',
    caption: 'Slide 1',
    active: true,
    autoPlayingInterval: 5000
);

?> `

Public Methods

Hide inherited methods

Method	Description	Defined By
active()	Sets the active state.	Yiisoft\Bootstrap5\CarouselItem
attributes()	Sets the HTML attributes for the link.	Yiisoft\Bootstrap5\CarouselItem
autoPlayingInterval()	Sets the autoplaying interval.	Yiisoft\Bootstrap5\CarouselItem
caption()	Sets the caption content.	Yiisoft\Bootstrap5\CarouselItem
captionAttributes()	Sets the HTML attributes for the caption.	Yiisoft\Bootstrap5\CarouselItem
captionPlaceholder()	Sets the caption placeholder content.	Yiisoft\Bootstrap5\CarouselItem
captionPlaceholderAttributes()	Sets the HTML attributes for the caption placeholder.	Yiisoft\Bootstrap5\CarouselItem
content()	Sets the content.	Yiisoft\Bootstrap5\CarouselItem
encodeCaption()	Sets whether to encode the caption content.	Yiisoft\Bootstrap5\CarouselItem
encodeCaptionPlaceholder()	Sets whether to encode the caption placeholder content.	Yiisoft\Bootstrap5\CarouselItem
getAttributes()		Yiisoft\Bootstrap5\CarouselItem
getAutoPlayingInterval()		Yiisoft\Bootstrap5\CarouselItem
getCaption()		Yiisoft\Bootstrap5\CarouselItem
getCaptionAttributes()		Yiisoft\Bootstrap5\CarouselItem
getCaptionPlaceholder()		Yiisoft\Bootstrap5\CarouselItem
getCaptionPlaceholderAttributes()		Yiisoft\Bootstrap5\CarouselItem
getContent()		Yiisoft\Bootstrap5\CarouselItem
isActive()		Yiisoft\Bootstrap5\CarouselItem
to()	Creates a new Yiisoft\Bootstrap5\CarouselItem instance.	Yiisoft\Bootstrap5\CarouselItem

Method Details

Hide inherited methods

active() public method

Sets the active state.

public active( boolean $enabled ): self
$enabled	boolean	Whether the breadcrumb link is active.
return	self	A new instance with the specified active state.

Source code

                public function active(bool $enabled): self
{
    $new = clone $this;
    $new->active = $enabled;
    return $new;
}

attributes() public method

Sets the HTML attributes for the link.

public attributes( array $attributes ): self
$attributes	array	Attribute values indexed by attribute names.
return	self	A new instance with the specified attributes.

Source code

                public function attributes(array $attributes): self
{
    $new = clone $this;
    $new->attributes = $attributes;
    return $new;
}

autoPlayingInterval() public method

Sets the autoplaying interval.

public autoPlayingInterval( integer $interval ): self
$interval	integer	The autoplaying interval in milliseconds.
return	self	A new instance with the specified autoplaying interval.

Source code

                public function autoPlayingInterval(int $interval): self
{
    $new = clone $this;
    $new->autoPlayingInterval = $interval;
    return $new;
}

caption() public method

Sets the caption content.

public caption( string $caption ): self
$caption	string	The caption content.
return	self	A new instance with the specified caption content.

Source code

                public function caption(string $caption): self
{
    $new = clone $this;
    $new->caption = $caption;
    return $new;
}

captionAttributes() public method

Sets the HTML attributes for the caption.

public captionAttributes( array $captionAttributes ): self
$captionAttributes	array	Attribute values indexed by attribute names.
return	self	A new instance with the specified attributes for the caption.

Source code

                public function captionAttributes(array $captionAttributes): self
{
    $new = clone $this;
    $new->captionAttributes = $captionAttributes;
    return $new;
}

captionPlaceholder() public method

Sets the caption placeholder content.

public captionPlaceholder( string $captionPlaceholder ): self
$captionPlaceholder	string	The caption placeholder content.
return	self	A new instance with the specified caption placeholder content.

Source code

                public function captionPlaceholder(string $captionPlaceholder): self
{
    $new = clone $this;
    $new->captionPlaceholder = $captionPlaceholder;
    return $new;
}

captionPlaceholderAttributes() public method

Sets the HTML attributes for the caption placeholder.

public captionPlaceholderAttributes( array $captionPlaceholderAttributes ): self
$captionPlaceholderAttributes	array	Attribute values indexed by attribute names.
return	self	A new instance with the specified attributes for the caption placeholder.

Source code

                public function captionPlaceholderAttributes(array $captionPlaceholderAttributes): self
{
    $new = clone $this;
    $new->captionPlaceholderAttributes = $captionPlaceholderAttributes;
    return $new;
}

content() public method

Sets the content.

public content( string\|\Stringable $content ): self
$content	string\|\Stringable	The content.
return	self	A new instance with the specified content.

Source code

                public function content(string|Stringable $content): self
{
    $new = clone $this;
    $new->content = $content;
    return $new;
}

encodeCaption() public method

Sets whether to encode the caption content.

public encodeCaption( boolean $encode ): self
$encode	boolean	Whether to encode the caption content.
return	self	A new instance with the specified encoding setting.

Source code

                public function encodeCaption(bool $encode): self
{
    $new = clone $this;
    $new->encodeCaption = $encode;
    return $new;
}

encodeCaptionPlaceholder() public method

Sets whether to encode the caption placeholder content.

public encodeCaptionPlaceholder( boolean $encode ): self
$encode	boolean	Whether to encode the caption placeholder content.
return	self	A new instance with the specified encoding setting.

Source code

                public function encodeCaptionPlaceholder(bool $encode): self
{
    $new = clone $this;
    $new->encodeCaptionPlaceholder = $encode;
    return $new;
}

getAttributes() public method

public getAttributes( ): array
return	array	Returns the HTML attributes for the carousel item.

Source code

                public function getAttributes(): array
{
    return $this->attributes;
}

getAutoPlayingInterval() public method

public getAutoPlayingInterval( ): integer\|null
return	integer\|null	Returns the autoplaying interval for the carousel item.

Source code

                public function getAutoPlayingInterval(): ?int
{
    return $this->autoPlayingInterval;
}

getCaption() public method

public getCaption( ): string\|null
return	string\|null	Returns the caption content for the carousel item.

Source code

                public function getCaption(): ?string
{
    return $this->encodeCaption ? Html::encode($this->caption) : $this->caption;
}

getCaptionAttributes() public method

public getCaptionAttributes( ): array
return	array	Returns the HTML attributes for the caption.

Source code

                public function getCaptionAttributes(): array
{
    return $this->captionAttributes;
}

getCaptionPlaceholder() public method

public getCaptionPlaceholder( ): string\|null
return	string\|null	Returns the caption placeholder content for the carousel item.

Source code

                public function getCaptionPlaceholder(): ?string
{
    return $this->encodeCaptionPlaceholder ? Html::encode($this->captionPlaceholder) : $this->captionPlaceholder;
}

getCaptionPlaceholderAttributes() public method

public getCaptionPlaceholderAttributes( ): array
return	array	Returns the HTML attributes for the caption placeholder.

Source code

                public function getCaptionPlaceholderAttributes(): array
{
    return $this->captionPlaceholderAttributes;
}

getContent() public method

public getContent( ): string\|\Stringable
return	string\|\Stringable	Returns the content for the carousel item.

Source code

                public function getContent(): string|Stringable
{
    return $this->content;
}

isActive() public method

public isActive( ): boolean
return	boolean	Whether the item is active.

Source code

                public function isActive(): bool
{
    return $this->active;
}

to() public static method

Creates a new Yiisoft\Bootstrap5\CarouselItem instance.

public static to( string\|\Stringable $content = '', string\|null $caption = null, string\|null $captionPlaceholder = null, integer\|null $autoPlayingInterval = null, boolean $active = false, boolean $encodeCaption = true, boolean $encodeCaptionPlaceholder = true, array $attributes = [], array $captionAttributes = [], array $captionPlaceholderAttributes = [] ): self
$content	string\|\Stringable	The content of the carousel item.
$caption	string\|null	The caption content for the carousel item.
$captionPlaceholder	string\|null	The caption placeholder content for the carousel item.
$autoPlayingInterval	integer\|null	The autoplaying interval for the carousel item.
$active	boolean	Whether the item is active.
$encodeCaption	boolean	Whether to encode the caption content.
$encodeCaptionPlaceholder	boolean	Whether to encode the caption placeholder content.
$attributes	array	The HTML attributes for the carousel item.
$captionAttributes	array	The HTML attributes for the caption.
$captionPlaceholderAttributes	array	The HTML attributes for the caption placeholder.
return	self	A new instance with the specified configuration.

Source code

                public static function to(
    string|Stringable $content = '',
    ?string $caption = null,
    ?string $captionPlaceholder = null,
    ?int $autoPlayingInterval = null,
    bool $active = false,
    bool $encodeCaption = true,
    bool $encodeCaptionPlaceholder = true,
    array $attributes = [],
    array $captionAttributes = [],
    array $captionPlaceholderAttributes = [],
): self {
    return new self(
        $active,
        $attributes,
        $autoPlayingInterval,
        $caption,
        $captionAttributes,
        $captionPlaceholder,
        $captionPlaceholderAttributes,
        $content,
        $encodeCaption,
        $encodeCaptionPlaceholder,
    );
}