View source for Template:If dark/doc

{{Documentation subpage}}
{{Uses TemplateStyles|Template:If dark/styles.css}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
This template detects whether it is being used with dark mode, and displays different content accordingly. This should however NOT be relied upon. For instance: It may not work with the [[Wikipedia:Dark mode (gadget)|dark mode gadget]]. You can use the [https://developer.mozilla.org/en-US/docs/Web/CSS/background-image background-image] property with a URL inside [[Wikipedia:TemplateStyles|TemplateStyles]] with different versions for dark mode and light mode instead.

==Rationale==
Some images and text need to be different depending on the mode selected by the user. This template provides an easy way to do that.
== Usage ==
<code>{{braces|If dark{{!}}''content for dark mode''{{!}}''content for light mode''}}</code>

By default, {{tag|span}} tags are used to wrap the specified content. A different tag may be specified using {{para|tag}}
:E.g. {{para|tag|div}} can be used if the content contains block-level elements.

== Notes ==
* This template will only work with Wikipedia's official dark theme. It will not work with browser extensions such as Dark Reader or [[Wikipedia:Dark mode (gadget)|the dark mode gadget]], due to relying on the <code>&lt;html&gt;</code> tag having the <code>.skin-theme-clientpref-night</code> class.

* This template <em>does not</em> actually switch the content between the light and dark mode; it simply outputs both, and hides the content for the opposite theme using CSS.

==Example==
===Normal usage===
<code><nowiki>{{If dark|You are using dark mode!|You are using light mode!}}</nowiki></code> yields:
{{lightdarkcompare|{{If dark|You are using dark mode!|You are using light mode!}}}}

{{Namespace and pagename-detecting templates|state=collapsed}}

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Wikipedia templates that change text based on client state]]
[[Category:If-then-else templates]]
[[Category:Wikipedia formatting templates ]]
}}</includeonly>