Prompt

The lightning/prompt module provides the LightningPrompt component to create a prompt modal within your component. Use LightningPrompt on a component to ask the user to provide information before they continue.

lightning/prompt implements the prompt blueprint in the Salesforce Lightning Design System (SLDS). The prompt adapts to SLDS 1 or SLDS 2 styling based on the org’s theme or the container app that you use.

Import LightningPrompt from the lightning/prompt module in the component that opens the prompt modal, and call LightningPrompt.open() with your desired attributes.

This example creates a prompt modal with a header, message, and two buttons. If you enter text and click OK in the prompt, the .open() function returns a promise that resolves to the input value. If you click Cancel, the function returns a promise that resolves to null.

1<!-- c/myApp.html -->
2<template>
3    <lightning-button onclick={handlePromptClick} label="Open Prompt Modal">
4    </lightning-button>
5</template>

1import { LightningElement } from "lwc";
2import LightningPrompt from "lightning/prompt";
3
4export default class MyApp extends LightningElement {
5  handlePromptClick() {
6    LightningPrompt.open({
7      message: "this is the prompt message",
8      //theme defaults to "default"
9      label: "Please Respond", // this is the header text
10      defaultValue: "initial input value", //this is optional
11    }).then((result) => {
12      //Prompt has been closed
13      //result is input text if OK clicked
14      //and null if cancel was clicked
15    });
16  }
17}

LightningPrompt supports these attributes:

• message: Message text that displays in the prompt.
• defaultValue: Optional. Initial leading text for the input text box.
• label: Header text, also used as the aria-label. Default string is Prompt.
• variant: See the Variants section.
• theme: See the Themes section.

Use a combination of variants, themes, and utility classes to customize your prompts.

Specify the variant attribute with one of these values.

• header is the default variant, which displays the prompt with header text
• headerless displays the prompt without header text

Specify the theme attribute for the prompt header with one of these color options from SLDS.

• default: white
• shade: gray
• inverse: dark blue
• alt-inverse: darker blue
• success: green
• info: gray-ish blue
• warning: yellow
• error: red
• offline: ​black​

If an invalid value is provided, LightningPrompt uses the default theme. LightningPrompt ignores the style attribute.

To apply additional styling, use the SLDS utility classes with the class attribute.

Code using LightningPrompt can be tested by mocking the LightningPrompt.open() method.

This example uses a button to open a prompt dialog and sets the result in a template.

1<button data-button onclick={handleClick}>Open Prompt</button>
2<div data-result>{result}</div>

1import LightningPrompt from 'lightning/prompt';
2jest.mock('lightning/prompt');
3​
4test(() => {
5    // Create and appendChild(element)
6​
7    const buttonEle = element.shadowRoot.querySelector('[data-button]');
8    const resultEle = element.shadowRoot.querySelector('[data-result]');
9​
10    // Mock .open()
11    // Pass string representing input text if testing when user clicks "OK"
12    // Pass null if testing when user clicks "Cancel"
13    LightningPrompt.open = jest.fn().mockResolvedValue('test value');
14    // Initial value
15    expect(resultEle.textContent).toBe('unknown');
16    // Click modal open button
17    buttonEle.click();
18​
19    // Click handler render cycle
20    await Promise.resolve();
21    // Render cycle triggered by tracked value {result}
22    await Promise.resolve();
23​
24    // Verify result is set in the template
25    expect(resultEle.textContent).toBe('test value');
26    // Open triggered once
27    expect(LightningPrompt.open.mock.calls).toHaveLength(1);
28})