📝 Modal
Como obter: `Modal()`
Métodos
| Assinatura | Parâmetro(s) | Descrição |
|---|---|---|
| setTitle(v) | string | Título do formulário (máx. 45 caracteres) |
| addTextInput(customId, label, opts?) | string, string, object? | Adiciona um campo de texto. opts: { style: "short"|"long", placeholder, required, minLength, maxLength, value } |
| onSubmit(fn, opts?) | function, object? | Registra o envio do formulário. fn(interaction, fields) — fields tem o valor de cada campo pelo customId. opts: { user: true|"id", ttl: ms } |
No objeto de interação
| Assinatura | Parâmetro(s) | Descrição |
|---|---|---|
| interaction.showModal(modal) | Modal | Abre o formulário. modal precisa já ter passado por .onSubmit(fn) |
Limitação do Discord: um Modal só abre em resposta a uma interação que já existe (dentro de
on(buttonClick) ou on(selectMenu), ou no .onClick() temporário de um Button/SelectMenu) — nunca a partir de on(command), que é mensagem comum e não tem token de interação por trás.Exemplo de uso
on command("feedback", message, args)
let btn = Button()
.setLabel("Dar feedback")
.onClick(function(interaction)
let modal = Modal()
.setTitle("Feedback")
.addTextInput("nota", "Nota de 1 a 5", { style: "short" })
.addTextInput("comentario", "Comentário", { style: "long", required: false })
.onSubmit(function(interaction, fields)
interaction.reply("Recebido! Nota: " .. fields.nota .. " — " .. fields.comentario)
end)
interaction.showModal(modal)
end)
message.reply("Clica pra dar feedback:", { components: [btn] })
end