This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
Tokens [2016/06/23 02:15] peternlewis corrected display of lone backslash |
Tokens [2016/12/02 04:41] peternlewis [Definition] |
||
---|---|---|---|
Line 4: | Line 4: | ||
===== Definition ===== | ===== Definition ===== | ||
- | **Tokens in Keyboard Maestro represent placeholders for information about a specific object.** For example, the [[token:SafariTitle|%SafariTitle% token]] returns the title of the current Safari tab. So the value of the Token will be determined at execution time. All tokens return a text value, even if the source data was some other data type. | + | **Tokens in Keyboard Maestro represent placeholders for information about a specific object.** For example, the [[token:SafariTitle|%SafariTitle% token]] returns the title of the current Safari tab. So the value of the Token will be determined at execution time. All tokens return a text value, even if the source data was some other data type. |
+ | Tokens allow you to add textual information to [[/Text_Fields|token text fields]]. You can insert tokens into a field using the Insert Token popup near the field or by choosing [[manual:Menus#Edit_Insert_Token|Insert Token]] from the [[manual:Menus#Edit|Edit menu]]. You can also start typing a token and use text completion to complete the token. | ||
- | ---- | + | Text token fields also process %NN% or %NNNN% as arbitrary hex unicode characters (eg %41% is an A), and (except for regular expression fields) process backslashed characters \a,\b,\e,\f,\t,\r,\n (bell,backspace,escape,form feed,tab,return,line feed). |
+ | |||
+ | To include a percent in your text, simply double the percent (%%). To include a backslash \ in your text, double the backslash (\\). | ||
+ | |||
+ | ===== List of Tokens ===== | ||
+ | |||
+ | |||
+ | ~~NOCACHE~~ | ||
+ | <nspages token -textPages=""> | ||
===== How To Use ===== | ===== How To Use ===== | ||
- | Keyboard Maestro has a wide variety of tokens. Tokens allow you to add information to text fields in a [[Actions|Action]]. You can insert tokens into a field using the **//Insert Token//** popup near the field. | + | Keyboard Maestro has a wide variety of tokens. Tokens allow you to add information to text fields in an [[Actions|Action]]. You can insert tokens into a field using the **//Insert Token//** popup near the field. |
Line 18: | Line 26: | ||
- | ---- | + | Most fields that contain text (ie, not just numbers) can include tokens. |
- | + | ||
- | Most fields that contain text (ie, not just numbers) can include tokens (the main exceptions being scripts and the Select Menu item action which has its own facilities). | + | |
Action fields that accept tokens also process %NN% or %NNNN% as arbitrary hex unicode characters (eg %41% is an A), and (except for regular expression fields) process backslashed characters \a,\b,\e,\f,\t,\r,\n (bell,backspace,escape,form feed,tab,return,line feed). | Action fields that accept tokens also process %NN% or %NNNN% as arbitrary hex unicode characters (eg %41% is an A), and (except for regular expression fields) process backslashed characters \a,\b,\e,\f,\t,\r,\n (bell,backspace,escape,form feed,tab,return,line feed). | ||
Line 27: | Line 33: | ||
- | ---- | ||
- | |||
- | ===== List of Tokens ===== | ||
- | |||
- | |||
- | ~~NOCACHE~~ | ||
- | <nspages token -textPages=""> |