ui-router README

The project's README from github.com/angular-ui/ui-router. As one markdown file: README.md.

AngularUI Router  Build Status

Note: this is the Angular 1.x source for UI-Router version 1.x. If you are looking for the source for UI-Router version 0.x, it can be found here


The de-facto solution to flexible routing in angular


Tutorials | API Docs | Download stable (or Minified) | Guide | Sample App | FAQ | Report an Issue | Contribute | Help! |


Angular UI-Router is a client-side Single Page Application routing framework for AngularJS.

Routing frameworks for SPAs update the browser's URL as the user navigates through the app. Conversely, this allows changes to the browser's URL to drive navigation through the app, thus allowing the user to create a bookmark to a location deep within the SPA.

UI-Router applications are modeled as a hierarchical tree of states. UI-Router provides a state machine to manage the transitions between those application states in a transaction-like manner.

Get Started

Resources

Videos

Reporting issues and Contributing

Please read our Contributor guidelines before reporting an issue or creating a pull request.

ui-router (angular-ui/ui-router)

Searching Database…

13.4K ·GitHub
Что это такое?UI-Router — это фреймворк клиентской маршрутизации для одностраничных приложений (SPA), изначально созданный для AngularJS. Он описывает приложение как иерархическое дерево состояний, а не как плоские соответствия «URL → представление».
Это замена встроенному маршрутизатору Angular или что-то другое?Да, это альтернативный фреймворк маршрутизации: вместо прямого сопоставления URL с представлениями он использует конечный автомат, в котором состояния можно вкладывать друг в друга, и каждое состояние управляет собственным представлением, данными и переходами.
Как добавить его в свой проект?Возьмите стабильную сборку (или минифицированную версию) и следуйте руководству по началу работы для нужного фреймворка, так как для Angular 1, Angular 2+ и React есть отдельные пакеты.
Это работает с современным Angular или только с AngularJS?Есть отдельные редакции: этот репозиторий содержит исходный код для Angular 1.x (AngularJS), а для Angular 2+ и React доступны отдельные версии и пакеты.
Проект всё ещё активно развивается или сейчас в основном устарел?В README упоминается старая ветка 0.x с собственным пакетом «Extras/Addons», что говорит о долгой истории версий. Это зрелый, давно существующий проект, а не быстро развивающийся новый инструмент.
Зачем использовать вложенные состояния вместо обычных маршрутов?Вложенные состояния позволяют каждому уровню интерфейса (например, макету, вкладке или подвкладке) иметь собственное представление, данные и сегмент URL. Поэтому переход вглубь приложения обновляет только нужные вложенные представления, а не перерисовывает всё целиком.
Можно ли сохранить в закладки глубокое место внутри приложения?Да. Поскольку переходы между состояниями определяют URL в браузере (и наоборот), пользователи могут добавить в закладки или отправить ссылку на любое конкретное состояние глубоко внутри одностраничного приложения.
Creator
angular-ui
Size
13.1 MB
Stars
13.4K
Age
13y
Commits · 90 Days