int-components
v0.8.17
Published
Рейтхочные компоненты. Storybook https://int-components.s3.amazonaws.com/int-components/master/index.html
Readme
Promo components
Рейтхочные компоненты. Storybook https://int-components.s3.amazonaws.com/int-components/master/index.html
Содержание
Подключение компонентов
Компоненты RateHawk (rh-components/*)
Для компонентов RateHawk провайдер не принимает проп с темой и автоматически подключает нужные шрифты (Aeonik и ABCGravity).
Пример использования в Astro
Layout.astro:
---
import { ThemeProvider } from "int-components/themes/ratehawk";
import "int-components/index.css"; // Импорт всех стилей, опционально
---
<html lang="en">
<ThemeProvider>
...
</ThemeProvider>
</html>Header.astro:
---
// Можно импортировать не все стили, а только нужные
import "int-components/rh-components/Header/index.css";
import Header from "int-components/rh-components/Header";
---
<Header
client:load
menu={[
{ title: "Пункт 1" },
{
title: "Пункт 2",
onClick: () => {
alert('test');
},
},
]}
/>ThemeProvider автоматически подключает шрифты Aeonik и ABCGravity. Можно убрать отдельные font-face из проекта.
Юбилейный логотип в шапке
Проп withAnniversaryLogo заменяет логотип в шапке RateHawk на юбилейный («10»). По умолчанию выключен.
<Header client:load theme="black" withAnniversaryLogo />От 1400px логотип показывается со слоганом «SUPERCHARGING TRAVEL», до 1399px — без него. Цвета берутся из темы
шапки, как у обычного логотипа: в black он бело-жёлтый, в yellow и white — чёрный. Ссылка с логотипа не меняется.
Компоненты ETG (etg-components/*)
У бренда ETG своя тема — она подключает Aeroport (400 и 500) и токены бренда, но не тащит шрифты RateHawk (Aeonik, ABCGravity).
---
import { ThemeProvider } from "int-components/themes/etg";
import "int-components/index.css"; // Импорт всех стилей, опционально
---
<html lang="en">
<ThemeProvider>
...
</ThemeProvider>
</html>Провайдер обязателен. Вся вёрстка компонентов размечена в em относительно
.int-component-root { font-size: 1px }, а это правило (как и @font-face, и токены бренда) живёт в теме.
Без провайдера размеры и цвета разъедутся, даже если импортировать стили компонента напрямую.
Темы можно мешать на одной странице (например, шапка RateHawk + ETG-компоненты в теле): общий блок с флюидной типографикой у них идентичный, а наборы шрифтов не конфликтуют. Но лучше монтировать по одному провайдеру на бренд в корне лейаута.
Компоненты остальных брендов (<бренд>-components/*)
У каждого международного бренда своя папка, даже если в ней пока один компонент — футер. Своей темы
у этих брендов нет: футер рисуется в shadow root и в ThemeProvider не нуждается.
| Бренд | Папка |
| ------------ | ------------------------- |
| RateHawk | rh-components |
| ETG | etg-components |
| ZenHotels | zen-components |
| Roundtrip | rt-components |
| Extranet ETG | extranet-int-components |
Имена папок — <slug бренда>-components, где slug — из @mrktg/int-brands;
так же называются папки сборок в репозитории live-footer
(footers/<slug>). Slug не меняется вместе с id: id полные (ratehawk, zenhotels, roundtrip), а пути
уже опубликованы.
---
import Footer from "int-components/zen-components/Footer";
---
<Footer lang="de" />Общие компоненты (components/*)
Компоненты без привязки к бренду. Сейчас это Footer — он умеет рисовать футер любого международного
бренда, поэтому лежит не в rh-components. Подключение — см. раздел «Футер».
Импорт стилей
Вариант 1: Импорт всех стилей
import "int-components/index.css";Вариант 2: Импорт стилей отдельных компонентов
import "int-components/rh-components/Button/index.css";
import "int-components/rh-components/Header/index.css";Важно для SSR: Импорт CSS файлов необходим для избежания CLS (Cumulative Layout Shift) при серверном рендеринге.
CSS будет включен в <head> при SSR, и стили применятся мгновенно.
Оптимизация: Не беспокойтесь о дублирующихся импортах! Astro (Vite) автоматически дедуплицирует CSS — если вы
импортируете один и тот же файл стилей в нескольких компонентах, он будет включен в финальную сборку только один раз.
Поэтому безопасно импортировать стили компонента в каждом .astro файле, где он используется.
Флюидная вёрстка
Флюидная вёрстка привязывает размеры к ширине окна: компоненты масштабируются вместе с остальной страницей.
Алгоритм пакет не считает — он лежит в отдельном репозитории clamp-scaling и раздаётся с S3. Проект
подключает два файла сам, в <head> страницы (у брендов Островка те же файлы лежат на Selectel — урлы см.
в репозитории clamp-scaling):
<link rel="stylesheet" href="https://im.worldota.net/clamp-scaling/v1/media.css" />
<link rel="stylesheet" href="https://im.worldota.net/clamp-scaling/v1/base.css" />base.css ставит плавающий font-size на html и включает флюидный режим у наших компонентов правилом
.component-root[class]:not(.disable-clamp-scaling) { font-size: 1rem }. Специфичность у него выше, чем
у базового правила темы, поэтому порядок подключения не важен.
Отсюда следствия:
- файлы подключены — компоненты флюидные, ничего дополнительно включать не нужно;
- файлы не подключены — компоненты рендерятся в фиксированных px, ровно как в макете; страница не ломается;
- отключить флюид точечно — класс
disable-clamp-scalingна корне компонента:<Button className="disable-clamp-scaling" />. Класс работает на самом элементе, а не на потомках, поэтому его надо ставить каждому компоненту, который должен остаться фиксированным.
base.css вешает font-size на html глобально: если флюид нужен не на всех страницах, подключайте файлы
только на нужных, а не в общий layout. Если в проекте настроен CSP, хост файлов нужно добавить в style-src.
Посмотреть оба состояния можно в Storybook — тумблер Clamp scaling рядом с верхним меню подключает и отключает
base.css. Сам сторибук берёт файлы не с CDN, а из бакета (int-marketing.s3.amazonaws.com), чтобы правки
в clamp-scaling было видно сразу, а не через восемь часов кэша.
Цены отелей в HotelsSection
Если у отеля задан master_id, секция сама подтягивает цену из ручки «бездатных» цен
(POST /hotel/search/v1/dateless/prices/hotels, один запрос на всю секцию) и игнорирует
переданный price. Пока цена едет — на месте кнопки спиннер; если запрос не удался или
превысил таймаут, карточка показывает CTA.
<HotelsSection hotels={hotels} currency="USD" />Урл по умолчанию относительный, без хоста: запрос уходит на тот же домен, что и страница,
поэтому он same-origin и CORS не нужен. Это работает на брендовых хостах, но не работает
там, где страница лежит на чужом домене — в сторибуке (локально и на S3-стенде) и в конструкторе
лендингов. Для таких мест есть прокси маркетинга с Access-Control-Allow-Origin: *:
<HotelsSection hotels={hotels} currency="USD" useProxy />Прокси доступен только из внутренней сети, поэтому нужен VPN — и поэтому его нельзя включать
в проде: у посетителя лендинга его не будет. Живёт он в репозитории
marketing-proxy; там же добавляются
новые ручки. Тот же проп есть у SearchForm — её саджест ходит на такой же относительный урл
и вне брендового хоста упирается в тот же CORS:
<SearchForm client:load host="https://www.ratehawk.com" useProxy />У SearchForm проп влияет только на саджест: ссылка на выдачу по-прежнему строится по host,
иначе пользователь уходил бы на прокси вместо сайта бренда.
| Проп | Значение |
| --- | --- |
| currency | ISO 4217, по умолчанию USD |
| lang | по умолчанию берётся из <html lang>, фолбэк en |
| useProxy | ходить за ценами через прокси; для сторибука и конструктора, требует VPN |
| pricesApiUrl | подменить эндпоинт целиком; приоритетнее useProxy |
| pricesTimeoutMs | сколько ждать цены, по умолчанию 5000 |
Футер
components/Footer — футер, который живёт в бакете
Вёрстка лежит не в пакете, а в отдельном репозитории
live-footer и раскатывается на S3.
Компонент рендерит контейнер и тег загрузчика
live-footer-loader
(https://im.worldota.net/footers/loader.js): загрузчик сам подбирает сборку под бренд и язык,
включает fluid-режим и рисует футер в собственном shadow root. Схему сборок
(footers/<бренд>/index.<язык>.js, списки локалей) пакет не знает — это внутреннее устройство
live-footer.
Смысл: футер меняется часто, и раскатывать правку релизом пакета и передеплоем каждого лендинга дорого. С живым футером обновление доезжает само. Плата — футер появляется только в браузере и зависит от доступности бакета.
---
import Footer from "int-components/components/Footer";
---
<Footer brand="zenhotels" lang="de" contentMaxWidth={1600} />client:* не нужен: скрипт уезжает в html и выполняется при парсинге страницы.
Импорт css тоже не нужен — стили внутри скрипта.
| Проп | Значение |
| --- | --- |
| brand | обязательный: канонический id бренда из @mrktg/int-brands — ratehawk, zenhotels, roundtrip или extranet-int |
| lang | Язык футера, если не тот, что в <html lang> страницы. Для локали, под которую бренд не собран, загрузчик подключит сборку дефолтной локали бренда (у международных брендов — английскую) |
| contentMaxWidth | max-width контента: число трактуется как px. По умолчанию ограничение есть только у RateHawk (1600px) — остальные футеры тянутся на всю ширину контейнера, как на своих сайтах |
| fluid | Включает или выключает флюидную вёрстку футера: скрипт читает font-size у html страницы (его ставит base.css из clamp-scaling) и держит его в своей единице размера, поэтому футер скейлится синхронно с остальной вёрсткой. Без пропа загрузчик решает сам — по переменной --clamp-scaling-fs на :root, которую объявляет тот же base.css; проп нужен только при нестандартной вёрстке |
| withFonts | false — не подключать @font-face бренда, если проект хостит те же шрифты сам |
| build | Сборка футера вместо мастера: тег или slug ветки (footers/<бренд>/builds/<build>/) — чтобы посмотреть ветку или запиниться на версию |
| baseUrl | Откуда брать сборки футеров — например, дев-сервер live-footer |
| src | Полный урл скрипта вместо загрузчика — конкретная сборка (.../footers/zen/builds/v1.2.0/index.de.js). Бренд, язык и fallback локали тогда зашиты в урле, остальные пропсы уезжают скрипту data-атрибутами |
Полный список атрибутов загрузчика и правила выбора языка — в README live-footer-loader.
<бренд>-components/Footer — футер бренда
В папке каждого бренда лежит Footer: тот же components/Footer с зафиксированным brand, остальные
пропсы те же. Лендингу бренда так не нужно знать про проп brand, а конструктору — про общий
компонент. Собственной вёрстки у него нет, поэтому client:load и импорт css ему тоже не нужны.
---
import Footer from "int-components/rh-components/Footer";
---
<Footer lang="de" contentMaxWidth={1600} />Список папок — в разделе компонентов брендов.
Стили футера изолированы shadow root'ом, поэтому ThemeProvider футеру не нужен —
он по-прежнему нужен остальным компонентам страницы.
Публикация пакета
Auth token лежит в bitwarden. Для получения доступов необходимо письмо в it@ с руководителем в копии. Для установки токена нужно создать файл .npmrc в корне проекта с содержимым:
//registry.npmjs.org/:_authToken=<auth token>соответственно заменить на токен из bitwarden.
Затем выполнить команду:
npm run publish:patch