StringSelectMenuKit
StringSelectMenuKit extends StringSelectMenuBuilder
new StringSelectMenuKit(data)
Parameter | Type | Optional |
---|---|---|
data | Partial<APIStringSelectComponent | StringSelectMenuComponentData> | ✅ |
Properties
public data: any
The API data associated with this component.
public options: any
The options within this select menu.
Methods
public addOptions(options): this
Adds options to this select menu.
Parameter | Type | Optional | Description |
---|---|---|---|
options | RestOrArray<StringSelectMenuOptionBuilder | SelectMenuComponentOptionData | APISelectMenuOption> |
public clearId(): this
Clears the id of this component, defaulting to a default incremented id.
public dispose(): StringSelectMenuKit
public filter(predicate): this
Sets a filter for the interaction collector.
Parameter | Type | Optional | Description |
---|---|---|---|
predicate | SelectMenuKitPredicate<StringSelectMenuInteraction> | ❌ | The filter to use for the interaction collector. |
public onEnd(handler): this
Sets the handler to run when the interaction collector ends.
Parameter | Type | Optional | Description |
---|---|---|---|
handler | CommandKitSelectMenuBuilderOnEnd | ❌ | The handler to run when the interaction collector ends. |
public onError(handler): this
Sets the handler to run when the interaction collector ends.
Parameter | Type | Optional | Description |
---|---|---|---|
handler | EventInterceptorErrorHandler | ❌ | The handler to run when the interaction collector ends. |
public onSelect(handler, data?): this
Sets the handler to run when the modal is submitted.
const modal = new StringSelectMenuKit()
.setTitle('My Modal')
.setCustomId('my-modal')
.filter((interaction) => interaction.user.id === '1234567890')
.onSelect(async (interaction) => {
await interaction.reply('You submitted the modal!');
})
.addComponents(actionRow1, actionRow2);
Parameter | Type | Optional | Description |
---|---|---|---|
handler | CommandKitSelectMenuBuilderInteractionCollectorDispatch<StringSelectMenuInteraction | StringSelectMenuKit> | ❌ |
data | CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData | ✅ | The context data for the interaction collector. |
public setCustomId(customId): this
Sets the custom id for this select menu.
Parameter | Type | Optional | Description |
---|---|---|---|
customId | string | ❌ | The custom id to use |
public setDisabled(disabled?): this
Sets whether this select menu is disabled.
Parameter | Type | Optional | Description |
---|---|---|---|
disabled | boolean | ✅ | Whether this select menu is disabled |
public setId(id): this
Sets the id (not the custom id) for this component.
Parameter | Type | Optional | Description |
---|---|---|---|
id | number | ❌ | The id for this component |
public setMaxValues(maxValues): this
Sets the maximum values that must be selected in the select menu.
Parameter | Type | Optional | Description |
---|---|---|---|
maxValues | number | ❌ | The maximum values that must be selected |
public setMinValues(minValues): this
Sets the minimum values that must be selected in the select menu.
Parameter | Type | Optional | Description |
---|---|---|---|
minValues | number | ❌ | The minimum values that must be selected |
public setOptions(options): this
Sets the options for this select menu.
Parameter | Type | Optional | Description |
---|---|---|---|
options | RestOrArray<StringSelectMenuOptionBuilder | SelectMenuComponentOptionData | APISelectMenuOption> |
public setPlaceholder(placeholder): this
Sets the placeholder for this select menu.
Parameter | Type | Optional | Description |
---|---|---|---|
placeholder | string | ❌ | The placeholder to use |
public spliceOptions(index, deleteCount, options): this
Removes, replaces, or inserts options for this select menu.
Remove the first option:
selectMenu.spliceOptions(0, 1);
Remove the first n option:
const n = 4;
selectMenu.spliceOptions(0, n);
Remove the last option:
selectMenu.spliceOptions(-1, 1);
Parameter | Type | Optional | Description |
---|---|---|---|
index | number | ❌ | The index to start at |
deleteCount | number | ❌ | The number of options to remove |
options | RestOrArray<StringSelectMenuOptionBuilder | APISelectMenuOption> | ❌ |
public toJSON(): APIStringSelectComponent
BaseSelectMenuBuilder.toJSON
public static from(other): StringSelectMenuBuilder
Parameter | Type | Optional |
---|---|---|
other | APIStringSelectComponent | JSONEncodable<APIStringSelectComponent> |