Skip to content

Commit

Permalink
Adds readme files for every mv3 sample
Browse files Browse the repository at this point in the history
  • Loading branch information
IanStanion-google committed Jun 30, 2023
1 parent 7e06728 commit 92d9dd5
Show file tree
Hide file tree
Showing 16 changed files with 124 additions and 0 deletions.
File renamed without changes.
14 changes: 14 additions & 0 deletions api-samples/alarms/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# chrome.browsingData

This sample demonstrates using the `chrome.alarms` API to allow the user to set alarms using an extension page.

## Overview

The extension uses `chrome.alarms.create()` to set an initial alarm that is displated on the extension page. More alarms can be set with user input.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Pin the extension to the taskbar to access the action button.
4. Open the extension popup by clicking the action button and interact with the UI.
File renamed without changes.
15 changes: 15 additions & 0 deletions api-samples/contextMenus/global_context_search/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# chrome.contextMenus

This sample demonstrates using the `chrome.contextMenus` API to let a user switch between searching different countries' versions of Google via a contextMenu.

## Overview

The extension uses `chrome.contextMenus.create()` to populate the context menu with locale options based on an options menu in the popup. A `chrome.contextMenus.onClicked.addListener()` event will open a specific locale's Google homepage when one of the extension's context menu options are clicked.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Pin the extension to the taskbar to access the action button.
4. Open the extension popup by clicking the action button and interact with the UI.
5. Right click within the browser to view and interact with the context menu.
14 changes: 14 additions & 0 deletions api-samples/cookies/cookie-clearer/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# chrome.cookies

This sample demonstrates using the `chrome.cookies` API to let a user delete their cookies via a popup UI.

## Overview

The extension uses `chrome.cookies.getAll()` and `chrome.cookies.remove()` to delete the user's cookies when prompted.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Pin the extension to the taskbar to access the action button.
4. Open the extension popup by clicking the action button and interact with the UI.
13 changes: 13 additions & 0 deletions api-samples/default_command_override/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# chrome.cookies

This sample demonstrates using the `chrome.commands` API to create a new keyboard macro for switching tabs in the browser window.

## Overview

The extension sets Ctrl+Shift+Left and "Ctrl+Shift+Right as command inputs in the manifest, and uses `chrome.commands.onCommand.addListener()` to trigger switching tabs.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Input the keyboard commands to switch between tabs.
14 changes: 14 additions & 0 deletions api-samples/favicon/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# favicon

This sample demonstrates using the favicon manifest permission to display the favicon of a url in the extension popup.

## Overview

The extension uses `chrome.runtime.getURL('/_favicon/')` to create a fully-qualified URL pointing to the "\_favicon/" folder. Then it returns a new string representing the URL with several query parameters. Finally, the extension appends the image to the body of the extension popup.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Pin the extension to the taskbar to access the action button.
4. Open the extension popup by clicking the action button.
14 changes: 14 additions & 0 deletions api-samples/fontSettings/fontSettings Basic/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# chrome.fontSettings

Demonstrates the `chrome.fontSettings` API by allowing users to modify the styling displayed fonts on webpages.

## Overview

Creates a user interface in the extension's options page that allows users to see and modify font settings using `chrome.fontSettings` to change parameters.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Pin th extension to the taskbar and click the action button.
4. Click the extension's action button to visit the popup page.
File renamed without changes.
14 changes: 14 additions & 0 deletions api-samples/il8n/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# chrome.i18n

This sample demonstrates using the `chrome.i18n` API localize text in the extension popup.

## Overview

The extension includes localized translations of its UI text in the \_locales folder. It then uses `chrome.i18n.getMessage()` to populate the text in the extension UI with either French or English, depending on the current language setting.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Pin the extension to the taskbar to access the action button.
4. Open the extension popup by clicking the action button.
13 changes: 13 additions & 0 deletions api-samples/omnibox/new-tab-search/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# chrome.omnibox

This sample demonstrates using the `"omnibox"` manifest key and API to create a keyword that opens up a browser search in a new tab.

## Overview

The extension uses `"omnibox"` manifest key and its parameter `"keyword"`. When `chrome.omnibox.onInputEntered.addListener()` is triggered and the keyword 'nt' is used, a new tab is opened with a google search for the user's input text.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Type 'nt' and some text you wish to google within the browser omnibox.
13 changes: 13 additions & 0 deletions api-samples/override/blank_ntp/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# "chrome_url_overrides"

This sample demonstrates using the ` "chrome_url_overrides"` manifest key to replace the user's default New Tab page with a new html file.

## Overview

The extension uses ` "chrome_url_overrides"` and its parameter `"newtab"` to replace the New Tab page with blank.html.

## Running this extension

1. Clone this repository.
2. Load this directory in Chrome as an [unpacked extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked).
3. Open a new tab while the extension is enabled.
File renamed without changes.

0 comments on commit 92d9dd5

Please sign in to comment.