Перейти до вмісту
Leonidov.DEV

Острови інтерактивності: 5 рішень у HydraLine

Архітектура
Острови інтерактивності: 5 рішень у HydraLine

Flutter Web дає команді одну модель відтворення на кожен екран, і тому він добрий для застосунку. Ця сама модель перетворює публічну сторінку на canvas, а в canvas роботу нема чого читати. HydraLine ставить острови інтерактивності поверх справжнього HTML, і те, як саме, вирішили п’ять пунктів.

Код: HydraLine, ліцензія MIT.

Dart 3.9, Flutter 3.35, три пакети: hydraline, hydraline_server, hydraline_flutter. 486 модульних і віджет-тестів, 26 наскрізних перевірок у живому Chrome.

Рішення 1: додавати до застосунку, а не замінювати його

Бібліотека не забирає main(), не замінює MaterialApp і не нав’язує роутер. Маршрут переїжджає в режим document або в режим hybrid з островами Flutter усередині HTML, а решта застосунку продовжує працювати.

Переїзд, який можна робити по одному маршруту, переживає дедлайн. Переписування фронтенду це проєкт, а проєкт такого розміру скасовують на другому місяці.

Рішення 2: збирач не бачить User-Agent

Дешевий спосіб зробити сайт на Flutter індексованим це визначати робота й віддавати йому готовий HTML. Він працює, і він же клоакінг: два різні документи за однією адресою, і пошуковик, який це виявить, вважає санкцією весь домен.

Тут User-Agent до збирачів сторінок не доходить. Робот і людина отримують побайтно однакове тіло, а тест у CI порівнює дві відповіді. Це структурна обіцянка, а не правило, яке хтось має пам’ятати.

Рішення 3: три рівні, вибір на маршрут

L0 це статичний HTML без JavaScript: details і summary, посилання :target, ліниві зображення. L1 додає звичайний JavaScript і острови на HTMX близько 8–14 КБ для вкладок, форм і пошуку. L2 вантажить движок Flutter для острова, якому він потрібен, за тригером, а не під час завантаження сторінки.

Рівні існують тому, що «інтерактивний» це не одна вимога. Стаття це L0, форма з фільтром це L1, конфігуратор із 3D це L2. Однаковий підхід до всіх трьох і дає бандл на два мегабайти заради сторінки тексту.

Рішення 4: одне дерево документа, SSR і SSG

Те саме дерево DocumentNode іде потоком із сервера на Dart або збирається в статичний dist/. Маркетинговий сайт буває статичним, застосунок обслуговується сервером, і опис сторінки в них один.

Два шляхи відтворення з однієї моделі це єдиний варіант, якому я вірю. Дві написані руками реалізації однієї сторінки розходяться за місяць, і розходження проявляється як canonical, який не збігається з картою сайту.

Рішення 5: зайняти місце до приходу острова

Острів оголошує розмір, і заглушка тримає рівно цю площу через Declarative Shadow DOM. Зсув верстки тримається близько нуля, а наскрізний тест у живому Chrome це вимірює, а не припускає.

Це найнепомітніше рішення, і людина відчуває його найсильніше. Сторінка, яка стрибає, коли читач на середині речення, забирає речення, і вимірювання це єдине, що тримає таку обіцянку чесною.

Чого пакет не робить

Він не рахує SEO-бали, не обіцяє позицій і не чіпає швидкість сторінки понад те, що відтворює. Він також не обходить корінь сайту в пошуках сторінок: карта будується із зареєстрованих маршрутів, і незареєстрована сторінка до карти не потрапляє.

SafeUrl відхиляє javascript: і data: під час створення значення, екранування працює за контекстом, sanitizeHtml() знімає вбудовані обробники, скрипти рантайму несуть integrity і crossorigin. За цим стоїть фаззинг на мільйоні входів, бо санітайзер із доброю репутацією це не санітайзер із тестом.

Чого це вчить

У браузера є робоча модель відтворення й робоча модель доступності. Фреймворк, який замінює обидві, мусить їх перезібрати, і перезбирання це місце, де сторінка стає невидимою для всього, що не браузер.

Той самий довід у прогресивному покращенні, тільки прикладений до движка відтворення, а не до форми. Та сама логіка в замітці завантаження файла у форму, де нативний input лишається джерелом істини, а віджет його одягає.

HydraLine виходить під MIT і лежить на pub.dev, три пакети описані окремо.