====== Prompt For Snippet Action ======

The _Prompt For Snippet_ action (v11.0+) allows you to create a snippet built from a template with fields entered when you execute the macro.

The snippet defines the template using the [[token:Ask|%Ask%]] token, which can include a size and a default value.

{{ promptforsnippet.png?nolink | Prompt For Snippet Action }}

The size is roughly the number of characters (default 20), or lines (default 5) if the token is on a line by itself, and the default value is either the specified value if `:` is the separator or the value of the specified variable if `=` is the separator.

This action produces a prompt like this:

{{ prompt-for-snippet-window.png?nolink&901x382 | Prompt For Snippet Window }}

==== Output of Results ====

The results of a shell script can be:

  * Ignored.
  * Displayed in a floating window.
  * Displayed briefly in a Notification.
  * Displayed large across the screen.
  * Typed in to the current selection.
  * Pasted in to the current selection.
  * Saved to a variable.
  * Appended to a variable (v9.0+).
  * Saved to the system or a Named Clipboard.
  * Saved to a file.
  * Asynchronously ignored — the action runs while the macro continues on.

==== Result Button ====

The [[token:PromptButton|%PromptButton%]] token is set to the _name_ of the button pressed, and can be used in actions later in this instance like any other text token.  The deprecated _Result Button_ variable is also set to the _name_ of the button pressed.

(!) Note that the macro will terminate if you press the Cancel button, so to get any result other than OK you will need to use the [[action:Try_or_Catch|Try or Catch]] action to catch the abort and continue anyway.

===== See Also =====

=== Actions ===

* [[action:Alert|Alert]] action
* [[action:Prompt_for_User_Input|Prompt for User Input]] action
* [[action:Prompt_With_List|Prompt With List]] action
* [[action:Prompt_for_File|Prompt for File]] action
* [[action:Prompt_for_Screen_Rectangle|Prompt for Screen Rectangle]] action
* [[action:Custom_HTML_Prompt|Custom HTML Prompt]] action
* [[action:Show_Palette_of_Macros|Show Palette of Macros]] action
* [[action:Get_Touch_Bar_Selection|Get Touch Bar Selection]] action
* [[:Actions|All Actions]]

=== Tokens ===

* [[token:Ask|%Ask%]] token
* [[token:AlertButton|%AlertButton%]] token
* [[token:PromptButton|%PromptButton%]] token
* [[token:HTMLResult|%Result%]] token
* [[:Tokens|All Tokens]]