Keyboard Maestro Wiki

User Tools

Site Tools

Trace: • Home_Page • Select_Google_Chrome_Tab • Browser_Window_Actions • Prompt_for_User_Input • Assert • Copy_to_Named_Clipboard • Small_Increase_Screen_Brightness • Brightness_Actions • Open_a_URL • BBEdit_Markdown
action:For_Each

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
action:For_Each [2017/09/07 05:42] – [How To Use] peternlewisaction:For_Each [2024/11/22 07:50] (current) – [See also] peternlewis
Line 1: Line 1:
-{{:action:for-each-icon.png?nolink |}} 
 ====== For Each Action ====== ====== For Each Action ======
  
  
-The For Each action loops over a set of [collections](:Collections) of items, setting a variable to each value and executing the contained actions. +The *For Each* action loops over a set of [collections](:Collections) of items, setting a variable to each value and executing the contained actions. 
 + 
 +It is one of several Actions that _loop_ through a set of other Actions until some criteria is met.
  
 Whenever you need to deal with a list of things (lines, files, volumes, numbers, etc), the For Each action is a good place to start.  Whenever you need to deal with a list of things (lines, files, volumes, numbers, etc), the For Each action is a good place to start. 
  
 ===== How To Use ===== ===== How To Use =====
 +
   - Add the //For Each// Action, from the //Control Flow// Category, to your macro   - Add the //For Each// Action, from the //Control Flow// Category, to your macro
     - {{:action:km-editor-for-each-action.png?nolink|}}     - {{:action:km-editor-for-each-action.png?nolink|}}
Line 17: Line 19:
   - Add a collection by clicking the green + button beside //New Collection// to select from a list of available collections. You can learn more about the available collections on the [[:Collections]] page.   - Add a collection by clicking the green + button beside //New Collection// to select from a list of available collections. You can learn more about the available collections on the [[:Collections]] page.
   - When you choose a specific collection, further options may become available.   - When you choose a specific collection, further options may become available.
-  - Drag one or more actions into the //No Action// (which means no actions have been added yet) area.+  - Add one or more actions into the //No Action// (which means no actions have been added yet) area.
     * These actions will operate on each item in the Collection that is stored in the Variable from Step #2     * These actions will operate on each item in the Collection that is stored in the Variable from Step #2
  
 You can break out of the loop, retry this iteration, or skip to the next iteration with the [[actions:Redirect_Control_Flow|actions:Redirect Control Flow]] actions. You can break out of the loop, retry this iteration, or skip to the next iteration with the [[actions:Redirect_Control_Flow|actions:Redirect Control Flow]] actions.
 +
 +There is an option in the action (gear) ⚙ menu to display the progress of the For Each action (v10.0+).
  
 ===== Examples ===== ===== Examples =====
Line 36: Line 40:
  
 ===== See also ===== ===== See also =====
- 
----- 
  
 === Actions === === Actions ===
  
-* [[action:Search Variable|action:Search Variable]]+* [[action:Pause_Until|Pause Until]] action 
 +* [[action:Repeat|Repeat]] action 
 +* [[action:Until|Until]] action 
 +* [[action:While|While]] action 
 +* [[action:Assert|Assert]] action 
 +* [[actions:Redirect_Control_Flow|Redirect Control Flow]] actions
 * [[:Actions|See all actions]] * [[:Actions|See all actions]]
 +
  
 === Triggers === === Triggers ===
Line 48: Line 56:
 * [[trigger:Typed String|trigger:Typed String]] * [[trigger:Typed String|trigger:Typed String]]
 * [[:Triggers|See all triggers]] * [[:Triggers|See all triggers]]
- 
----- 
  
 ==== Forum ==== ==== Forum ====
action/For_Each.1504762957.txt.gz · Last modified: by peternlewis
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki