Help: Creating and Using Fill-In Fields
Introduction to Fill-in fields
You can add fill-in fields to a snippet to make it easy to create customized boilerplate text at the time you expand an abbreviation.
Here is an example of a snippet with fill-in fields in action:
TextExpander supports four kinds of fill-in fields, as seen above:
Type or copy / paste in a customer's name or numerical quantity.
Assign a few standard options, like “today”, “tomorrow”, “in two days.”
This content will always be the same, but does not have to appear every time.
Allows for multiple lines of text to appear.
Creating a Fill-in Snippet
All of the fields are optional. The fill-in will work even if you don't change any of the defaults. Note: All fill-ins with the same Field Name will have the same value.
A descriptive name helps you organize if you have several fields. For example: “name”, “date”, “quantity”, etc.
Choose what will appear if nothing is added at the time of expansion. If you prefer the field to remain blank if nothing else is added, uncheck this option.
The default width is 20, shown in the example snippet above for the “customer name” field. The quantity field in the example has a specified width of 4.
Advanced: Fill-in Syntax
If you want to skip the Insert menu, you can find the syntax for each of the four types of fill-ins below.
Field name, default value, and width are all optional. Default width is 20.
Area name, default value, width, and height are all optional. Default width is 30. Default height is 5.
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.
Name is optional. Default is optional: yes or no; if not specified, no is used. Content can contain other fill-ins.
Place this macro anywhere in the snippet content, including nested snippets, for it to have the effect of placing single-line and popup fields at the top of the fill-in window upon snippet expansion.
Fill-in field names and default values cannot contain % (percent sign) or : (colon).
If two fill-in fields in a snippet have the same name, their value will be synchronized when you expand the snippet.
© 2006-2015 SmileOnMyMac, LLC, dba Smile. All rights reserved.
TextExpander is a registered trademark, Smile and the Smile logo are trademarks of SmileOnMyMac, LLC, dba Smile.