Subscribe

Browser extensions - Custom options page

✍️

How to create a custom options page for browser extensions

24 Aug, 2022 · 4 min read

In the previous article, we added an option to change the color of our extensions. So far, we have used our main popup view, but we can also leverage the browser options menu.

This is a neat trick to clean up extension options, and in this article, I’ll show you how you can achieve it.

Chrome extension options

If you would like to follow along with the article, take the following GitHub branch as your starting point.

Adding options to a browser extension

Like everything involving the extensions, we must first register the options menu in our manifest file. Open the manifest.json file and add the following config.

{
  "options_ui": {
    "page": "options.html",
    "open_in_tab": false
  }
}

This will register the options screen we call options.html, and we tell it not to open a new tab. (this will open it in a popup).

This options file will become a new app and run separately from our existing one. Create your project’s options.html file and add the following code.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
    <title>DDT Pop-up</title>
    <link rel="stylesheet" type="text/css" href="./css/style.css" />
  </head>
  <body>
    <div id="options"></div>
    <script type="module" src="src/options/index.jsx"></script>
  </body>
</html>

Let’s go ahead and create this options folder in our src directory, and inside create the index.jsx file.

import ReactDOM from 'react-dom';
import { App } from './App';

const app = document.getElementById('options');
ReactDOM.render(<App />, app);

As you can see, this is just another React bootstrap file. Let’s go ahead and create the options App.jsx file.

import { useState } from 'react';

export function App() {
  const [color, setColor] = useState('indigo');

  chrome.storage.sync.get('color', (storedColor) => {
    setColor(storedColor.color);
  });

  const pickColor = (pickedValue) => {
    setColor(pickedValue);
    chrome.storage.sync.set({ color: pickedValue });
    window.close();
  };

  return (
    <div className='m-4'>
      <select
        onChange={(event) => pickColor(event.target.value)}
        value={color}
        className='block w-full p-4 text-sm text-gray-900 border border-gray-300 rounded-lg bg-gray-50 focus:ring-indigo-500 focus:border-indigo-500 dark:bg-gray-700 dark:border-gray-600 dark:placeholder-gray-400 dark:text-white dark:focus:ring-indigo-500 dark:focus:border-indigo-500'
      >
        <option>Pick a color</option>
        <option value='indigo'>Indigo</option>
        <option value='pink'>Pink</option>
        <option value='purple'>Purple</option>
        <option value='red'>Red</option>
      </select>
    </div>
  );
}

This code came from the main App.jsx file, so go ahead and remove the select option from that.

We need to register this new entry point in our Vite config, so Vite knows it should create two files. Open your vite.config.js file and place the following config in it.

import { defineConfig } from 'vite';
const { resolve } = require('path');
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  build: {
    rollupOptions: {
      input: {
        main: resolve(__dirname, 'index.html'),
        options: resolve(__dirname, 'options.html'),
      },
    },
  },
});

Now Vite knows it’s a multi-app project. The last thing we want to do is modify our tailwind.config.js file as we now use subfolders.

/** @type {import('tailwindcss').Config} */
module.exports = {
  // Old
  content: ['src/*.jsx'],
  // New
  content: ['src/**/*.jsx'],
};

And that’s it. You can now go ahead and build your application. The user will now be able to modify the color through the options menu.

You can find the complete code in this GitHub branch.

Thank you for reading, and let’s connect!

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter

Spread the knowledge with fellow developers on Twitter
Tweet this tip
Powered by Webmentions - Learn more

Read next 📖

Browser extensions - recap and status

1 Sep, 2022 · 2 min read

Browser extensions - recap and status

Browser extensions - DevTools extension

31 Aug, 2022 · 2 min read

Browser extensions -  DevTools extension

Join 2099 devs and subscribe to my newsletter