Merge pull request #30 from Krakozaber/master

Add info to docs
This commit is contained in:
simialbi 2021-12-20 11:10:40 +01:00 committed by GitHub
commit 24c2cb3313
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 56 additions and 2 deletions

View File

@ -25,3 +25,4 @@
-------------
* [Использование .sass файлов Bootstrap напрямую](topics-sass.md)
* [Миграция с yii2-bootstrap4](migrating-yii2-bootstrap.md)

View File

@ -5,7 +5,8 @@ Bootstrap - это комплексное front-end решение, включа
- [[yii\bootstrap5\BootstrapAsset|BootstrapAsset]] - содержит CSS файлы.
- [[yii\bootstrap5\BootstrapPluginAsset|BootstrapPluginAsset]] - зависит от [[yii\bootstrap5\BootstrapAsset]], содержащий javascript файлы.
- [[yii\bootstrap5\BootstrapIconAsset|BootstrapIconAsset]] - содержит иконки.
Конкретные приложения могут потребовать различного использования. Если вам нужны только CSS-стили, то пакета [[yii\bootstrap5\BootstrapAsset]] будет достаточно. Тем не менее, если вы хотите использовать Bootstrap JavaScript, вам необходимо зарегистрировать [[yii\bootstrap5\BootstrapPluginAsset]].
Конкретные приложения могут потребовать различного использования. Если вам нужны только CSS-стили, то пакета [[yii\bootstrap5\BootstrapAsset]] будет достаточно. Тем не менее, если вы хотите использовать Bootstrap JavaScript, вам необходимо зарегистрировать [[yii\bootstrap5\BootstrapPluginAsset]], если вы хотите использовать Bootstrap Icons, вам необходимо зарегистрировать [[yii\bootstrap5\BootstrapIconAsset|BootstrapIconAsset]].
> Tip: большинство виджетов регистрируются с помощью [[yii\bootstrap5\BootstrapPluginAsset]] автоматически.

View File

@ -14,7 +14,7 @@ php composer.phar require --prefer-dist yiisoft/yii2-bootstrap5
или добавьте
```
"yiisoft/yii2-bootstrap": "~1.0.0"
"yiisoft/yii2-bootstrap5": "~2.0.0"
```
в секцию **require** вашего `composer.json`.

View File

@ -0,0 +1,50 @@
Миграция с yii2-bootstrap4
==============================
yii2-bootstrap5 является серьезной переработкой всего проекта (в соответствии с руководством по миграции с Bootstrap4 на Bootstrap5).
Наиболее заметные изменения кратко изложены ниже:
## General
* Изменение namespace с `yii\bootstrap4` на `yii\bootstrap5`
* Минимальная совместимая версия php **ограничена** `>=7.0`
* Кнопки закрытия виджетов, таких как [[yii\bootstrap5\Alert|Alert]] или [[yii\bootstrap5\Modal|Modal]], теперь отображаются
с помощью CSS и больше не содержат содержимого. Поэтому обязательно удалите класс "btn-close" и самостоятельно установите соответствующие стили, если вы его переопределяли.
## Widgets / Classes
### BaseHtml
### ActiveField
### ActiveForm
Новая константа [[yii\bootstrap5\ActiveForm::LAYOUT_FLOATING]]. Это
[new form layout](https://getbootstrap.com/docs/5.1/forms/floating-labels/) введен в Bootstrap 5.
### Breadcrumbs
### ButtonDropdown
### ButtonToolbar
### Carousel
### LinkPager
### Modal
Заменить `data-target` и `data-toggle` на `data-bs-target` и `data-bs-toggle`
### Nav
### NavBar
Теперь есть возможность создать [offcanvas navbar](https://getbootstrap.com/docs/5.1/components/navbar/#offcanvas).
Вы можете добиться этого, установив для параметра `$collapseOptions` значение `false` в виджете [[yii\bootstrap5\NavBar|Navbar]] и
`$offcanvasOptions`, значение пустого массива.
### Tabs
### ToggleButtonGroup

View File

@ -35,6 +35,8 @@ There is a new constant [[yii\bootstrap5\ActiveForm::LAYOUT_FLOATING]]. It's a
### Modal
Change `data-target` and `data-toggle` to `data-bs-target` and `data-bs-toggle`
### Nav
### NavBar