Setting Safari app extension feature keys
Set keys for permissions, scripts, style sheets, contextual menu items, and toolbar items in the information property list file.
Overview
After selecting which default keys to use in your Safari app extension’s information property list file, select the appropriate feature keys to identify files and UI items.
The table below lists the primary keys in the NSExtension dictionary that are associated with Safari app extension features. For information on available subkeys, see the link in the primary key description.
Key | Type | Description |
|---|---|---|
| Array | An array for adding content scripts to the extension. Each value in the array is a dictionary that provides the filename for a content script. [Image] For subkeys, see Using Content Script And Style Sheet Keys. |
| Array | An array for adding items to Safari’s context menu — the menu that appears when the user Control-clicks a webpage. For more information, see Adjusting Settings For Contextual Menu Items. [Image] For subkeys, see Using Contextual Menu And Toolbar Item Keys. |
| Array | An array for adding style sheets to the extension or to pages from a limited subset of URLs. Each value in the array is a dictionary that provides the filename for a content script. [Image] For subkeys, see Using Content Script And Style Sheet Keys. For more information, see Injecting Css Style Sheets Into A Webpage. |
| Dictionary | A dictionary for adding a toolbar item to Safari windows. [Image] For subkeys, see Using Contextual Menu And Toolbar Item Keys. |
| Dictionary | An optional dictionary that specifies which webpages the Safari app extension can access, if any. [Image] For details about configuring website access, see Adjusting Website Access Permissions. |
In addition to the NSExtension keys, the Info.plist file includes an NSHumanReadableDescription key for your Safari app extension. When you install the app extension, the string value of this key appears in Safari > Settings > Preferences as the example below shows:
[Image]