Package net.dv8tion.jda.api.modals

Class Modal.Builder

java.lang.Object

net.dv8tion.jda.api.modals.Modal.Builder

Enclosing interface:

Modal

public static class Modal.Builder
extends Object

A preconfigured builder for the creation of modals.

Method Summary

Modifier and Type	Method	Description
Modal.Builder	addComponents(Collection<? extends ModalTopLevelComponent> components)	Adds components to this modal
Modal.Builder	addComponents(ModalTopLevelComponent... components)	Adds components to this modal
Modal.Builder	addComponents(ComponentTree<? extends ModalTopLevelComponent> tree)	Adds the provided ComponentTree of ModalTopLevelComponents to this modal
Modal	build()	Builds and returns the Modal
List<ModalTopLevelComponentUnion>	getComponents()	Returns a modifiable list of all components
String	getId()	Returns the custom id
String	getTitle()	Returns the title
Modal.Builder	setId(String customId)	Sets the custom id for this modal.
Modal.Builder	setTitle(String title)	Sets the title for this modal.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

setId

@Nonnull
public Modal.Builder setId(@Nonnull
 String customId)

Sets the custom id for this modal.

Parameters:

customId - Custom id

Returns:

The same builder instance for chaining

Throws:

IllegalArgumentException - If the provided id is null, blank, or is longer than 100 characters.

setTitle

@Nonnull
public Modal.Builder setTitle(@Nonnull
 String title)

Sets the title for this modal.

Parameters:

title - The title

Returns:

The same builder instance for chaining

Throws:

IllegalArgumentException - If the provided title is null, blank or longer than 45 characters

addComponents

@Nonnull
public Modal.Builder addComponents(@Nonnull
 ModalTopLevelComponent... components)

Adds components to this modal

Parameters:

components - Components to add to the modal, up to 5 total

Returns:

The same builder instance for chaining

Throws:

IllegalArgumentException -

• If null is provided
• If any of the provided components are not compatible with modals

See Also:

• Component.isModalCompatible()
• ModalComponentTree

addComponents

@Nonnull
public Modal.Builder addComponents(@Nonnull
 Collection<? extends ModalTopLevelComponent> components)

Adds components to this modal

Parameters:

components - Components to add to the modal, up to 5 total

Returns:

The same builder instance for chaining

Throws:

IllegalArgumentException -

• If null is provided
• If any of the provided components are not compatible with modals

See Also:

• Component.isModalCompatible()

addComponents

@Nonnull
public Modal.Builder addComponents(@Nonnull
 ComponentTree<? extends ModalTopLevelComponent> tree)

Adds the provided ComponentTree of ModalTopLevelComponents to this modal

Parameters:

tree - The ComponentTree to add, containing up to 5 V1 components.

Returns:

The same builder instance for chaining

Throws:

IllegalArgumentException -

• If null is provided
• If any of the provided components are not compatible with modals

See Also:

• Component.isModalCompatible()

getComponents

@Nonnull
public List<ModalTopLevelComponentUnion> getComponents()

Returns a modifiable list of all components

Returns:

A modifiable list of all components

getTitle

@Nonnull
public String getTitle()

Returns the title

Returns:

the title

getId

@Nonnull
public String getId()

Returns the custom id

Returns:

the id

build

@Nonnull
public Modal build()

Builds and returns the Modal

Returns:

A Modal

Throws:

IllegalArgumentException -

• If no components are added
• If more than 5 component layouts are added