DevTools/Developer Edition Theme: Difference between revisions

Add bug reporting section
(Initial information about the implementation of the Developer Edition theme)
 
(Add bug reporting section)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
The Developer Edition Theme is implemented as a lightweight theme, but it's different from others in a few ways.
The Developer Edition Theme is implemented as a lightweight theme, so it is affected by changes in the default theme.  It's different from lightweight themes in a few ways:


1. Rather than being installed separately, it is bundled with the browser using [https://github.com/mozilla/gecko-dev/blob/c0f04387c3fd376c453764312a8d41e577bf2d1a/browser/components/nsBrowserGlue.js#L800 LightweightThemeManager.addBuiltInTheme]. Because of this, it's only available (for now) in the Nightly and Developer Edition channels (see [https://bugzilla.mozilla.org/show_bug.cgi?id=1181721 Bug 1181721] for more information).
# Rather than being installed separately, it is bundled with the browser using [https://github.com/mozilla/gecko-dev/blob/c0f04387c3fd376c453764312a8d41e577bf2d1a/browser/components/nsBrowserGlue.js#L800 LightweightThemeManager.addBuiltInTheme].
 
#* Because of this, it's only available (for now) in the Nightly and Developer Edition channels - see [https://bugzilla.mozilla.org/show_bug.cgi?id=1181721 Bug 1181721] for more information.
2. It has an extra stylesheet that's loaded when it's applied - see the CSS Section for more information.  This gives it more control than other lightweight themes, which allows it to override a number of CSS variables and other styles.
# It has an extra stylesheet that's loaded when it's applied - see the CSS Section for more information.  This gives it more control than other lightweight themes, which allows it to override a number of CSS variables and other styles.
 
# It changes colors when the DevTools theme changes.  By default in Developer Edition, the DevTools theme is dark.  In Nightly (or local builds) the DevTools theme defaults to light.  This is controlled by the devtools.theme pref.
3. It changes colors when the DevTools theme changes.  By default in Developer Edition, the DevTools theme is dark.  In Nightly (or local builds) the DevTools theme defaults to light.  This is controlled by the devtools.theme pref.
#* Note that there aren't many breakages due simply color changes, since this is typically just changing some variable values to match light or dark colors.  But it's still worth checking the dark theme in particular if there are new hardcoded colors being added to the default theme.
 
== How To Apply ==
 
It's easy to test changes to the Developer Edition theme.  You can apply the theme by selecting it from Addons Manager -> Appearance, or from Customize mode.


== CSS ==
== CSS ==
Line 20: Line 16:
* https://dxr.mozilla.org/mozilla-central/source/browser/themes/osx/devedition.css
* https://dxr.mozilla.org/mozilla-central/source/browser/themes/osx/devedition.css
* https://dxr.mozilla.org/mozilla-central/source/browser/themes/windows/devedition.css
* https://dxr.mozilla.org/mozilla-central/source/browser/themes/windows/devedition.css
== Reporting Bugs ==
See a bug in the Developer Edition theme?  Please file a bug in the [https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox&component=Theme Firefox::Theme component] (and thank you).
== How To Apply ==
It's very helpful if you can test changes to the default theme in the Developer Edition theme, to avoid regressions.  It's easy to apply.  You can apply the theme by selecting it from <code>about:addons -> Appearance</code>, or from Customize mode.
[[File:DevEdition-Addons-Manager.png|600px|thumbnail|center]]
[[File:DevEdition-Theme-Applied.png|600px|thumbnail|center]]
[[File:DevEdition-Switch-Colors.png|600px|thumbnail|center]]
Confirmed users
66

edits