macaroni

prompt

Description:
The prompt executor is used to display a prompt to the user with a text input type experience. In addition to the prompt and the text input experience, there will be two buttons, OK and Cancel.

Parent: execute, then, else

Value (simple form): string specifying the text message prompt to display
Value (key/value form):

• prompt: string, required, specifying the text message prompt to display
• title: string, optional, specifying the prompt dialog box title (default is null)
• image: string, specifying the name of an image to display in prompt dialog box (default is null)
• timeout: time, optional, specifying the amount of time, after which the prompt will be dismissed (default is null)
  • if timeout is null, the prompt will not be automatically dismissed
  • if timeout has no unit, milliseconds is assumed
• text: string, optional, specifying the default text in the text input experience
• selected: boolean, optional, specifies if the default text will be selected or not when the experience is first displayed (default: true)

# simple form
- prompt: (string)

# simple example
- prompt: How many do you want?

# key/value form
- prompt: (string, required)
  title: (string, optional)
  image: (string, optional)
  timeout: (time, optional)
  text: (string, optional)
  selected: (boolean, optional)

# key/value example
- prompt: How many do you want?
  timeout: 5s
  default: `1`

EXAMPLE:

- triggers:
  - '[create] [a] new macro'
  execute:
  - prompt: Enter your macro as YAML
    text: |
      commands:
      - triggers:
        - 'phrase one'
        - 'phrase two'
        execute:
        - run: "notepad" # thing to run
        - wait: 500 # time to wait in ms
        - insert: "hello" # text to insert
        - sendKeys: "{ctrl-a}" # keys to send
  - clipboard: '{prompt.text}'
  - prompt: Enter a new filename
  - file:
      name: '{folders.MyDocuments}\macros\{prompt.text}.mac'
      write: '{clipboard.text}'
  - clipboard: '{folders.MyDocuments}\macros\{prompt.text}.mac'
  - run: '{folders.MyDocuments}\macros\{prompt.text}.mac'

Status: ☑️ Partially IMPLEMENTED (needs “image”, “timeout”, “selected”, “default” support)

Additional information:

• More than one prompt can be displayed on the screen at a time, from different command executions