User Tools
manual:Tokens
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
|
manual:Tokens [2019/09/17 08:31] peternlewis [Other Uses for Tokens] |
manual:Tokens [2021/10/04 02:44] peternlewis [Text Case Conversions] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Tokens ====== | ====== Tokens ====== | ||
| - | **Keyboard Maestro provides two means to get information about objects (like web pages and windows) in the user's environment:** | + | Keyboard Maestro provides two means to get information about objects (like web pages and windows) in the user's environment: |
| 1. [[:Tokens|Tokens]] (returns text, used in [[/Text_Fields|text fields]]) | 1. [[:Tokens|Tokens]] (returns text, used in [[/Text_Fields|text fields]]) | ||
| Line 56: | Line 56: | ||
| * Just tokens (not backslashed characters) or | * Just tokens (not backslashed characters) or | ||
| * Do not process any text. | * Do not process any text. | ||
| - | |||
| - | |||
| - | If you want to use the percent `%` character as a normal character, simply double the percent (`%%`). \\ | ||
| - | To use a backslash `\` in your text, double the backslash (`\\`). | ||
| Line 70: | Line 66: | ||
| === Convert Hex to Unicode Characters === | === Convert Hex to Unicode Characters === | ||
| - | Text token fields also process %NN% or %NNNN% or %NNNNNN% as arbitrary hex unicode characters (eg %41% is an A, %01F300% is 🌀), and (except for regular expression fields) . | + | Text token fields also process %NN% or %NNNN% or %NNNNNN% as arbitrary hex unicode characters (eg %41% is an A, %01F300% is 🌀). |
| === Using Special Characters as Plain Text === | === Using Special Characters as Plain Text === | ||
| Line 79: | Line 75: | ||
| ===== Text Case Conversions ===== | ===== Text Case Conversions ===== | ||
| - | Text fields also support (v9.0+) text case conversion using the below meta characters. You may use these in both standard Text Fields and in the Replace field of a [[action:Search_and_Replace|Search and Replace by regular expression]] action (even though these meta characters are _not_ supported by ICS Regular Expressions). | + | Text fields also support text case conversion using the below meta characters. You may use these in both standard Text Fields and in the Replace field of a [[action:Search_and_Replace|Search and Replace by regular expression]] action (even though these meta characters are _not_ supported by ICS Regular Expressions). |
| The Available Case Conversion Meta Characters are: | The Available Case Conversion Meta Characters are: | ||
| Line 97: | Line 93: | ||
| With tokens that return a list of information (comma separated by default), you can access the individual items using the Variable array notation, append the item number in square brackets `[ ]` to the Token name, just before the closing `%`. | With tokens that return a list of information (comma separated by default), you can access the individual items using the Variable array notation, append the item number in square brackets `[ ]` to the Token name, just before the closing `%`. | ||
| - | For example:\\ | + | For example: |
| Token for Window Frame, [[token:WindowFrame | %WindowFrame[3]%1%]], will be the third comma-separated value, which is the Window width in this case. | Token for Window Frame, [[token:WindowFrame | %WindowFrame[3]%1%]], will be the third comma-separated value, which is the Window width in this case. | ||
manual/Tokens.txt · Last modified: 2023/10/02 00:10 by peternlewis
Page Tools
