Assim como as extensões permitem que os usuários personalizem o navegador Chrome, a página de opções permite fazer isso. Use opções para ativar recursos e permitir que os usuários escolham qual funcionalidade é relevante para as necessidades deles.
Como localizar a página de opções
Os usuários podem acessar a página de opções pelo link direto ou clicando com o botão direito do mouse no ícone da extensão na barra de ferramentas e selecionando as opções. Além disso, os usuários podem acessar a página de opções. Para isso, primeiro abra o chrome://extensions
, localize a extensão desejada, clique em Detalhes e selecione o link de opções.
![Link da página de opções na interface do usuário](https://developer.chrome.com/static/docs/extensions/develop/ui/options-page/image/options-page-link-the-us-ae0a3ee5d7b2e.png?authuser=5&hl=pt)
![Página de opções do menu de contexto](https://developer.chrome.com/static/docs/extensions/develop/ui/options-page/image/context-menu-options-page-3d4d2c8dcce27.png?authuser=5&hl=pt)
Escrever a página de opções
Este é um exemplo de página de opções:
options.html:
<!DOCTYPE html>
<html>
<head>
<title>My Test Extension Options</title>
</head>
<body>
<select id="color">
<option value="red">red</option>
<option value="green">green</option>
<option value="blue">blue</option>
<option value="yellow">yellow</option>
</select>
<label>
<input type="checkbox" id="like" />
I like colors.
</label>
<div id="status"></div>
<button id="save">Save</button>
<script src="options.js"></script>
</body>
</html>
Veja abaixo um exemplo de script de opções. Salve o arquivo na mesma pasta que options.html
.
Isso salva as opções preferidas do usuário em todos os dispositivos usando a API storage.sync
.
options.js:
// Saves options to chrome.storage
const saveOptions = () => {
const color = document.getElementById('color').value;
const likesColor = document.getElementById('like').checked;
chrome.storage.sync.set(
{ favoriteColor: color, likesColor: likesColor },
() => {
// Update status to let user know options were saved.
const status = document.getElementById('status');
status.textContent = 'Options saved.';
setTimeout(() => {
status.textContent = '';
}, 750);
}
);
};
// Restores select box and checkbox state using the preferences
// stored in chrome.storage.
const restoreOptions = () => {
chrome.storage.sync.get(
{ favoriteColor: 'red', likesColor: true },
(items) => {
document.getElementById('color').value = items.favoriteColor;
document.getElementById('like').checked = items.likesColor;
}
);
};
document.addEventListener('DOMContentLoaded', restoreOptions);
document.getElementById('save').addEventListener('click', saveOptions);
Por fim, adicione a permissão "storage"
ao arquivo de manifesto da extensão:
manifest.json:
{
"name": "My extension",
...
"permissions": [
"storage"
]
...
}
Comportamento da página "Declarar opções"
Há dois tipos de páginas com opções de extensão, página inteira e incorporada. A página de tipos de opções é determinada pela forma como ela é declarada no manifesto.
Opções de página inteira
Uma página de opções de página inteira será exibida em uma nova guia. Registre o arquivo HTML de opções no manifesto do campo "options_page"
.
manifest.json:
{
"name": "My extension",
...
"options_page": "options.html",
...
}
![Opções de página inteira](https://developer.chrome.com/static/docs/extensions/develop/ui/options-page/image/full-page-options-06cf906a1303e.png?authuser=5&hl=pt)
Opções incorporadas
Uma página de opções incorporadas permite que os usuários ajustem as opções de extensões sem sair da
página de gerenciamento de extensões dentro de uma caixa incorporada. Para declarar opções incorporadas, registre o arquivo HTML
no campo "options_ui"
do manifesto de extensão, com a chave "open_in_tab"
definida como false
.
manifest.json:
{
"name": "My extension",
...
"options_ui": {
"page": "options.html",
"open_in_tab": false
},
...
}
![Opções incorporadas](https://developer.chrome.com/static/docs/extensions/develop/ui/options-page/image/embedded-options-7de329f362ce.png?authuser=5&hl=pt)
page
(string)- Especifica o caminho para a página de opções, em relação à raiz da extensão.
open_in_tab
(boolean)- Indica se a página de opções da extensão será aberta em uma nova guia. Se definido como
false
, a página de opções da extensão será incorporada nochrome://extensions
em vez de aberta em uma nova guia.
Considere as diferenças
As páginas de opções incorporadas em chrome://extensions
têm diferenças sutis de comportamento em relação às páginas de opções nas guias.
Link para a página de opções
Uma extensão pode ser vinculada diretamente à página de opções chamando chrome.runtime.openOptionsPage()
. Por exemplo, ela pode ser adicionada a um pop-up:
popup.html:
<button id="go-to-options">Go to options</button>
<script src="popup.js"></script>
popup.js:
document.querySelector('#go-to-options').addEventListener('click', function() {
if (chrome.runtime.openOptionsPage) {
chrome.runtime.openOptionsPage();
} else {
window.open(chrome.runtime.getURL('options.html'));
}
});
API Tabs
Como o código de opções incorporadas não é hospedado em uma guia, a API Tabs não pode ser usada.
Use runtime.connect()
e runtime.sendMessage()
,
se a página de opções precisar manipular a guia que os contém.
APIs de mensagens
Se a página de opções de uma extensão enviar uma mensagem usando runtime.connect()
ou runtime.sendMessage()
, a guia do remetente não será definida, e o URL do remetente será o URL da página de opções.
Tamanho
O tamanho das opções incorporadas deve ser determinado automaticamente com base no conteúdo da página. No entanto, a caixa incorporada pode não ter um tamanho adequado para alguns tipos de conteúdo. Esse problema é mais comum para páginas de opções que ajustam a forma do conteúdo com base no tamanho da janela.
Se isso for um problema, forneça dimensões mínimas fixas para a página de opções para garantir que a página incorporada encontre um tamanho adequado.