Make scrollbar assertions less aggressive

[Piinks]

This adjusts the assertions on interactive scrollbars to only be applied when the scrollbar is visible.

Related issues:

• Fixes Scrollbar throws due to recent assert changes #84735
• Auto-Scrollbars on Desktop are disabled gallery#523

This also adds more documentation and code samples. I cleaned up a bit, removing outstanding todos and fixing some abbreviations in the tests.

For some of the removed todos, I filed issues to actually track the feature requests. 🙃

• Expose more properties on RawScrollbar #84793
• Add support for a RawScrollbar.shape #84792

Pre-launch Checklist

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

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

[davidmartos96]

I like the proposed changes. Delaying the assertion to when the scrollbar has been interacted with, will help a lot to tell which scrollbar in the tree is incorrect. The error in the gallery project was a bit confusing.

[Piinks]

Delaying the assertion to when the scrollbar has been interacted with, will help a lot to tell which scrollbar in the tree is incorrect.

This should only delay it until it is visible and available for interaction. :)

[dnfield]

Thanks for the example, really helpful

Lgtm

[fluttergithubbot]

This pull request is not suitable for automatic merging in its current state.

• The status or check suite Linux analyze has failed. Please fix the issues identified (or deflake) before re-applying this label.
• The status or check suite Linux flutter_plugins has failed. Please fix the issues identified (or deflake) before re-applying this label.
• The status or check suite analyze-linux has failed. Please fix the issues identified (or deflake) before re-applying this label.