User Tools

Site Tools


Tokens

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

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:43]
peternlewis
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).
  
-===== 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="">​ 
Tokens.txt · Last modified: 2020/08/17 21:27 by peternlewis