# prompt Function The `prompt` function wraps the [``](/en/docs/2/components/dialog) component and replaces the native `window.prompt` function. With this function, you can open a text input dialog without writing any HTML. ## Usage {#usage} Import the function: ```js import { prompt } from 'mdui/functions/prompt.js'; ``` Example: ```html open ``` ## API {#api}

prompt(options: Options): Promise<string>

The function takes an [Options](#api-options) object and returns a Promise. The Promise resolves with the value entered in the text field when the dialog is closed by clicking the confirm button and rejects otherwise. ### Options {#api-options}

Property	Type	Default
`headline`	`string`	-
The title of the dialog.
`description`	`string`	-
The description of the dialog.
`icon`	`string`	-
The Material Icons name displayed at the top of the dialog.
`closeOnEsc`	`boolean`	`false`
Whether the dialog can be closed by pressing the Esc key. If set to `true`, the dialog closes when the Esc key is pressed.
`closeOnOverlayClick`	`boolean`	`false`
Whether the dialog can be closed by clicking on the overlay.
`confirmText`	`string`	`OK`
The text for the confirm button.
`cancelText`	`string`	`Cancel`
The text for the cancel button.
`stackedActions`	`boolean`	`false`
Whether to stack the bottom action buttons vertically.
`queue`	`string`	-
The queue name. Queues are disabled by default. If this function is called multiple times, multiple dialogs will appear simultaneously. If you provide a queue name, dialogs with the same name open one after another. The `dialog()`, `alert()`, `confirm()`, and `prompt()` functions share the same queue if their queue names match.
`onConfirm`	`(value: string, dialog: Dialog) => void \| boolean \| Promise<void>`	-
Called when the confirm button is clicked. The callback receives the text field value and the dialog instance as its arguments, and `this` refers to the dialog instance. By default, clicking the confirm button closes the dialog. If the return value is `false`, the dialog remains open. If the return value is a promise, the dialog closes after the promise resolves.
`onCancel`	`(value: string, dialog: Dialog) => void \| boolean \| Promise<void>`	-
Called when the cancel button is clicked. The callback receives the text field value and the dialog instance as its arguments, and `this` refers to the dialog instance. By default, clicking the cancel button closes the dialog. If the return value is `false`, the dialog remains open. If the return value is a promise, the dialog closes after the promise resolves.
`onOpen`	`(dialog: Dialog) => void`	-
Called when the dialog starts to open. The callback receives the dialog instance as its argument, and `this` also refers to it.
`onOpened`	`(dialog: Dialog) => void`	-
Called when the dialog's opening animation completes. The callback receives the dialog instance as its argument, and `this` also refers to it.
`onClose`	`(dialog: Dialog) => void`	-
Called when the dialog starts to close. The callback receives the dialog instance as its argument, and `this` also refers to it.
`onClosed`	`(dialog: Dialog) => void`	-
Called when the dialog's closing animation completes. The callback receives the dialog instance as its argument, and `this` also refers to it.
`onOverlayClick`	`(dialog: Dialog) => void`	-
Called when the overlay is clicked. The callback receives the dialog instance as its argument, and `this` also refers to it.
`validator`	`(value: string) => boolean \| string \| Promise<void>`	-
A validation function for the text field that takes the field value as its parameter. `this` refers to the TextField instance. It runs only after native browser validation succeeds. If it returns a `boolean` value, `false` indicates a validation failure, and `true` indicates a validation success. If it returns a string, a non-empty string indicates a validation failure, with the returned string serving as the error message. If it returns a Promise, a resolved Promise indicates success and a rejected Promise indicates failure. The rejection reason is used as the error message.
`textFieldOptions`	`Partial<TextField>`	-
The internal text field is a `<mdui-text-field>` component. You can configure the `<mdui-text-field>` component using this parameter.