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