User Tools

Site Tools


actions:Browser_Form_Actions

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
actions:Browser_Form_Actions [2017/08/30 05:32]
peternlewis
actions:Browser_Form_Actions [2019/07/08 03:52] (current)
peternlewis
Line 1: Line 1:
-The *Browser Form Actions* let you interact with form fields in a active web browser page, including submitting forms, reading, writing and focusing fields, and more.  These actions sit alongside the [[Browser_Window_Actions|browser window actions]] for creating and moving between tabs and windows.+====== ​Browser Form Actions ​======
  
-Like other [[Browser_Actions|browser actions]], these actions work with Safari or Google Chrome (or whichever of the two was last at the front).+===== Introduction =====
  
-{{:action:interactwithwebform.png|}}+The *Browser Form Actions* let you interact with form fields in a active web browser page, including submitting forms, reading, writing and focusing fields, and more.  These are companion actions to the [[Browser_Window_Actions|browser window actions]] for creating and moving between tabs and windows. 
 + 
 +==== Available Actions ==== 
 + 
 +The following Actions are available to deal with browser forms: 
 + 
 +* Focus Front Browser Field 
 +* Select Front Browser Field 
 +* Set Front Browser Checkbox 
 +* Set Front Browser Field to Text 
 +* Set Front Browser Radio Button 
 +* Set Variable to Front Browser Field 
 +* Submit Front Browser Form 
 +* Reset Front Browser Form 
 + 
 +Where "Front Browser"​ will use either Google Chrome or Safari, whichever was frontmost last.\\ 
 +If you want to target a specific browser, then replace "Front Browser"​ with "​Google Chrome"​ or "​Safari"​ 
 + 
 +==== Action Parameter ==== 
 + 
 +Each _Action_ has a parameter to uniquely identify the form or form field on the web page. 
 +The parameter can be an [[:XPath]] or a JavaScript ​Keyboard Maestro will try to identify all forms and field on the web page, and make them available in a popup on the _Action_. ​ To view the popup, click on the button labeled "Front Browser"​ or "​Google Chrome"​ or "​Safari",​ based on the specific Action you have selected. 
 + 
 +===== Definitions =====
  
-The actions for interacting with a form are: 
  
-===== Focus Field =====+==== Focus Field ====
  
 The pop-up menu at the right side of the Action builds a list of all form fields on the active tab. Select the field you want to focus and it will be entered in the action’s Focus Field text area. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area. The pop-up menu at the right side of the Action builds a list of all form fields on the active tab. Select the field you want to focus and it will be entered in the action’s Focus Field text area. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area.
  
-===== Select Field =====+==== Select Field ====
  
 The pop-up menu at the right side of the Action builds a list of all form fields on the active tab. Select the field whose contents you want to select and it will be entered in the action’s Select Field text area. When the action runs any text in that form field will be selected. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area. The pop-up menu at the right side of the Action builds a list of all form fields on the active tab. Select the field whose contents you want to select and it will be entered in the action’s Select Field text area. When the action runs any text in that form field will be selected. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area.
  
-===== Set Field to Text =====+==== Set Field to Text ====
  
 The pop-up menu at the right side of the Action builds a list of all form fields on the active tab. Select the field to fill and it will be entered in the action’s Set Field text area. Next type or paste  the text to enter into the selected field in the action’s to text area. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area. The pop-up menu at the right side of the Action builds a list of all form fields on the active tab. Select the field to fill and it will be entered in the action’s Set Field text area. Next type or paste  the text to enter into the selected field in the action’s to text area. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area.
Line 21: Line 43:
 At the bottom of the action you can see a preview of what will be entered. At the bottom of the action you can see a preview of what will be entered.
  
-===== Set Variable to Field =====+==== Set Variable to Field ====
  
 This action allows you to capture text from a form field to a variable. Use the arrow beside the action’s Set Variable text area to select the variable you wish to set. Its name will be entered in the text area.  This action allows you to capture text from a form field to a variable. Use the arrow beside the action’s Set Variable text area to select the variable you wish to set. Its name will be entered in the text area. 
Line 29: Line 51:
 At the bottom of the action you can see a preview of what will be captured. At the bottom of the action you can see a preview of what will be captured.
  
-===== Set Checkbox ​=====+==== Set Checkbox ====
  
 The pop-up menu at the right side of the Action builds a list of all checkboxes on the active tab. Select the checkbox to set and it will be entered in the action’s Set checkbox text area. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area. The pop-up menu at the right side of the Action builds a list of all checkboxes on the active tab. Select the checkbox to set and it will be entered in the action’s Set checkbox text area. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area.
Line 43: Line 65:
 At the bottom of the action you can see a preview of what will be captured. At the bottom of the action you can see a preview of what will be captured.
  
-===== Set Radio Button ​=====+==== Set Radio Button ====
  
 The pop-up menu at the right side of the Action builds a list of all radio buttons on the active tab. Select the radio button to set and it will be entered in the action’s Set radio button text area. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area. The pop-up menu at the right side of the Action builds a list of all radio buttons on the active tab. Select the radio button to set and it will be entered in the action’s Set radio button text area. Use the arrow at the right of the text area to select variables, calculations,​ clipboards and other tokens to enter in the text area.
Line 53: Line 75:
 At the bottom of the action you can see a preview of the outcome of running the action. At the bottom of the action you can see a preview of the outcome of running the action.
  
-===== Submit Form =====+==== Submit Form ====
  
 This action submits the selected web form. This action submits the selected web form.
  
-===== Reset Form =====+==== Reset Form ====
  
 This action resets the selected web form, clearing all entered text and values. This action resets the selected web form, clearing all entered text and values.
  
 +===== Examples =====
  
 +{{:​actions:​set-form-field-to-text-km8.png?​nolink|}}
 +
 +{{:​action:​interactwithwebform.png|}}
  
 ===== See Also ===== ===== See Also =====
 +
 +=== Actions ===
  
 * [[Browser_Actions|Browser Actions]] * [[Browser_Actions|Browser Actions]]
 * [[Browser_Window_Actions|Browser Window Actions]] * [[Browser_Window_Actions|Browser Window Actions]]
 * [[Wait_For_Browser_to_Finish_Loading| Wait For Browser to Finish Loading actions]] * [[Wait_For_Browser_to_Finish_Loading| Wait For Browser to Finish Loading actions]]
- 
-=== Actions === 
  
 * [[:​Actions|See all Actions]] * [[:​Actions|See all Actions]]
actions/Browser_Form_Actions.1504085541.txt.gz · Last modified: 2017/08/30 05:32 by peternlewis