flutter/examples/api/lib/material
Kate Lovett df676dc6e7
Add onHover and onFocusChange callbacks for TabBar (#164816)
Fixes https://github.com/flutter/flutter/issues/159444
Fixes https://github.com/flutter/flutter/issues/146089

This adds callbacks to TabBar for onHover and onFocusChange.
They pipe through to the underlying Inkwell widget that is wrapped
around each Tab of the TabBar during build.

#### Alternatives

- I did consider adding these callbacks to Tab instead, but felt that
going through TabBar would be better. If implemented in Tab, the user
would need to define callbacks for each tab. This PR makes it so there
is only need for one callback, and the associated Tab index is provided.
Also, since the Inkwell is applied in the TabBar, it's kludgy to have to
extract that from the Tabs _in_ TabBar later to pass on to the Inkwell.
👃
- Digging in to the requests in the linked issues, the user wants to
change various stylings in response to these events.
WidgetStateProperties were considered, but there are so many potential
styling properties that going this route would require greatly
increasing the API surface here. Tab.child allows the user to provide
whatever widget they would like to have as the content. Being able to
modify Tab.child in response to these events is a better way go instead
of exposing a ton of different properties.

## Pre-launch Checklist

- [x] I read the [Contributor Guide] and followed the process outlined
there for submitting PRs.
- [x] I read the [Tree Hygiene] wiki page, which explains my
responsibilities.
- [x] I read and followed the [Flutter Style Guide], including [Features
we expect every widget to implement].
- [x] I signed the [CLA].
- [x] I listed at least one issue that this PR fixes in the description
above.
- [x] I updated/added relevant documentation (doc comments with `///`).
- [x] I added new tests to check the change I am making, or this PR is
[test-exempt].
- [x] I followed the [breaking change policy] and added [Data Driven
Fixes] where supported.
- [x] All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel
on [Discord].

<!-- Links -->
[Contributor Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview
[Tree Hygiene]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md
[test-exempt]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests
[Flutter Style Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md
[Features we expect every widget to implement]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement
[CLA]: https://cla.developers.google.com/
[flutter/tests]: https://github.com/flutter/tests
[breaking change policy]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes
[Discord]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md
[Data Driven Fixes]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md
2025-03-13 01:32:05 +00:00
..
about Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
action_buttons Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
action_chip Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
animated_icon Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
app const AnimationStyle (#160564) 2025-01-22 21:52:11 +00:00
app_bar Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
autocomplete Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
badge Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
banner Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
bottom_app_bar Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
bottom_navigation_bar Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
bottom_sheet const AnimationStyle (#160564) 2025-01-22 21:52:11 +00:00
button_style Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
button_style_button Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
card Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
carousel Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
checkbox Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
checkbox_list_tile Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
chip const AnimationStyle (#160564) 2025-01-22 21:52:11 +00:00
choice_chip Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
color_scheme Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
context_menu Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
data_table Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
date_picker Added calendar delegate to support custom calendar systems (#161874) 2025-03-08 02:41:17 +00:00
dialog Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
divider Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
drawer Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
dropdown Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
dropdown_menu Fix DropdownMenu example RenderFlex overflowed error (#162558) 2025-02-07 10:04:14 +00:00
elevated_button Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
expansion_panel Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
expansion_tile const AnimationStyle (#160564) 2025-01-22 21:52:11 +00:00
filled_button Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
filter_chip Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
flexible_space_bar Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
floating_action_button Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
floating_action_button_location Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
icon_button Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
ink Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
ink_well Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
input_chip Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
input_decorator Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
list_tile Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
material_state Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
menu_anchor Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
navigation_bar Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
navigation_drawer Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
navigation_rail Fix NavigationRail examples overflow alignment (#159937) 2025-01-31 15:29:25 +00:00
outlined_button Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
page_transitions_theme Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
paginated_data_table Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
platform_menu_bar Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
popup_menu const AnimationStyle (#160564) 2025-01-22 21:52:11 +00:00
progress_indicator Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
radio Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
radio_list_tile Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
range_slider Rename Sample classes (#124080) 2023-04-04 20:34:29 +00:00
refresh_indicator Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
reorderable_list Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
scaffold const AnimationStyle (#160564) 2025-01-22 21:52:11 +00:00
scrollbar Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
search_anchor Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
segmented_button Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
selectable_region Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
selection_area Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
selection_container Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
slider Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
snack_bar Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
stepper Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
switch Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
switch_list_tile Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
tab_controller Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
tabs Add onHover and onFocusChange callbacks for TabBar (#164816) 2025-03-13 01:32:05 +00:00
text_button Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
text_field Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
text_form_field Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
theme Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
theme_data Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
time_picker Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
toggle_buttons Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
tooltip Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
widget_state_input_border Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00