You choose a right-click menu item
Adds an item to the browser's right-click menu under Switchboard, and runs the macro when you choose it.
You choose title from the right-click menu
Details #
Each macro with this trigger adds one item to the right-click menu under Switchboard. contexts says where it shows: page, link, selection, image, editable.
The run starts with the page's inputs plus context, and linkUrl, selectionText or srcUrl when you clicked one. {{triggerValue}} is the selection, link or image address.
Parameters #
| Parameter | Type | Required | Values | What it does |
|---|---|---|---|---|
title | text | Yes | The menu item's text. Required. | |
contexts | list of | page link selection image editable | Where it shows. Default page. | |
match | record | browser title url | Which pages. url is a pattern (https://*.github.com/*/pull/*), a plain start (github.com/apple) or /regex/; title is text (any case) or /regex/; browser is safari, chrome or any. |
Every trigger also takes Limits: a cooldown, the first time each day, every nth time, twice within seconds, a chance, only while you are at the Mac, on one Mac, or in a State. See Limits on any trigger.
Examples #
- You choose “Save link to reading list” from the right-click menu on a page
- Run shell script “echo '{{linkUrl}}' >> ~/reading-list.txt”
Gotchas #
The menu is rebuilt when your macros change, so a new item shows within a second or two.
Safari shows the Switchboard submenu only where it supports extension menus.