Українська
Tailwind CSS і тема
Крок 1. Tailwind CSS v4
Навіщо. У Chatex немає файлів стилів компонентів. Кожен елемент стилізується утилітними класами у своєму шаблоні: flex items-center gap-2 rounded-lg px-4 говорить те саме, що сказало б правило таблиці стилів, – просто там, де розташований елемент. Tailwind CSS генерує рівно ті класи, що їх використовує вихідний код, тому таблиця стилів лишається невеликою (близько 10 кБ наприкінці цієї теми). Альтернативи – бібліотека компонентів на кшталт Angular Material або CSS, написаний вручну для кожного компонента, – або нав’язують вигляд, або розкидають дизайн по багатьох файлах.
Tailwind v4 налаштовується в CSS, а не в файлі JavaScript. Він працює як плагін PostCSS, який збирання Angular підхоплює з .postcssrc.json.
Що зробити. ng new --style tailwind уже записав конфігурацію PostCSS; замініть її, щоб отримати кінці рядків LF і фінальний перенос рядка:
json
{
"plugins": {
"@tailwindcss/postcss": {}
}
}Крок 2. Токени, утиліти й темний режим
Навіщо. Дизайн – це невеликий набір рішень: кольори, шрифт, відступи, кілька повторюваних компонентів на зразок кнопок і полів введення. Якщо тримати їх в одній таблиці стилів, їх можна змінювати в одному місці, а шаблони говорять назвами (btn-primary, bg-surface), а не сирими значеннями.
Що зробити. Замініть src/styles.css:
css
@import 'tailwindcss';
/* Dark mode is class based so the user can override the OS setting (see ThemeService). */
@custom-variant dark (&:where(.dark, .dark *));
@theme {
--font-sans:
'Inter', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', Arial,
sans-serif;
--color-brand-50: oklch(96.2% 0.018 272.314);
--color-brand-100: oklch(93% 0.034 272.788);
--color-brand-200: oklch(87% 0.065 274.039);
--color-brand-300: oklch(78.5% 0.115 274.713);
--color-brand-400: oklch(67.3% 0.182 276.935);
--color-brand-500: oklch(58.5% 0.233 277.117);
--color-brand-600: oklch(51.1% 0.262 276.966);
--color-brand-700: oklch(45.7% 0.24 277.023);
--color-brand-800: oklch(39.8% 0.195 277.366);
--color-brand-900: oklch(35.9% 0.144 278.697);
--color-brand-950: oklch(25.7% 0.09 281.288);
}
/* Semantic surface tokens that switch with the theme: bg-canvas, bg-surface, bg-subtle, border-line, text-fg, text-muted. */
@theme inline {
--color-canvas: var(--c-canvas);
--color-surface: var(--c-surface);
--color-subtle: var(--c-subtle);
--color-line: var(--c-line);
--color-fg: var(--c-fg);
--color-muted: var(--c-muted);
--color-bubble: var(--c-bubble);
}
:root {
color-scheme: light;
--c-canvas: oklch(96.7% 0.001 286.375);
--c-surface: oklch(100% 0 0);
--c-subtle: oklch(96.7% 0.001 286.375);
--c-line: oklch(92% 0.004 286.32);
--c-fg: oklch(21% 0.006 285.885);
--c-muted: oklch(55.2% 0.016 285.938);
--c-bubble: oklch(100% 0 0);
}
.dark {
color-scheme: dark;
--c-canvas: oklch(14.1% 0.005 285.823);
--c-surface: oklch(21% 0.006 285.885);
--c-subtle: oklch(27.4% 0.006 286.033);
--c-line: oklch(27.4% 0.006 286.033);
--c-fg: oklch(96.7% 0.001 286.375);
--c-muted: oklch(70.5% 0.015 286.067);
--c-bubble: oklch(27.4% 0.006 286.033);
}
@layer base {
html,
body {
height: 100%;
}
body {
@apply bg-canvas text-fg antialiased;
-webkit-tap-highlight-color: transparent;
}
:focus-visible {
@apply outline-2 outline-offset-2 outline-brand-500;
}
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
animation-duration: 0.01ms !important;
transition-duration: 0.01ms !important;
scroll-behavior: auto !important;
}
}
}
@utility btn {
@apply inline-flex min-h-10 items-center justify-center gap-2 rounded-lg px-4 text-sm font-medium transition-colors select-none disabled:cursor-not-allowed disabled:opacity-50;
}
@utility btn-primary {
@apply btn bg-brand-600 text-white hover:bg-brand-700 active:bg-brand-800;
}
@utility btn-secondary {
@apply btn border border-line bg-surface text-fg hover:bg-subtle;
}
@utility btn-ghost {
@apply btn text-fg hover:bg-subtle;
}
@utility btn-danger {
@apply btn bg-red-600 text-white hover:bg-red-700;
}
@utility icon-btn {
@apply inline-flex size-10 shrink-0 items-center justify-center rounded-full text-muted transition-colors hover:bg-subtle hover:text-fg disabled:opacity-40;
}
@utility input {
/* 16px text on phones stops iOS Safari from zooming into focused fields. */
@apply block w-full rounded-lg border border-line bg-surface px-3 py-2 text-base text-fg placeholder:text-muted focus:border-brand-500 focus:ring-2 focus:ring-brand-500/30 focus:outline-none sm:text-sm;
}
@utility input-invalid {
@apply border-red-500 focus:border-red-500 focus:ring-red-500/30;
}
@utility label {
@apply mb-1 block text-sm font-medium text-fg;
}
@utility field-error {
@apply mt-1 text-xs text-red-600 dark:text-red-400;
}
@utility card {
@apply rounded-2xl border border-line bg-surface;
}
@utility badge {
@apply inline-flex min-w-5 items-center justify-center rounded-full px-1.5 text-[11px] leading-5 font-semibold;
}
@utility menu {
@apply min-w-44 overflow-hidden rounded-xl border border-line bg-surface py-1 shadow-lg;
}
@utility menu-item {
@apply flex w-full items-center gap-3 px-3 py-2 text-left text-sm text-fg hover:bg-subtle focus:bg-subtle focus:outline-none;
}
.cdk-overlay-dark-backdrop {
background: rgb(0 0 0 / 0.45);
}
.pt-safe {
padding-top: env(safe-area-inset-top);
}
.pb-safe {
padding-bottom: env(safe-area-inset-bottom);
}
@utility dialog-card {
@apply max-h-[calc(100dvh-2rem)] w-[min(32rem,calc(100vw-1.5rem))] overflow-y-auto rounded-2xl border border-line bg-surface text-fg shadow-xl;
}
/* CDK dialog panes: let the card decide its width. */
.app-dialog-panel {
max-width: 100vw;
}Згори донизу:
@import 'tailwindcss'підтягує Tailwind: його скидання стилів (preflight), його тему й генератор утиліт.@custom-variant darkперевизначає префіксdark:. Типовоdark:стежить за операційною системою (prefers-color-scheme); тут він діє всередині елемента з класомdark. Тоді користувач може вибрати світлу, темну або системну тему в налаштуваннях (тема 21), аThemeService(наступний розділ) ставить клас на<html>.@themeдодає токени дизайну. Кожна змінна--color-brand-*створює ціле сімейство утиліт:bg-brand-600,text-brand-700,ring-brand-500/30і так далі. Значення – кольори OKLCH (світлота, насиченість, відтінок), колірний простір власної палітри Tailwind v4; фірмовий колір – індиго.--font-sansзадає типовий набір шрифтів.@theme inlineдодає семантичні токениcanvas,surface,subtle,line,fg,mutedіbubble. Їхні значення – змінні CSS (--c-*), визначені двічі: у:rootдля світлої теми й у.darkдля темної. Шаблон один раз пишеbg-surface text-fgі отримує правильні кольори в обох темах, без варіантаdark:на кожному елементі.inlineзмушує утиліти використовуватиvar(--c-surface)безпосередньо, тож вони йдуть за змінною, коли з’являється класdark.color-schemeкаже браузеру малювати власні елементи керування (смуги прокручування, вибір дати) у відповідній темі.@layer baseстилізує саму сторінку: повну висоту, колір тла, помітну рамку фокуса для користувачів клавіатури й майже повну відсутність анімації для тих, хто попросив у системі зменшити рух.@utilityвизначає наші власні утиліти з наявних за допомогою@apply:btn,btn-primary,btn-secondary,btn-ghost,btn-danger,icon-btn,input,input-invalid,label,field-error,card,badge,menu,menu-itemіdialog-card. Вони поводяться як власні утиліти Tailwind: працюють із варіантами (hover:,md:), а плагін Tailwind для Prettier їх знає, тому.prettierrcвказує на цей файл.inputвикористовує текст 16 px на телефонах (text-base, потімsm:text-sm): iOS Safari збільшує масштаб до будь-якого поля у фокусі, якщо шрифт менший.- Прості правила наприкінці стилізують елементи, які створює Angular CDK (тло й панель діалогу, тема 17), і додають
pt-safe/pb-safe– відступи для виїмки й індикатора «Додому» на телефонах (env(safe-area-inset-*)).
Перевірка
powershell
npm run buildзавершується успішно, а рядок на зразок styles-EJGLXUFW.css | styles | 10.44 kB показує згенеровану таблицю стилів (ім’я містить хеш вмісту, а розмір залежить від класів, що їх використовують шаблони). Якщо ви помилитеся в написанні утиліти всередині @apply, збирання завершиться повідомленням на кшталт Cannot apply unknown utility class `min-h-10` .
Крок 3. Сторінка, її піктограми та скрипт теми
Навіщо. index.html – єдина справжня сторінка HTML; Angular відображає все інше у своєму елементі <app-root>. Три деталі потребують уваги:
- Піктограми. Браузери й телефони запитують кілька форматів піктограм:
.icoдля старих браузерів, SVG, що вміє пристосовуватися до темної теми, PNG для домашнього екрана iOS і PNG-піктограми маніфесту вебзастосунку для «Додати на головний екран» в Android. - Тема до першого відображення. Angular стартує лише після завантаження свого пакета JavaScript. Якби темну тему застосовував Angular, користувач із темною темою бачив би білий спалах під час кожного завантаження. Крихітний скрипт у
<head>має встановити класdarkдо того, як сторінку буде намальовано. - Жодних вбудованих скриптів. Цей крихітний скрипт не можна написати всередині
index.html: виробнича політика Content-Security-Policyscript-src 'self'(тема 24) блокує вбудовані скрипти, а це головний захист від міжсайтового скриптингу. Тому він – окремий файл уpublic/.
Що зробити. Скопіюйте піктограми з еталона – це двійкові файли, – замінивши створений favicon.ico:
powershell
Copy-Item D:\Work\Chatex-Reference\Source\Chatex.Web\public\*.png, D:\Work\Chatex-Reference\Source\Chatex.Web\public\favicon.ico public -ForceСтворіть векторну піктограму, маніфест і скрипт теми:
svg
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
<style>
@media (prefers-color-scheme: dark) {
.tile { fill: #615fff; }
}
</style>
<rect class="tile" width="32" height="32" rx="8" fill="#4f39f6" />
<path d="M21.66 9.84A8 8 0 1 0 21.66 21.16" fill="none" stroke="#fff" stroke-width="4" stroke-linecap="round" />
<path d="M9.6 19.2 7.5 27l7.6-3.4z" fill="#fff" />
</svg>json
{
"name": "Chatex",
"short_name": "Chatex",
"description": "Chatex — team chat and messenger",
"start_url": "/",
"scope": "/",
"display": "standalone",
"theme_color": "#4f46e5",
"background_color": "#ffffff",
"icons": [
{ "src": "icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any" },
{ "src": "icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any" },
{
"src": "icon-maskable-512.png",
"sizes": "512x512",
"type": "image/png",
"purpose": "maskable"
}
]
}js
// Apply the saved theme before the first paint so dark mode doesn't flash white.
// A file rather than an inline script, so the Content-Security-Policy can stay script-src 'self'.
(function () {
try {
var t = localStorage.getItem('chatex.theme') || 'system';
var dark =
t === 'dark' || (t === 'system' && matchMedia('(prefers-color-scheme: dark)').matches);
document.documentElement.classList.toggle('dark', dark);
} catch (e) {}
})();favicon.svgмає власний медіазапит: у темному браузері плитка – світліший індиго.site.webmanifestназиває застосунок, задаєdisplay: standalone(без панелі браузера, коли запущено з домашнього екрана) і перелічує піктограми; маскована піктограма має безпечну зону, щоб Android міг обрізати її колом або «сквіркулом».theme-init.jsчитає збережений вибір за ключемchatex.theme– тим самим, який записуєThemeService, – і перемикає класdark. Це звичайний JavaScript у негайно викликаній функції, тож її змінні не потрапляють на сторінку, аtry/catchпокриває браузери, деlocalStorageзаблоковано.
Усе, що лежить у public/, копіюється у вихідну папку без змін (параметр assets в angular.json) і віддається з кореня сайту.
Замініть src/index.html:
html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>Chatex</title>
<base href="/" />
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
<meta name="description" content="Chatex — team chat and messenger" />
<meta name="theme-color" content="#4f46e5" />
<link rel="icon" href="favicon.ico" sizes="48x48" />
<link rel="icon" href="favicon.svg" type="image/svg+xml" />
<link rel="apple-touch-icon" href="apple-touch-icon.png" />
<link rel="manifest" href="site.webmanifest" />
<script src="theme-init.js"></script>
</head>
<body>
<app-root></app-root>
<noscript>Chatex needs JavaScript. Please enable it in your browser.</noscript>
</body>
</html>viewport-fit=coverдозволяє сторінці заходити під виїмку;pt-safeіpb-safeтоді додають потрібні відступи.theme-colorфарбує панель браузера на телефонах;ThemeServiceперемикає його на темно-сірий у темній темі.<script src="theme-init.js">в<head>виконується до малювання тіла сторінки. Це навмисне класичний блокувальний скрипт: він займає кілька сотень байтів і має завершитися до першого відображення.<noscript>пояснює порожню сторінку браузеру без JavaScript.
Перевірка
powershell
npm run buildзавершується успішно, а dist/chatex/browser тепер містить theme-init.js, site.webmanifest і піктограми поруч із index.html.