mirror of
https://github.com/picocss/pico.git
synced 2025-04-20 08:45:06 -04:00
feat: better color schemes doc
This commit is contained in:
Lucas Larroche
parent
ca33729c5e
commit
672b67896c
2 changed files with 87 additions and 25 deletions
|
|
@ -1,64 +1,123 @@
|
|||
<!doctype html>
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
${require('./_head.html')
|
||||
title=`Themes`
|
||||
description=`Pico is shipped with 2 consistent themes: Light & Dark. The Light theme is used by default. The Dark theme is automatically enabled if the user has dark mode enabled ('prefers-color-scheme: dark').`
|
||||
canonical=`themes.html`
|
||||
}
|
||||
${require('./_head.html') title=`Themes` description=`Pico is shipped with 2
|
||||
consistent themes: Light & Dark. The Light theme is used by default. The
|
||||
Dark theme is automatically enabled if the user has dark mode enabled
|
||||
('prefers-color-scheme: dark').` canonical=`themes.html` }
|
||||
</head>
|
||||
|
||||
<body>
|
||||
${require('./_nav.html')}
|
||||
|
||||
|
||||
<main class="container" id="docs">
|
||||
${require('./_sidebar.html') active=`themes-link`}
|
||||
|
||||
|
||||
<div role="document">
|
||||
<section id="themes">
|
||||
<hgroup>
|
||||
<h1>Themes</h1>
|
||||
<h2>Pico is shipped with 2 consistent themes: Light & Dark.</h2>
|
||||
</hgroup>
|
||||
<p>The Light theme is used by default. The Dark theme is automatically enabled if the user has dark mode enabled <code><i>prefers-color-scheme</i>: <u>dark</u></code></p>
|
||||
<p>
|
||||
The Light theme is used by default. The Dark theme is automatically
|
||||
enabled if the user has dark mode enabled
|
||||
<code><i>prefers-color-scheme</i>: <u>dark</u></code>
|
||||
</p>
|
||||
<article aria-label="Theme switcher">
|
||||
<button class="contrast theme-switcher">…</button>
|
||||
</article>
|
||||
<p>Themes can be forced on document level <code><<b>html</b> <i>data-theme</i>=<u>"light"</u>></code> or on any HTML element <code><<b>article</b> <i>data-theme</i>=<u>"dark"</u>></code></p>
|
||||
<p>
|
||||
Color schemes can be defined for the entire document using
|
||||
<code><<b>html</b> <i>data-theme</i>=<u>"light"</u>></code> or
|
||||
for specific HTML elements, such as
|
||||
<code><<b>article</b> <i>data-theme</i>=<u>"dark"</u>></code>.
|
||||
</p>
|
||||
<p>
|
||||
Color schemes at the HTML tag level work great for elements such as
|
||||
<code>a</code>, <code>button</code>, <code>table</code>,
|
||||
<code>input</code>, <code>textarea</code>, <code>select</code>,
|
||||
<code>article</code>, <code>dialog</code>, <code>progress</code>.
|
||||
</p>
|
||||
<p>
|
||||
CSS variables specific to the color scheme are assigned to every
|
||||
HTML tag. However, to maintain transparent backgrounds and ensure
|
||||
colors are inherited from the parent tag, we have not enforced
|
||||
specific background and color settings across all HTML tags.
|
||||
</p>
|
||||
<p>
|
||||
For some other HTML tags, you might need to explicitly specify
|
||||
<code>background-color</code> and <code>color</code>.
|
||||
</p>
|
||||
<article data-theme="light" aria-label="Forced light theme example">
|
||||
<h3>Light theme</h3>
|
||||
<form class="grid">
|
||||
<input type="text" name="login" placeholder="Login" aria-label="Login" autocomplete="nickname" required>
|
||||
<input type="password" name="password" placeholder="Password" aria-label="Password" autocomplete="current-password" required>
|
||||
<button type="submit" aria-label="Example button" onclick="event.preventDefault()">Login</button>
|
||||
<input
|
||||
type="text"
|
||||
name="login"
|
||||
placeholder="Login"
|
||||
aria-label="Login"
|
||||
autocomplete="nickname"
|
||||
required
|
||||
/>
|
||||
<input
|
||||
type="password"
|
||||
name="password"
|
||||
placeholder="Password"
|
||||
aria-label="Password"
|
||||
autocomplete="current-password"
|
||||
required
|
||||
/>
|
||||
<button
|
||||
type="submit"
|
||||
aria-label="Example button"
|
||||
onclick="event.preventDefault()"
|
||||
>
|
||||
Login
|
||||
</button>
|
||||
</form>
|
||||
<footer class="code">
|
||||
|
||||
<pre><code><<b>article</b> <i>data-theme</i>=<u>"light"</u>>
|
||||
<pre><code><<b>article</b> <i>data-theme</i>=<u>"light"</u>>
|
||||
…
|
||||
</<b>article</b>></code></pre>
|
||||
|
||||
</footer>
|
||||
</article>
|
||||
<article data-theme="dark" aria-label="Forced dark theme example">
|
||||
<h3>Dark theme</h3>
|
||||
<form class="grid">
|
||||
<input type="text" name="login" placeholder="Login" aria-label="Login" autocomplete="nickname" required>
|
||||
<input type="password" name="password" placeholder="Password" aria-label="Password" autocomplete="current-password" required>
|
||||
<button type="submit" aria-label="Example button" onclick="event.preventDefault()">Login</button>
|
||||
<input
|
||||
type="text"
|
||||
name="login"
|
||||
placeholder="Login"
|
||||
aria-label="Login"
|
||||
autocomplete="nickname"
|
||||
required
|
||||
/>
|
||||
<input
|
||||
type="password"
|
||||
name="password"
|
||||
placeholder="Password"
|
||||
aria-label="Password"
|
||||
autocomplete="current-password"
|
||||
required
|
||||
/>
|
||||
<button
|
||||
type="submit"
|
||||
aria-label="Example button"
|
||||
onclick="event.preventDefault()"
|
||||
>
|
||||
Login
|
||||
</button>
|
||||
</form>
|
||||
<footer class="code">
|
||||
|
||||
<pre><code><<b>article</b> <i>data-theme</i>=<u>"dark"</u>>
|
||||
<pre><code><<b>article</b> <i>data-theme</i>=<u>"dark"</u>>
|
||||
…
|
||||
</<b>article</b>></code></pre>
|
||||
|
||||
</footer>
|
||||
</article>
|
||||
</section>
|
||||
|
||||
${require('./_footer.html')}
|
||||
|
||||
</div>
|
||||
</main>
|
||||
<script src="js/commons.min.js"></script>
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
Loading…
Add table
Add a link
Reference in a new issue