Manifest theme key update (mdn#16568)

* Manifest theme key update * Release note clarification
teoli2003 · May 26, 2022 · 725bf66 · 725bf66
1 parent ce7f155
commit 725bf66
Show file tree

Hide file tree

Showing 2 changed files with 48 additions and 2 deletions.
diff --git a/files/en-us/mozilla/add-ons/webextensions/manifest.json/theme/index.md b/files/en-us/mozilla/add-ons/webextensions/manifest.json/theme/index.md
@@ -1405,7 +1405,7 @@ Additionally, this key accepts various properties that are aliases for one of th
   <p><code>Array</code> of <code>String</code></p>
   </td>
   <td>
-  <p>Optional.</p>
+  <p>Optional</p>
   <p>
   An array of enumeration values defining the alignment of the
   corresponding <code>"additional_backgrounds":</code> array item.<br />The
@@ -1436,7 +1436,7 @@ Additionally, this key accepts various properties that are aliases for one of th
   <p><code>Array</code> of <code>String</code></p>
   </td>
   <td>
-  <p>Optional.</p>
+  <p>Optional</p>
   <p>
   An array of enumeration values defining how the corresponding
   <code>"additional_backgrounds":</code> array item repeats. Options
@@ -1451,6 +1451,48 @@ Additionally, this key accepts various properties that are aliases for one of th
   <p>If not specified, defaults to <code>"no-repeat"</code>.</p>
   </td>
  </tr>
+ <tr>
+  <td><code>color_scheme</code></td>
+  <td>
+  <p><code>String</code></p>
+  </td>
+  <td>
+  <p>Optional</p>
+  <p>
+  Determines which color scheme is applied to the chrome (for example, context menus) 
+  and content (for example, built-in pages and the preferred color scheme for web pages). 
+  Options include:
+  </p>
+  <ul>
+  <li><code>"auto"</code> – a light or dark scheme based automatically on the theme.</li>
+  <li><code>"light"</code> – a light scheme.</li>
+  <li><code>"dark"</code> – a dark scheme.</li>
+  <li><code>"system"</code> – uses the system scheme.</li>
+  </ul>
+  <p>If not specified, defaults to <code>"auto"</code>.</p>
+  </td>
+ </tr>
+ <tr>
+  <td><code>content_color_scheme</code></td>
+  <td>
+  <p><code>String</code></p>
+  </td>
+  <td>
+  <p>Optional</p>
+  <p>
+  Determines which color scheme is applied to the content (for example, built-in pages and 
+  preferred color scheme for web pages). Overrides <code>color_scheme</code>. Options
+  include:
+  </p>
+  <ul>
+  <li><code>"auto"</code> – a light or dark scheme based automatically on the theme.</li>
+  <li><code>"light"</code> – a light scheme.</li>
+  <li><code>"dark"</code> – a dark scheme.</li>
+  <li><code>"system"</code> – the system scheme.</li>
+  </ul>
+  <p>If not specified, defaults to <code>"auto"</code>.</p>
+  </td>
+ </tr>
  </tbody>
 </table>
 

diff --git a/files/en-us/mozilla/firefox/releases/100/index.md b/files/en-us/mozilla/firefox/releases/100/index.md
@@ -49,6 +49,10 @@ No notable changes.
 
 - Added support for user prompts (e.g. `alert`) on Android ({{bug(1708105)}}).
 
+## Changes for add-on developers
+
+- The `color_scheme` and `content_color_scheme` properties are added to [theme](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme) manifest key and available in the{{WebExtAPIRef("theme")}} API. These properties enable a theme to override whether a light or dark color scheme is automatically applied to the chrome or content. ({{bug(1708105)}})
+
 ## Older versions
 
 {{Firefox_for_developers(99)}}