Skip to main content

Component

Documentation


Documentation / @discordeno/bot / Component

Interface: Component

Defined in: transformers/types.ts:568

Properties

accentColor?

optional accentColor?: number

Defined in: transformers/types.ts:629

Color for the accent on the container as RGB from 0x000000 to 0xFFFFFF


accessory?

optional accessory?: Component

Defined in: transformers/types.ts:611

A thumbnail or a button component, with a future possibility of adding more compatible components


channelTypes?

optional channelTypes?: ChannelTypes[]

Defined in: transformers/types.ts:588

List of channel types to include in a channel select menu options list


component?

optional component?: Component

Defined in: transformers/types.ts:635

The component within the label


components?

optional components?: Component[]

Defined in: transformers/types.ts:603

a list of child components


content?

optional content?: string

Defined in: transformers/types.ts:613

Text that will be displayed similar to a message


customId?

optional customId?: string

Defined in: transformers/types.ts:572

a developer-defined identifier for the component, max 100 characters


default?

optional default?: boolean

Defined in: transformers/types.ts:639

Whether the checkbox is selected by default (Checkbox component).


defaultValues?

optional defaultValues?: ComponentDefaultValue[]

Defined in: transformers/types.ts:605

List of default values for auto-populated select menu components; number of default values must be in the range defined by min_values and max_values


description?

optional description?: string

Defined in: transformers/types.ts:615

Alt text for the media


disabled?

optional disabled?: boolean

Defined in: transformers/types.ts:576

whether the component is disabled, default false


divider?

optional divider?: boolean

Defined in: transformers/types.ts:621

Whether a visual divider should be displayed in the component. Defaults to true


emoji?

optional emoji?: Pick<Partial<Emoji>, "animated" | "id" | "name">

Defined in: transformers/types.ts:584

Emoji object that includes fields of name, id, and animated supporting unicode and custom emojis.


file?

optional file?: UnfurledMediaItem

Defined in: transformers/types.ts:625

This unfurled media item is unique in that it only supports attachment references using the attachment://<filename> syntax


id?

optional id?: number

Defined in: transformers/types.ts:609

Optional identifier for component


items?

optional items?: MediaGalleryItem[]

Defined in: transformers/types.ts:619

1 to 10 media gallery items


label?

optional label?: string

Defined in: transformers/types.ts:580

text that appears on the button (max 80 characters)


maxLength?

optional maxLength?: number

Defined in: transformers/types.ts:601

The maximum input length for a text input. Between 1-4000.


maxValues?

optional maxValues?: number

Defined in: transformers/types.ts:597

The maximum number of items that can be selected. Default 1. Between 1-25.


media?

optional media?: UnfurledMediaItem

Defined in: transformers/types.ts:627

This unfurled media item is unique in that it only supports attachment references using the attachment://<filename> syntax


minLength?

optional minLength?: number

Defined in: transformers/types.ts:599

The minimum input length for a text input. Between 0-4000.


minValues?

optional minValues?: number

Defined in: transformers/types.ts:595

The minimum number of items that must be selected. Default 1. Between 1-25.


name?

optional name?: string

Defined in: transformers/types.ts:631

The name of the file. This field is ignored and provided by the API as part of the response


options?

optional options?: SelectOption[] | RadioGroupOption[] | CheckboxGroupOption[]

Defined in: transformers/types.ts:591

The string select options or the radio or checkbox group options


placeholder?

optional placeholder?: string

Defined in: transformers/types.ts:593

A custom placeholder text if nothing is selected. Maximum 150 characters.


required?

optional required?: boolean

Defined in: transformers/types.ts:574

whether this component is required to be filled, default true


resolved?

optional resolved?: InteractionDataResolved

Defined in: transformers/types.ts:641

Resolved entities from selected options


size?

optional size?: number

Defined in: transformers/types.ts:633

The size of the file in bytes. This field is ignored and provided by the API as part of the response


skuId?

optional skuId?: bigint

Defined in: transformers/types.ts:607

Identifier for a purchasable SKU, only available when using premium-style buttons


spacing?

optional spacing?: SeparatorSpacingSize

Defined in: transformers/types.ts:623

Size of separator padding — 1 for small padding, 2 for large padding. Defaults to 1


spoiler?

optional spoiler?: boolean

Defined in: transformers/types.ts:617

Whether the thumbnail should be a spoiler (or blurred out). Defaults to false


style?

optional style?: ButtonStyles | TextStyles

Defined in: transformers/types.ts:578

For different styles/colors of the buttons


type

type: MessageComponentTypes

Defined in: transformers/types.ts:570

component type


url?

optional url?: string

Defined in: transformers/types.ts:586

optional url for link-style buttons that can navigate a user to the web. Only type 5 Link buttons can have a url


value?

optional value?: string | boolean

Defined in: transformers/types.ts:582

the dev-define value of the option, max 100 characters for select or 4000 for input; or boolean for checkbox response.


values?

optional values?: string[]

Defined in: transformers/types.ts:637

The text of the selected options