User Tools
trigger:Typed_String
Differences
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 | ||
|
trigger:Typed_String [2016/04/08 10:38] AlainLifchitz add internal links |
trigger:Typed_String [2017/08/16 02:21] peternlewis |
||
|---|---|---|---|
| Line 4: | Line 4: | ||
| **WARNING:** You should generally not use a Typed String trigger that simulates deletes in a non-text typing context, as the simulated delete keystrokes could be destructive. | **WARNING:** You should generally not use a Typed String trigger that simulates deletes in a non-text typing context, as the simulated delete keystrokes could be destructive. | ||
| + | |||
| + | **NOTE:** If you are going to immediately change focus (for example, with a Prompt For User Input, or by switching windows or applications), then you may need a short pause at the start of the macro to allow the simulated deletes to be processed before the focus changes. | ||
| To avoid macros firing unexpectedly it is a good idea to include a consistent prefix and/or suffix to your strings. For example, to insert your email address, rather than use just “em” (which would fire if you typed “them”), use something like “=em=” which you will not type accidentally. | To avoid macros firing unexpectedly it is a good idea to include a consistent prefix and/or suffix to your strings. For example, to insert your email address, rather than use just “em” (which would fire if you typed “them”), use something like “=em=” which you will not type accidentally. | ||
| Line 11: | Line 13: | ||
| As above, typing Shift-Space will cancel the sequence, as will any control key or command key (eg Command-.), any macro execution, switching applications, clicking the mouse, or not typing for more than a few seconds. | As above, typing Shift-Space will cancel the sequence, as will any control key or command key (eg Command-.), any macro execution, switching applications, clicking the mouse, or not typing for more than a few seconds. | ||
| - | You can optionally allow typed string triggers to work regardless of case, regardless of diacriticals, or to remember the case of the typed string and mimic the case in any Insert Text actions. You can limit the typed string trigger to only work after a word break (which means any non-alphanumeric character, or any case that cancels the sequence as described above). | + | You can optionally allow typed string triggers to work regardless of case, regardless of diacriticals. |
| + | |||
| + | You can have the case of the typed string and affect Insert Text actions. This means that if you type the string in all uppercase, the resulting Insert Text will also be uppercased. If you type just the first letter in uppercase, just the first resulting Insert Text will be uppercase. | ||
| + | |||
| + | You can limit the typed string trigger to only work after a word break (which means any non-alphanumeric character, or any case that cancels the sequence as described above). **Note** that this means the match will happen only after you type a word break and then the Typed String - Keyboard Maestro des not know what you will type in the future so it cannot restrict matches to only happen if you plan to type a word break next. | ||
| Alternatively, you can use a [[:Regular Expressions|regular expression]] to match a trigger. The trigger is matched against the end of the typing sequence, so there is an implicit \z on the end of the [[:Regular Expressions|regular expression]]. Note that it would be useless to try to match a word break at the end with \b or some sort of positive or negative lookahead assertion as the typing sequence always ends at the current character. So for example "ell\b" would match "hell" even if the next character you planned on typing was an "o". | Alternatively, you can use a [[:Regular Expressions|regular expression]] to match a trigger. The trigger is matched against the end of the typing sequence, so there is an implicit \z on the end of the [[:Regular Expressions|regular expression]]. Note that it would be useless to try to match a word break at the end with \b or some sort of positive or negative lookahead assertion as the typing sequence always ends at the current character. So for example "ell\b" would match "hell" even if the next character you planned on typing was an "o". | ||
| - | You can use the %TriggerValue% [[:Tokens|Text Token]] to determine the exact text that was typed. | + | You can use the [[token:TriggerValue|%TriggerValue% Text Token]] to determine the exact text that was typed. |
| If multiple typed string triggers match from the end (eg "hello" and "llo"), the longest will be used. If there are multiple matches with the same length (as can occur if you use the case or diacritic options), the conflict palette will be displayed, offering a selection of the matching macros. In this case, if all of the typed string triggers have the "Simulate N deletes before executing" option enabled, the deletes will be simulated immediately and then the conflict palette will be displayed; otherwise the deletes will not be simulated. | If multiple typed string triggers match from the end (eg "hello" and "llo"), the longest will be used. If there are multiple matches with the same length (as can occur if you use the case or diacritic options), the conflict palette will be displayed, offering a selection of the matching macros. In this case, if all of the typed string triggers have the "Simulate N deletes before executing" option enabled, the deletes will be simulated immediately and then the conflict palette will be displayed; otherwise the deletes will not be simulated. | ||
| Line 24: | Line 30: | ||
| Note also that there is a relatively prevalent [[http://wiki.keyboardmaestro.com/Troubleshooting#Not_Being_Able_To_Enter_a_Hot_Key|third party / system bug]] | Note also that there is a relatively prevalent [[http://wiki.keyboardmaestro.com/Troubleshooting#Not_Being_Able_To_Enter_a_Hot_Key|third party / system bug]] | ||
| - | that makes the system think it is permanently in a password filed, and thus will prevent typed string triggers from working. | + | that makes the system think it is permanently in a password field, and thus will prevent typed string triggers from working. |
| ===== See Also ===== | ===== See Also ===== | ||
| ---- | ---- | ||
| + | |||
| + | === Tokens === | ||
| + | |||
| + | * [[token:Trigger|%Trigger%]] | ||
| + | * [[token:TriggerBase|%TriggerBase%]] | ||
| + | * [[token:TriggerValue|%TriggerValue%]] | ||
| + | * [[:Tokens|See all Tokens]] | ||
| === Triggers === | === Triggers === | ||
| Line 34: | Line 47: | ||
| * [[:Triggers|See all Triggers]] | * [[:Triggers|See all Triggers]] | ||
| - | ==== Documentation ==== | + | ==== Topics ==== |
| * [[:Regular Expressions]] | * [[:Regular Expressions]] | ||
| Line 44: | Line 57: | ||
| - [[https://forum.keyboardmaestro.com/t/generic-or-universal-text-expansion/3331/2|Generic or Universal Text Expansion]] | - [[https://forum.keyboardmaestro.com/t/generic-or-universal-text-expansion/3331/2|Generic or Universal Text Expansion]] | ||
| - [[https://forum.keyboardmaestro.com/t/keyboard-maestro-append-suffix-ation-to-typed-word-macro/3335|Keyboard Maestro “Append suffix '-ation' to typed word” Macro]] | - [[https://forum.keyboardmaestro.com/t/keyboard-maestro-append-suffix-ation-to-typed-word-macro/3335|Keyboard Maestro “Append suffix '-ation' to typed word” Macro]] | ||
| + | - [[https://forum.keyboardmaestro.com/t/customize-keyboard-shortcut-in-conflict-palette/3682/2|Customize keyboard shortcut in conflict palette?]] | ||
| - | - [[https://www.google.fr/search?q=site:forum.keyboardmaestro.com+Typed+String+trigger|Keyboard Maestro Forum topics about Typed String trigger]] | + | - [[https://forum.keyboardmaestro.com/search?q=Typed%20String%20trigger|Keyboard Maestro Forum topics about Typed String trigger]] |
| - | + | ||
| - | + | ||
trigger/Typed_String.txt · Last modified: 2023/11/01 00:14 by peternlewis
Page Tools
