feat(docs): add v8 migration guide #9333
Open
+712
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
|
✅ Изменений в собранных файлах нет Commit 1cffcb9 |
Contributor
👀 Docs deployed
📦 Package ❌yarn add @vkontakte/vkui@Commit 1cffcb9 |
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #9333 +/- ##
=======================================
Coverage 94.96% 94.96%
=======================================
Files 436 436
Lines 11763 11763
Branches 4329 4329
=======================================
Hits 11171 11171
Misses 592 592
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
SevereCloud
approved these changes
Dec 29, 2025
| Вместо использования `ActionSheetItem` с `mode="cancel"` или `isCancelItem` в качестве `iosCloseItem`, используйте: | ||
|
|
||
| - `slotProps.iosCloseItem` в `ActionSheet` для передачи пропсов в кнопку отмены | ||
| - или проп `iosCloseItem` с компонентом `ActionSheetDefaultIosCloseItem` для полной кастомизации |
Contributor
There was a problem hiding this comment.
Suggested change
| - или проп `iosCloseItem` с компонентом `ActionSheetDefaultIosCloseItem` для полной кастомизации | |
| - или свойство `iosCloseItem` с компонентом `ActionSheetDefaultIosCloseItem` для полной кастомизации |
|
|
||
| Вместо использования `ActionSheetItem` с `mode="cancel"` или `isCancelItem` в качестве `iosCloseItem`, используйте: | ||
|
|
||
| - `slotProps.iosCloseItem` в `ActionSheet` для передачи пропсов в кнопку отмены |
Contributor
There was a problem hiding this comment.
Suggested change
| - `slotProps.iosCloseItem` в `ActionSheet` для передачи пропсов в кнопку отмены | |
| - `slotProps.iosCloseItem` в `ActionSheet` для передачи свойств в кнопку отмены |
| - Свойство `onClose` переименовано в `onClosed`. | ||
| - Добавлена поддержка `slotProps.iosCloseItem` для упрощения локализации кнопки "Отмена" на iOS. | ||
|
|
||
| Кнопка отмены на iOS рендерится отдельно от списка действий (вне `ActionSheetItem`). Теперь можно передавать пропсы напрямую в `ActionSheetDefaultIosCloseItem` через `slotProps.iosCloseItem` без необходимости создавать обёртку. |
Contributor
There was a problem hiding this comment.
Suggested change
| Кнопка отмены на iOS рендерится отдельно от списка действий (вне `ActionSheetItem`). Теперь можно передавать пропсы напрямую в `ActionSheetDefaultIosCloseItem` через `slotProps.iosCloseItem` без необходимости создавать обёртку. | |
| Кнопка отмены на iOS рендерится отдельно от списка действий (вне `ActionSheetItem`). Теперь можно передавать свойства напрямую в `ActionSheetDefaultIosCloseItem` через `slotProps.iosCloseItem` без необходимости создавать обёртку. |
| <details> | ||
| <summary>Миграция</summary> | ||
|
|
||
| Если вам нужно сохранить прежнее поведение, явно укажите `imageTheme="dark"`: |
Contributor
There was a problem hiding this comment.
Suggested change
| Если вам нужно сохранить прежнее поведение, явно укажите `imageTheme="dark"`: | |
| Если вам нужно сохранить прежнее поведение, укажите `imageTheme="dark"`: |
| + onChange?: (value: Date) => void | ||
| ``` | ||
|
|
||
| Значение теперь не может быть `undefined`, поэтому проверка на существование значения больше не требуется. |
Contributor
There was a problem hiding this comment.
Suggested change
| Значение теперь не может быть `undefined`, поэтому проверка на существование значения больше не требуется. | |
| Проверка значения на `undefined` больше не требуется. |
Comment on lines
+19
to
+20
| > 3. То, что можно изменить на месте, подвергнется миграции, о более сложных кейсах вы будете | ||
| > оповещены в консоли по ходу выполнения команды из **п.2**. |
Contributor
There was a problem hiding this comment.
Suggested change
| > 3. То, что можно изменить на месте, подвергнется миграции, о более сложных кейсах вы будете | |
| > оповещены в консоли по ходу выполнения команды из **п.2**. | |
| > 3. Простые изменения подвергнутся миграции, случаи требующие ручных изменений | |
| > будут выведены в консоли |
| > | ||
| > 1. Для начала обновите ваше приложение до новой мажорной версии (**v8**) в соответствии с требованиями | ||
| > вашего пакетного менеджера и среды. | ||
| > 2. Перейдите в директорию с исходниками вашего проекта (обычно это `src/`) и запустите команду `npx @vkontakte/vkui-codemods`. |
Contributor
There was a problem hiding this comment.
Suggested change
| > 2. Перейдите в директорию с исходниками вашего проекта (обычно это `src/`) и запустите команду `npx @vkontakte/vkui-codemods`. | |
| > 2. Перейдите в директорию с исходным кодом вашего проекта (обычно это `src/`) и запустите команду `npx @vkontakte/vkui-codemods`. |
|
|
||
| > **Автоматизация обновления до v8** | ||
| > | ||
| > Для `Typescript`-файлов можно воспользоваться инструментом по автоматической миграции ваших компонентов. |
Contributor
There was a problem hiding this comment.
Suggested change
| > Для `Typescript`-файлов можно воспользоваться инструментом по автоматической миграции ваших компонентов. | |
| > Для TypeScript файлов можно воспользоваться инструментом по автоматической миграции: |
Comment on lines
+12
to
+21
| > **Автоматизация обновления до v8** | ||
| > | ||
| > Для `Typescript`-файлов можно воспользоваться инструментом по автоматической миграции ваших компонентов. | ||
| > | ||
| > 1. Для начала обновите ваше приложение до новой мажорной версии (**v8**) в соответствии с требованиями | ||
| > вашего пакетного менеджера и среды. | ||
| > 2. Перейдите в директорию с исходниками вашего проекта (обычно это `src/`) и запустите команду `npx @vkontakte/vkui-codemods`. | ||
| > 3. То, что можно изменить на месте, подвергнется миграции, о более сложных кейсах вы будете | ||
| > оповещены в консоли по ходу выполнения команды из **п.2**. | ||
| > |
Contributor
There was a problem hiding this comment.
Suggested change
| > **Автоматизация обновления до v8** | |
| > | |
| > Для `Typescript`-файлов можно воспользоваться инструментом по автоматической миграции ваших компонентов. | |
| > | |
| > 1. Для начала обновите ваше приложение до новой мажорной версии (**v8**) в соответствии с требованиями | |
| > вашего пакетного менеджера и среды. | |
| > 2. Перейдите в директорию с исходниками вашего проекта (обычно это `src/`) и запустите команду `npx @vkontakte/vkui-codemods`. | |
| > 3. То, что можно изменить на месте, подвергнется миграции, о более сложных кейсах вы будете | |
| > оповещены в консоли по ходу выполнения команды из **п.2**. | |
| > | |
| > **Автоматическая миграция** | |
| > | |
| > Воспользуйтесь инструментом по автоматической миграции для TypeScript файлов: | |
| > | |
| > 1. Обновите `@vkontakte/vkui` до **v8** | |
| > 2. В директории с исходным кодом (обычно это `src/`) запустите команду `npx @vkontakte/vkui-codemods`. | |
| > 3. Простые изменения сделает codemod, о сложных будет выведено в консоли | |
| > |
Comment on lines
+188
to
+193
| Изменены вертикальные отступы (padding) в компоненте. Теперь они рассчитываются динамически на основе | ||
| высоты поля и высоты строки текста, что делает компонент более компактным. | ||
|
|
||
| Было: `padding: 12px` | ||
|
|
||
| Стало: вертикальный отступ вычисляется как `(размер_поля - высота_строки) / 2`. |
Contributor
There was a problem hiding this comment.
Suggested change
| Изменены вертикальные отступы (padding) в компоненте. Теперь они рассчитываются динамически на основе | |
| высоты поля и высоты строки текста, что делает компонент более компактным. | |
| Было: `padding: 12px` | |
| Стало: вертикальный отступ вычисляется как `(размер_поля - высота_строки) / 2`. | |
| Внутренние отступы синхронизированы с другими элементами форм. Компонент стал компактнее. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Описание
Добавил migration guide для перехода на v8
Release notes
Документация
v8