|
| 1 | +# Time Picker Localization & Dial Fix — 2026-04-17 |
| 2 | + |
| 3 | +## Problem |
| 4 | + |
| 5 | +Партнёр при заполнении карточки заведения на 5-м шаге («Время работы») сталкивался с тремя проблемами в нативном Material TimePicker: |
| 6 | + |
| 7 | +- **(а)** В режиме ручного ввода (`TimePickerEntryMode.input`) клавиатура не меняла значения часов/минут. |
| 8 | +- **(б)** При первом открытии в режиме циферблата цифры визуально перекрывались — две концентрические окружности (0-11 и 12-23) слишком близки. |
| 9 | +- **(в)** Все подписи диалога на английском: "Select time", "Enter time", "Hour", "Minute", "Cancel", "OK". |
| 10 | + |
| 11 | +## Root Causes |
| 12 | + |
| 13 | +1. **Отсутствие русской Material-локализации.** В `MaterialApp` не были подключены `localizationsDelegates` и `supportedLocales`. Без `MaterialLocalizations` ru: |
| 14 | + - все подписи на английском (в) |
| 15 | + - форматер поля ввода в `TimePickerEntryMode.input` не принимает цифры с клавиатуры (а) |
| 16 | + |
| 17 | +2. **Известный баг Flutter в 24-часовом циферблате** ([flutter/flutter#141501](https://github.com/flutter/flutter/issues/141501)): кольца 0-11 и 12-23 рисуются слишком близко друг к другу. Присутствует в stable 3.35.2. Локализация на это не влияет (б). |
| 18 | + |
| 19 | +## Changes |
| 20 | + |
| 21 | +### Локализация (закрывает а и в) |
| 22 | +- `mobile/pubspec.yaml`: добавлен `flutter_localizations` (SDK), `intl` поднят `^0.18.1 → ^0.20.2` (требование SDK-пакета) |
| 23 | +- `mobile/lib/main.dart`: в `MaterialApp` добавлены `locale: Locale('ru')`, `localizationsDelegates` (Global Material/Widgets/Cupertino), `supportedLocales: [ru, en]` |
| 24 | + |
| 25 | +### Убран циферблат (закрывает б) |
| 26 | +- `mobile/lib/screens/partner/working_hours_screen.dart`: `initialEntryMode: TimePickerEntryMode.input → TimePickerEntryMode.inputOnly`. Диалог открывается сразу в режиме клавиатурного ввода, кнопка переключения на циферблат скрыта. Для ввода рабочих часов заведения клавиатура объективно быстрее циферблата. |
| 27 | + |
| 28 | +## Verification |
| 29 | + |
| 30 | +- `flutter analyze` — No issues found (после обновления `intl`). |
| 31 | +- Сборка `flutter build apk --debug` прошла. |
| 32 | +- Установка на Samsung A72 (Android 14, R58R54TPJ7Z) через ADB, визуальная проверка пользователем: |
| 33 | + - ✅ Все надписи на русском |
| 34 | + - ✅ Клавиатурный ввод работает |
| 35 | + - ✅ Циферблата больше нет — проблема исчезла как класс |
| 36 | + |
| 37 | +## Known UX Residual (out of scope) |
| 38 | + |
| 39 | +При вводе с клавиатуры для замещения цифр нужно сначала нажать Backspace. Это дефолтное поведение Flutter TimePicker. Для полного решения (авто-замещение при фокусе) понадобится кастомный inline-picker — вынесено как потенциальная отдельная задача. |
| 40 | + |
| 41 | +## Files Modified |
| 42 | + |
| 43 | +- `mobile/pubspec.yaml` |
| 44 | +- `mobile/pubspec.lock` |
| 45 | +- `mobile/lib/main.dart` |
| 46 | +- `mobile/lib/screens/partner/working_hours_screen.dart` |
| 47 | + |
| 48 | +## Side Effects (positive) |
| 49 | + |
| 50 | +Русская локаль теперь применяется ко всем Material-виджетам в приложении (DatePicker, Dismissible, контекстные меню и т.п.), а не только к TimePicker. |
0 commit comments