Skip to content

Commit d76cbe8

Browse files
committed
fix(web): safe-area iOS PWA через safe-area-insets JS-либу (как в smp_bank)
Все прошлые подходы (SafeArea-виджет, viewport-fit, body/flutter-view CSS, JS-обсервер стилей) не работали: Flutter web не пробрасывает env(safe-area-inset) в MediaQuery, а инлайн-стили движок переписывает. Рабочее решение (проверено в smp_bank_copy, flutter/flutter#84833): - web/js/webinsets.min.js (safe-area-insets, pengfeiw) меряет реальные insets off-screen scroll-хаком и кладёт в window.safeAreaInsets; - lib/util/web_insets/ — JS-interop биндинг (dart:js_interop, conditional import: stub для нативы, web-реализация читает safeAreaInsets.bottom); - root_screen: kIsWeb ? SafeArea(minimum: bottom, child: nav) : nav — SafeArea.minimum гарантирует отступ даже при viewPadding=0. - Реактивность: библиотека меряет лениво (первый кадр = 0), поэтому post-frame setState + onChange-листенер (форс-rebuild после замера и на поворот экрана). Без этого inset залипал в 0 на холодном старте — это и была причина, почему CSS-подходы «не срабатывали». - inset НЕ делим на devicePixelRatio (либа отдаёт логические CSS-пиксели = MediaQuery Flutter web).
1 parent 403af4f commit d76cbe8

6 files changed

Lines changed: 102 additions & 55 deletions

File tree

‎lib/ui/screen/root_screen.dart‎

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ import 'package:acits_flutter/ui/screen/calendar/calendar_screen.dart';
66
import 'package:acits_flutter/ui/screen/drugs/drugs_screen.dart';
77
import 'package:acits_flutter/ui/screen/main/main_screen.dart';
88
import 'package:acits_flutter/ui/widget/personal_drawer.dart';
9+
import 'package:acits_flutter/util/web_insets/web_insets.dart';
10+
import 'package:flutter/foundation.dart' show kIsWeb;
911
import 'package:flutter/material.dart';
1012
import 'package:easy_localization/easy_localization.dart';
1113

@@ -43,6 +45,21 @@ class _RootScreenState extends State<RootScreen> {
4345
final _scaffoldKey = GlobalKey<ScaffoldState>();
4446
int _current = 0;
4547

48+
@override
49+
void initState() {
50+
super.initState();
51+
// safe-area (iOS PWA): библиотека меряет inset лениво — на первом кадре он
52+
// может быть 0. После первого кадра и на изменение (поворот) — пересобираем.
53+
if (kIsWeb) {
54+
WidgetsBinding.instance.addPostFrameCallback((_) {
55+
if (mounted) setState(() {});
56+
});
57+
WebInsets.onChange(() {
58+
if (mounted) setState(() {});
59+
});
60+
}
61+
}
62+
4663
@override
4764
Widget build(BuildContext context) {
4865
final bottomNav = BottomNavigationBar(
@@ -67,16 +84,23 @@ class _RootScreenState extends State<RootScreen> {
6784
fixedColor: ColorRes.accent,
6885
);
6986

87+
// Web (iOS PWA): Flutter не пробрасывает env(safe-area-inset) в MediaQuery,
88+
// поэтому нав-бар лезет под home-indicator. Берём реальный inset из JS-либы
89+
// (WebInsets) и заставляем SafeArea дать минимум этого отступа. На нативе
90+
// WebInsets.bottom = 0, и обёртку не ставим — Scaffold сам учитывает inset.
91+
final bottomNavWithInset = kIsWeb
92+
? SafeArea(
93+
minimum: EdgeInsets.only(bottom: WebInsets.bottom),
94+
child: bottomNav,
95+
)
96+
: bottomNav;
97+
7098
return RootDrawerProvider(
7199
rootScaffoldKey: _scaffoldKey,
72100
child: Scaffold(
73101
key: _scaffoldKey,
74102
drawer: const PersonalDrawerWidget(),
75-
// safe-area для нав-бара НЕ здесь: на нативе Scaffold сам учитывает
76-
// нижний inset; на web Flutter игнорирует env(safe-area-inset) —
77-
// там canvas поджат под home-indicator через body в web/index.html
78-
// (padding снизу = env(safe-area-inset-bottom)).
79-
bottomNavigationBar: bottomNav,
103+
bottomNavigationBar: bottomNavWithInset,
80104
body: Stack(
81105
children: [
82106
Offstage(offstage: _current != 0, child: const MainScreen()),
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
/// Safe-area insets для web (iOS PWA) через JS-библиотеку safe-area-insets.
2+
///
3+
/// Flutter web НЕ пробрасывает `env(safe-area-inset-*)` в `MediaQuery`, поэтому
4+
/// нижний home-indicator на iOS-PWA перекрывает нав-бар. `web/js/webinsets.min.js`
5+
/// (safe-area-insets, pengfeiw) измеряет реальные insets и кладёт в
6+
/// `window.safeAreaInsets`; здесь читаем их через JS-interop.
7+
///
8+
/// На нативных платформах — заглушка (нули): там inset приходит от ОС штатно
9+
/// через `MediaQuery.viewPadding`, JS-либа не нужна.
10+
library;
11+
12+
export 'web_insets_stub.dart' if (dart.library.js_interop) 'web_insets_web.dart';
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
/// Нативная заглушка [WebInsets]: на mobile/desktop safe-area приходит от ОС
2+
/// через `MediaQuery.viewPadding`, JS-измерение не нужно — возвращаем нули.
3+
abstract final class WebInsets {
4+
static double get bottom => 0;
5+
6+
static double get top => 0;
7+
8+
static double get left => 0;
9+
10+
static double get right => 0;
11+
12+
/// На нативе insets не меняются через JS — no-op.
13+
static void onChange(void Function() callback) {}
14+
}
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
import 'dart:js_interop';
2+
3+
/// Web-реализация [WebInsets]: читает `window.safeAreaInsets` из
4+
/// `web/js/webinsets.min.js` (библиотека safe-area-insets).
5+
///
6+
/// Геттеры возвращают число или NaN (если библиотека ещё не измерила / не
7+
/// поддерживается) — NaN приводим к 0.
8+
@JS('safeAreaInsets')
9+
external _SafeAreaInsets? get _safeAreaInsets;
10+
11+
@JS()
12+
@staticInterop
13+
class _SafeAreaInsets {}
14+
15+
extension _SafeAreaInsetsExt on _SafeAreaInsets {
16+
external double get top;
17+
external double get bottom;
18+
external double get left;
19+
external double get right;
20+
external void onChange(JSFunction callback);
21+
}
22+
23+
double _clean(double? v) => (v == null || v.isNaN) ? 0 : v;
24+
25+
abstract final class WebInsets {
26+
static double get bottom => _clean(_safeAreaInsets?.bottom);
27+
28+
static double get top => _clean(_safeAreaInsets?.top);
29+
30+
static double get left => _clean(_safeAreaInsets?.left);
31+
32+
static double get right => _clean(_safeAreaInsets?.right);
33+
34+
/// Подписка на изменение insets (первый замер запаздывает, плюс повороты
35+
/// экрана). Колбэк дёргается библиотекой; аргумент игнорируем — читаем
36+
/// свежие значения через геттеры.
37+
static void onChange(void Function() callback) {
38+
_safeAreaInsets?.onChange(((JSAny _) => callback()).toJS);
39+
}
40+
}

‎web/index.html‎

Lines changed: 6 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -79,21 +79,14 @@
7979
<link rel="manifest" href="manifest.json">
8080
<link rel="stylesheet" type="text/css" href="splash/style.css">
8181

82-
<!-- iOS PWA safe-area: Flutter web-движок НЕ читает env(safe-area-inset),
83-
поэтому поджимаем его хост-элементы через CSS напрямую. Flutter в
84-
standalone растягивает flutter-view / flt-glass-pane на весь экран
85-
(position: absolute; top/bottom: 0) — перекрывая home-indicator.
86-
Заставляем их заканчиваться над системной полоской. !important нужен:
87-
Flutter выставляет inline-стили при инициализации. -->
82+
<!-- iOS PWA safe-area: Flutter web НЕ пробрасывает env(safe-area-inset) в
83+
MediaQuery. Библиотека safe-area-insets (pengfeiw) измеряет реальные
84+
insets и кладёт в window.safeAreaInsets{top,bottom,left,right}; Dart
85+
читает их через JS-interop (lib/util/web_insets.dart) и применяет
86+
SafeArea(minimum: bottom) к нав-бару. Проверенный подход из smp_bank. -->
87+
<script src="js/webinsets.min.js"></script>
8888
<style>
8989
body { background: #6776E0; }
90-
flutter-view,
91-
flt-glass-pane,
92-
flt-scene-host,
93-
#flutter_host {
94-
bottom: env(safe-area-inset-bottom, 0px) !important;
95-
height: calc(100% - env(safe-area-inset-bottom, 0px)) !important;
96-
}
9790
</style>
9891
</head>
9992

@@ -130,43 +123,6 @@
130123
}
131124
</script>
132125

133-
<script>
134-
// iOS PWA safe-area: Flutter web игнорит env(safe-area-inset) и растягивает
135-
// flutter-view на весь экран, перекрывая home-indicator. CSS-правила выше
136-
// Flutter может переписать inline-стилями при инициализации, поэтому
137-
// дожимаем програмно: измеряем реальный inset (через невидимый пробник с
138-
// env()) и применяем padding-bottom к flutter-view, повторяя на каждую
139-
// мутацию DOM (Flutter создаёт/перестраивает view уже после загрузки).
140-
(function () {
141-
var probe = document.createElement('div');
142-
probe.style.cssText =
143-
'position:fixed;left:0;bottom:0;width:0;height:env(safe-area-inset-bottom,0px);pointer-events:none;';
144-
document.documentElement.appendChild(probe);
145-
146-
function inset() {
147-
return probe.getBoundingClientRect().height || 0;
148-
}
149-
150-
function apply() {
151-
var pad = inset();
152-
if (pad <= 0) return;
153-
var views = document.querySelectorAll('flutter-view, flt-glass-pane, #flutter_host');
154-
views.forEach(function (v) {
155-
v.style.setProperty('bottom', pad + 'px', 'important');
156-
v.style.setProperty('height', 'calc(100% - ' + pad + 'px)', 'important');
157-
});
158-
}
159-
160-
var obs = new MutationObserver(apply);
161-
obs.observe(document.body, { childList: true, subtree: true });
162-
window.addEventListener('resize', apply);
163-
window.addEventListener('orientationchange', apply);
164-
// Первичный прогон + несколько отложенных (Flutter доинициализирует view).
165-
apply();
166-
[200, 600, 1200, 2500].forEach(function (t) { setTimeout(apply, t); });
167-
})();
168-
</script>
169-
170126
<picture id="splash">
171127
<source
172128
srcset="splash/img/light-1x.png 1x, splash/img/light-2x.png 2x, splash/img/light-3x.png 3x, splash/img/light-4x.png 4x"

‎web/js/webinsets.min.js‎

Lines changed: 1 addition & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)