Document the Select component listboxOverflow

[acelaya]

The listboxOverflow prop was added in #1746. This PR documents it and adds examples.

listbox-overflow-docs-2024-10-28_14.45.50.mp4

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (903b9ac) to head (3ebacea).
Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #1754   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           67        67           
  Lines         1205      1205           
  Branches       454       454           
=========================================
  Hits          1205      1205           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[robertknight]

Suggested change

	Determines the behavior of the listbox options when their
	Determines the behavior of the listbox options when their

"options" or "items"? The component is called Select.Option but code examples tend to use the term "items" for the data arrays from which the options are generated.

[acelaya]

I think I would use "items" when conceptually talking about the entries of the list, and "options" when talking about the markup elements explicitly.

In this case, since we are talking about how they render, I think I would use "options".

But this is not a strong opinion, and I see a lot of grey areas in that reasoning, so I'm ok using a different wording.

[robertknight]

I think I would use "items" when conceptually talking about the entries of the list, and "options" when talking about the markup elements explicitly.

That makes sense.