find_in_page 0.3.0
find_in_page: ^0.3.0 copied to clipboard
Ctrl+F for Flutter: a find-in-page bar that highlights every match across your widgets, jumps between them, and scrolls the active match into view.
0.3.0 #
- Add
FindableListView, aListView.builderwhose whole backing list is searchable, not just the items currently built. PlainListView.builder+FindableTextonly ever registers the handful of items in the build/cache area; scrolling registers and unregisters items as they build and dispose, somatchCountdrifts mid-session and anything scrolled past is missed entirely.FindableListViewreads each item's text straight from the backing data up front, so the full list counts towardmatchCountregardless of what is built, and scrolling does not change it. Revealing a match animates aScrollControllerto the item's index instead ofScrollable.ensureVisible, since an off-screen item has no live widget; see the class docs for the itemExtent requirement this implies. - Add
FindableRecord, theFindableSourceused byFindableListView: text supplied directly instead of read from a live widget, with nofindableContext. - Add an optional
revealcallback toFindInPageController.register, for sources that cannot provide a livefindableContext. Non-breaking: existingregister(source)calls are unaffected.
0.2.0 #
- The match counter is now announced to screen readers. It is the find bar's
entire feedback loop, and it was visual only: focus stays in the query field
while typing, so a screen reader never reached the counter and the user had
no way to tell whether a query matched anything or which match they were on.
FindBarmarks it a live region and announces "Match 1 of 3" or "No matches" as the count and active match change, keeping the terse1/3out of the announcement since it reads badly aloud while staying on screen. - Add
FindBar.matchStatusLabelto localize that announcement, defaulting to English as the existing tooltips do.
0.1.3 #
- Docs: sharpen the pub.dev description to lead with the value and the terms people search.
0.1.2 #
- Fix the demo GIF in the README, which used a relative path and did not render on the pub.dev package page. It now uses the same absolute raw URL as the banner.
0.1.1 #
- Docs: tightened the README wording and visuals.
0.1.0 #
Initial release.
FindInPageScope: Ctrl+F / Cmd+F opens a find bar overlay, Escape closes it; provides the controller to descendants.FindableText:Textreplacement (supports the commonTextparameters) with match highlighting and a distinct active-match color.FindBar: standalone Material search bar with a match counter and previous/next/close controls.FindInPageController: query, case sensitivity, match list, wrapping navigation, and scroll-into-view for the active match.FindableSource: interface for making custom widgets searchable.
