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 | ||
action:Custom_HTML_Prompt [2017/09/07 01:28] peternlewis [See Also] |
action:Custom_HTML_Prompt [2017/10/04 02:51] peternlewis [Using JavaScript] |
||
---|---|---|---|
Line 18: | Line 18: | ||
- Use these //Variables// in any other Actions you need | - Use these //Variables// in any other Actions you need | ||
+ | The action will wait for the window to complete before continuing unless you turn on *Asynchronously* (v8+) in the gear BUTTON{{{⚙}}} menu. | ||
+ | By default, the window floats above all others, but you can optionally turn off *Floating* (v8+) in the gear BUTTON{{{⚙}}} menu. | ||
+ | |||
+ | You can optionally turn on *Resizable* (v8+) in the gear BUTTON{{{⚙}}} menu. | ||
You design the HTML form using standard HTML code, which can be stored in either a file or as text in the Action. You can, of course, use any Web/HTML editor you like. If you'd like some suggestions, see the [[Custom_HTML_Prompt#WebHTML_Editors|Web/HTML Editors]] section at the bottom of this page for editors that others have found useful. | You design the HTML form using standard HTML code, which can be stored in either a file or as text in the Action. You can, of course, use any Web/HTML editor you like. If you'd like some suggestions, see the [[Custom_HTML_Prompt#WebHTML_Editors|Web/HTML Editors]] section at the bottom of this page for editors that others have found useful. | ||
Line 95: | Line 99: | ||
|*data-kmignoresubmit* |avoid saving form field back to the *Keyboard Maestro Variable*| | |*data-kmignoresubmit* |avoid saving form field back to the *Keyboard Maestro Variable*| | ||
|*data-kmignore* | avoid setting and saving the form field| | |*data-kmignore* | avoid setting and saving the form field| | ||
+ | |||
+ | ==== Handling HTTP links ==== | ||
+ | |||
+ | By default, http: and other links (everything except file: links) are passed to the to open as normal. | ||
+ | |||
+ | You can elect (v8+) to handle schemes yourself by including a `data-kmhandleschemes` attribute in the body element, or by implementing the `KMHandleSchemes()` function. | ||
+ | |||
+ | Either can return the schemes you want to handle (most likely only http) as a comma or space separated list. | ||
===== Using JavaScript ===== | ===== Using JavaScript ===== | ||
Line 100: | Line 112: | ||
You may use any JavaScript that you normally could in an HTML page. | You may use any JavaScript that you normally could in an HTML page. | ||
- | Keyboard Maestro provides the following built-in JavaScript functions: | + | Keyboard Maestro calls the following JavaScript functions: |
^ Function ^ Called ^ | ^ Function ^ Called ^ | ||
Line 106: | Line 118: | ||
| KMWindow() | to return the desired size or frame of the window as a string| | | KMWindow() | to return the desired size or frame of the window as a string| | ||
| KMWillShowWindow() | when the window will be shown| | | KMWillShowWindow() | when the window will be shown| | ||
- | | KMDidShowWindow() | when the window was just shown (7.1+) | | + | | KMDidShowWindow() | when the window was just shown (v7.1+) | |
+ | | KMHandleSchemes() | to return the schemes you wish to handle within the web page (v8+) | | ||
+ | | KMWillCloseWindow() | called when the window is about to be closed (v8.0.3+) | | ||
From within the window, you can call the following functions: | From within the window, you can call the following functions: |