flutter_waya 12.0.0
flutter_waya: ^12.0.0 copied to clipboard
A lightweight Flutter UI library with animation, progress, paging, input, display and timing widgets.
12.0.0 #
Breaking changes #
- Require Flutter 3.47+ / Dart 3.13+
- Unify public API naming with the
Flprefix: all public classes, enums, typedefs and extensions are renamed (for exampleEvent→FlEvent,ScreenAdaptation→FlScreenAdaptation,XSwitch→FlSwitch,Counter→FlCounter); global helpers are nowflSendEvent,flEventListenandflEventDestroy - Reorganize
lib/srcby responsibility:core,animation,feedback,paging,input,display,timing - Remove the
ListEntrycomponent - Remove the
TabBarMergecomponent - Remove the
FlTabBarBoxcomponent - Remove the
FlDraggableScrollbarcomponent - Remove the
FlLiquidProgressIndicatorcomponent - Remove the
flGetBoxShadowhelper - Remove
FlWrapper.justand customspinePathBuildersupport; useFlWrapperwith the newspineRadiusparameter instead - The example now targets Web and iOS only; the Android/macOS platform folders were removed
FlPageViewControllerindex conversion is now consistent forinitial != 0and non-loop modeFlCounter.stopTiming()no longer triggersonEnds; only natural completion doesFlSwitchdrag threshold now uses the logical position instead of the curved visual valueFlRatingStarsclipping now followsTextDirection(RTL support)FlScreenAdaptationreads the nearestMediaQuerysize, falling back to the window sizeflEventListen()now returns a cancellableStreamSubscriptionFlEventBus.emitnow dispatches subscribers in subscription order instead of reverse order
Added #
- Chinese API documentation for public classes, fields and methods
- Regression tests covering lifecycle, animation, paging, input, display and event edge cases
FlIndicator.activeSizenow participates in active-dot renderingFlShimmerysupports a custom number of gradient colorsFlPageView.stopAutoPlay()is persistent; autoplay no longer resumes after manual navigationFlLinearProgressanimation now respects the configuredcurve- Non-loop autoplay wraps to the first page with
jumpToPageinstead of rewinding - Example gallery rewritten with one page per component category and usage comments
Fixed #
- Core:
FlEvent.on<E>()filters byE;FlEvent.listenreturns a subscription;flEventDestroycan be reused; theFlScreenAdaptationbuilder receives the scope context;FlEventBus.emitis safe when callbacks remove other listeners; globalflEventListenis cancellable - Animation:
FlBubbleButtonandFlElasticBuilderno longer recreate controllers withSingleTickerProviderStateMixin;FlBubbleButtontoggles by default;FlExpansionTilesno longer collapses on unrelated rebuilds or invokes callbacks during build, and its background color now wraps a transparentMaterialsoListTilebackground/ink stays visible;FlAnimationCountermerges back to a single text after thepartanimation;FlFlipCard.hintis dispose-safe andonFlipEndonly fires after a real flip;FlFlipCardStatefulignores taps during a running flip;FlShimmerDirection.fromRBLT()starts from the bottom-right corner;FlToggleRotatehandles mid-animation direction changes;FlMultiPopupMenuButtonrebuilds after selection;FlAutoCollapsingBuildersyncs its initial scroll offset;FlAnimationWavedisposes listeners and guards unbounded sizes - Paging:
FlPageViewindex math forinitial/non-loop mode; controller replacement andhasClientsguards; autoplay interval changes and persistent stop; non-loop wrap;getPage()/autoplay guard against a null page; autoplay pauses while the app is in the background and resumes on return; autoplay no longer stops permanently after an interrupted animation or whenScrollEndNotificationarrives beforeUserScrollNotification;FlPageViewTransformno longer requires aPageStorageancestor;FlIndicator.activeSize, empty counts and negative progress; the indicator canvas now reserves room for a larger active dot (no clipping or overflow) and repaints whenactiveSizechanges - Feedback:
FlLinearProgresscontroller creation, curve application, rebuild restarts and unbounded width;FlShimmeryandFlLinearProgressreuse their controller whenenabled/animationordurationchanges instead of recreating a ticker;FlLinearProgress.repeatno longer spins whenpercentis 0;FlShimmerycustom color counts, zero interval and duration/interval updates - Input:
FlPINTextFieldwhitespace handling, grapheme splitting,onDone,obscureText, controller changes and bounded width inside unbounded rows;FlNumberLimitFormatteranchoring and leading-dot rejection;FlDecoratorBoxpendant rendering, unbounded width, hidden-pendant spacing, multiple-pendant spacing andneedFocus/needEditing/needValuechecks for builder pendants;FlRatingStarsstep clamping, RTL clipping and hit behavior;FlSwitchsize constraints, drag threshold, thumb geometry and slow-drag release animation - Display:
FlWrappertop/left spines now attach to the body edge without a gap, andspineRadiussmoothly rounds the tip and both junctions;FlDottedLinePainteredge inset, right border, first dash, negative-direction support, rounded corners, independent dash length and round stroke caps;FlDottedLineBorderinset and zero-length protection - Timing:
FlCounter.stopTiming()immediately rebuilds soisRunningreflects the stopped state - Example: Flutter 3.47 Web/iOS platform templates, Chinese comments and categorized gallery; back navigation force-pops the page instead of looping between
PopScopeandmaybePop - Removed the unused
carousel/carousel_controller.dartorphan file and the example dependency onfl_extended