Advanced Fill-in Syntax
Fill-ins appear as visual blocks. However, if you wish to see and edit the macro syntax used to make them, you may switch your snippet’s Content: menu from “Plain Text” or “Formatted Text, Picture” to one of the script formats, such as JavaScript to see it and edit it.
Single-line fields
Syntax:
%filltext[:name=<field name>][:default=<default value>][:width=<width>]%
Field name, default value, and width are all optional. Default width is 20.
Example:
%filltext:name=quantity:default=1:width=4%
Multi-line fields
Syntax:
%fillarea[:name=<area name>][:default=<default value>][:width=<width>][:height=<height>]%
Area name, default value, width, and height are all optional. Default width is 30. Default height is 5.
Example:
%fillarea:name=custom:default=Thanks for ordering from Acme Widgets. We are a family owned business, established in 1891. We really appreciate your business.:width=40:height=4%
Popup menus
Syntax:
%fillpopup[:name=<popup name>]:[default=]<value>:[default=]<value>…%
Name is optional. At least one <value> should be specified. Multiple <value>s are encouraged. If no default is specified, the first <value> will be the default.
Example:
%fillpopup:name=ship timeframe:today:default=tomorrow:next week%
Optional sections
Syntax:
%fillpart[:name=<section name>]:[default=yes’no]%<content of optional section>%fillpartend%
Example:
%fillpart:name=Payment Due:default=yes%You did not include payment information with your order. Please call our office at 555-1212 to provide payment details.%fillpartend%
Name is optional. Default is optional: yes or no; if not specified, no is used. Content can contain other fill-ins.
Show at top
Syntax:
%filltop%
Place this macro anywhere in the snippet content, including nested snippets, for it to have the effect of displaying fields at the top of the fill-in window upon snippet expansion.
Notes
When edited in this way, fill-in field names and default values cannot contain % (percent sign) or : (colon). (They can contain these characters when the snippet type is Plain or Formatted text.)
If two fill-in fields in a snippet have the same name, their value will be synchronized when you expand the snippet.
(For more macros, see Date, Time, and Math Macros and Advanced Snippet Functions: Macros).