Skip to main content

spring_boot_starter_flutter_navigation 0.7.4 copy "spring_boot_starter_flutter_navigation: ^0.7.4" to clipboard
spring_boot_starter_flutter_navigation: ^0.7.4 copied to clipboard

Navigation for Spring Boot Flutter apps: screens on routes with Spring's path patterns, shells with a stack per branch, RouteTemplate, the route and branch scopes, deep links.

0.7.4 #

  • LanguageChangedEvent names itself (eventName), readable in a release build's debug timeline.

0.7.3 #

  • A relative link between Markdown pages (../beans.md) resolves for a content folder of any root (asset:docs/), not only of resources:.
  • Fixed: an address with #heading opened at the top of the page: the address bar's strategy left the # part out of the first address (PathUrlStrategy keeps it now), so a link straight to a heading scrolls there.
  • PageTransition.content (motion.page-transition: content): the screen comes in as the theme's motion.content-change shows other content.
  • The first address's language (/ja/...) is the app's locale from the start (FlutterAppSettings.locale), so what the start prepares for a language is ready for the first frame: the fonts of spring.flutter.fonts.families. switchLanguage loads the fonts declared for the language before the text changes; Navigation.languageOf(path) is the language a path names.

0.7.2 #

  • README: the link goes to the package's own page on farum-azula.org, and what the README says was checked against the code and brought up to date.
  • Fixed: the task switcher's color comes from the theme shown, not Material's fallback in a WidgetsApp.
  • Fixed: an address with a / at its end (/docs/beans/) is the page without it. Static hosts (Cloudflare Pages, GitHub Pages) send a folder's address that way when the build wrote docs/beans/index.html, and such a page opened empty.
  • RouteContentView(scrollToTop:), true by default: another page of the same screen opens at the top of its scrollable, as a browser opens a page, scrolling there the theme's way (motion.scroll-to-top) (an #anchor scrolls to its heading; a translation of the same page keeps the position). The screen stays.
  • Fixed: RouteContentView no longer collapses to nothing for a frame when another page of the same screen opens; it keeps its view and changes the content the theme's way (motion.content-change).
  • RouteContentView(outline:) hands the page's headings to a MarkdownOutline; the address's #anchor (/docs/core/beans#scopes) scrolls to its heading.
  • LanguageChangedEvent (from, to): the navigation publishes one when the app's language switches, by the address (/ja/...) or switchLanguage; listen with @EventListener. ThemeText of the Flutter starter changes the texts the theme's way (motion.text-change).
  • Behavior change: another address of the same route (/docs/a to /docs/b, /books/1 to /books/2) keeps the screen: its state, its scroll and the shell around it stay, and it rebuilds with the new address and variables. Before, every go made a new screen, so a page of a content route started from nothing and its menus lost their scroll.
  • Fixed: a folder's index.md below the root of a content route (content/docs/guides/index.md at /docs/guides) is the folder's page, as the site's pages and the links between the files already said; its relative links are relative to its own folder. RouteContentView.fileOf says which file an address shows (the folder's index.md, the language's translation).

0.7.1 #

  • First version: screens on routes (ScreenRoutes in Dart configuration), Spring's path patterns, shells with a stack per branch, RouteTemplate and context.route, the route and branch scopes, route filters, spring.flutter.navigation.*; @ScreenRoute and @RouteShell read by the generator (<Page>Route.to(...)); RouteAttributes.preAuthorize and RouteAuthorizationRequirement, enforced by a RouteAuthorizationFilter bean (spring_boot_starter_flutter_security): without one, a guarded route stops the start. The router is made only for an app with routes, so an app with a home keeps Flutter's own addresses.
  • Behavior change: no page transition by default, in every app type; the theme (motion.page-transition: platform, fade, ...) or a screen turns one on.
  • Page transitions follow the theme's motion.page-transition in every app type (Material, Cupertino, widgets), with its duration and curve, and none with reduced motion. PageTransition gains theme (the default), fadeUpwards, zoom and cupertino; a screen chooses its own with @ScreenRoute(transition: ...), one navigation with go(path, transition: ...) / push(path, transition: ...) (a menu switching pages at once). A screen can open in a branch its path is not under: @ScreenRoute('/motion', branch: '/more'), or screen(..., branch:) and a screen declared in a branch builder outside its path (no longer refused).
  • It brings and re-exports spring_boot_starter_flutter (and through it spring_web_dart): an app lists this package alone.
  • Deep links: spring.flutter.navigation.deep-links.* (the scheme, the domains, the platforms' ids; the generator writes the platforms' files and the domains' files from them). On a device an address from the platform opens its screen unless deep-links.exclude or @RouteInfo(link: false) (a route's link: false) keeps it out, when the app's first screen opens.
  • RouteContentView: the Markdown of the screen's route (content:) with MarkdownView; a link to another Markdown file of the site opens its screen, as on the pages the build writes.
  • Addresses that could leave a route's folder are refused: an encoded slash or backslash, a backslash, an encoded NUL, or a . / .. segment once decoded (Navigation.refusedPath). The app stays on its screen, or opens its first screen when nothing is open yet (a link). A {*rest} value with such a segment never names a content file, so a public {*path} screen cannot show a file of a guarded screen's folder.
  • Languages: spring.flutter.navigation.languages ([en, ja]) gives each language its addresses, the default without a prefix, the others under /<language>. Such an address opens the same screen with the app's locale set (RouteLanguageCustomizer); the app's own paths keep the current language; RouteTemplate.language and switchLanguage; RouteContentView shows <file>.<language>.md when there is one. RouteLocation.withPath.
0
likes
0
points
844
downloads

Documentation

Documentation

Publisher

verified publisherfarum-azula.org

Weekly Downloads

Navigation for Spring Boot Flutter apps: screens on routes with Spring's path patterns, shells with a stack per branch, RouteTemplate, the route and branch scopes, deep links.

Repository (GitHub)
View/report issues

Topics

#flutter #navigation #router #spring

License

unknown (license)

Dependencies

flutter, flutter_web_plugins, spring_boot_dart, spring_boot_starter_flutter, spring_web_dart

More

Packages that depend on spring_boot_starter_flutter_navigation