DiscordPHP Documentation

Container extends Layout

in package

• Application

implements ComponentV2

Containers are a new way to group components together.

Tags

link

https://discord.com/developers/docs/interactions/message-components#container

since

10.5.0

@property

?int|null $id Optional identifier for component

@property

?int|null $accent_color Color for the accent on the container as RGB from 0x000000 to 0xFFFFFF

@property

?bool|null $spoiler Whether the container should be a spoiler (or blurred out). Defaults to false.

Table of Contents

Interfaces

ComponentV2

This interface is a contract for V2 components.

Constants

TYPE_ACTION_ROW  = 1

TYPE_BUTTON  = 2

TYPE_CHANNEL_SELECT  = 8

TYPE_CONTAINER  = 17

TYPE_CONTENT_INVENTORY_ENTRY  = 16

TYPE_FILE  = 13

TYPE_LABEL  = 18

TYPE_MEDIA_GALLERY  = 12

TYPE_MENTIONABLE_SELECT  = 7

TYPE_ROLE_SELECT  = 6

TYPE_SECTION  = 9

TYPE_SELECT_MENU  = 3

TYPE_SEPARATOR  = 14

TYPE_STRING_SELECT  = 3

TYPE_TEXT_DISPLAY  = 10

TYPE_TEXT_INPUT  = 4

TYPE_THUMBNAIL  = 11

TYPE_USER_SELECT  = 5

USAGE  = ['Message']

Properties

$accent_color  : int|null

Accent color for the container.

$components  : array<string|int, ComponentObject>

Array of components.

$id  : int|null

32 bit integer used as an optional identifier for component.

$spoiler  : bool|null

Whether the container is a spoiler.

$type  : int

Component type.

Methods

addComponent()  : $this

Adds a component to the container.

addComponents()  : $this

Add a group of components to the container.

getAccentColor()  : int|null

Returns the accent color for the container.

getComponents()  : array<string|int, ComponentObject>

Returns all the components in the container.

getCustomId()  : string|null

Returns the custom ID of the button.

getType()  : int

Retrieves the type of the component.

isSpoiler()  : bool

Returns whether the container is a spoiler.

jsonSerialize()  : array<string|int, mixed>

new()  : self

Creates a new container.

setAccentColor()  : $this

Sets the accent color for the container.

setComponents()  : $this

Sets the components for the container.

setSpoiler()  : $this

Sets whether the container is a spoiler.

generateUuid()  : string

Generates a UUID which can be used for component custom IDs.

getId()  : int|null

The id field is optional and is used to identify components in the response from an interaction that aren't interactive components.

resolveColor()  : int

Resolves a color to an integer.

setId()  : self

The id field is optional and is used to identify components in the response from an interaction. The id must be unique within the message and is generated sequentially if left empty. Generation of ids won't use another id that exists in the message if you have one defined for another component. Sending components with an id of 0 is allowed but will be treated as empty and replaced by the API. 32 bit integer used as an optional identifier for component.