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/22 21:07] JMichaelTX ADD: Definition, Anim. GIF example, sub-sections |
Tokens [2019/08/22 21:24] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{:token-icon.png?nolink|}} | ||
====== Tokens ====== | ====== Tokens ====== | ||
===== 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 that will replace it in the text.** 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). |
- | ===== How To Use ===== | + | To include a percent in your text, simply double the percent. To include a backslash in your text, double the backslash. |
- | 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. | ||
+ | ===== List of Tokens ===== | ||
- | {{:km-7.1-insert-token-demo-an.gif?nolink|}} | + | ~~NOCACHE~~ |
+ | <nspages token -textPages=""> | ||
+ | ===== How To Use ===== | ||
- | ---- | + | 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. |
- | 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). | + | {{:km-7.1-insert-token-demo-an.gif?nolink|}} |
- | To include a percent in your text, simply double the percent (%%). To include a backslash \ in your text, double the backslash (\\). | ||
+ | Most fields that contain text (ie, not just numbers) can include tokens. | ||
- | ---- | + | 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). |
- | ===== List of Tokens ===== | + | To include a percent (`%`) in your text, simply double the percent (`%%`). To include a backslash (`\`) in your text, double the backslash (`\\`). |
- | ~~NOCACHE~~ | ||
- | <nspages token -textPages=""> |