Close the dropdown when the user clicks outside of it

[merkushin]

Related to #99090

There is an alternative of using useClickAway, but it is a new dependency.

Proposed Changes

• Handle the click outside the component and close the dropdown.

Why are these changes being made?

• Need to click on the component to close the dropdown, which is not a convenient UX.

Testing Instructions

• First, let's test WordPress.com hosting/domain purchase:
  • Go to /start, choose a paid product to appear on the Checkout step.
  • Open the dropdown with payment options.
  • Make sure you can close it by clicking outside the dropdown.
• There is also Akismet quantity dropdown, let's test it too:
  • Go to http://calypso.localhost:3000/checkout/akismet/ak_pro5h_yearly:-q-1
  • Test both dropdowns with payment period variants and number of licenses.
  • Make sure you can close each of them by clicking outside the dropdowns.

Pre-merge Checklist

• Has the general commit checklist been followed? (PCYsg-hS-p2)
• Have you written new tests for your changes?
• Have you tested the feature in Simple (P9HQHe-k8-p2), Atomic (P9HQHe-jW-p2), and self-hosted Jetpack sites (PCYsg-g6b-p2)?
• Have you checked for TypeScript, React or other console errors?
• Have you used memoizing on expensive computations? More info in Memoizing with create-selector and Using memoizing selectors and Our Approach to Data
• Have we added the "[Status] String Freeze" label as soon as any new strings were ready for translation (p4TIVU-5Jq-p2)?
  • For UI changes, have we tested the change in various languages (for example, ES, PT, FR, or DE)? The length of text and words vary significantly between languages.
• For changes affecting Jetpack: Have we added the "[Status] Needs Privacy Updates" label if this pull request changes what data or activity we track or use (p4TIVU-aUh-p2)?

[github-actions]

Calypso Live (direct link)

https://calypso.live?image=registry.a8c.com/calypso/app:build-131711

Jetpack Cloud live (direct link)

https://calypso.live?image=registry.a8c.com/calypso/app:build-131711&env=jetpack

Automattic for Agencies live (direct link)

https://calypso.live?image=registry.a8c.com/calypso/app:build-131711&env=a8c-for-agencies

[matticbot]

Here is how your PR affects size of JS and CSS bundles shipped to the user's browser:

Sections (~166 bytes added 📈 [gzipped])

name      parsed_size           gzip_size
checkout       +514 B  (+0.0%)     +166 B  (+0.0%)

Sections contain code specific for a given set of routes. Is downloaded and parsed only when a particular route is navigated to.

Async-loaded Components (~166 bytes added 📈 [gzipped])

name                                             parsed_size           gzip_size
async-load-calypso-my-sites-checkout-modal            +514 B  (+0.0%)     +166 B  (+0.0%)
async-load-calypso-blocks-editor-checkout-modal       +514 B  (+0.0%)     +166 B  (+0.1%)

React components that are loaded lazily, when a certain part of UI is displayed for the first time.

Legend

What is parsed and gzip size?

Parsed Size: Uncompressed size of the JS and CSS files. This much code needs to be parsed and stored in memory.
Gzip Size: Compressed size of the JS and CSS files. This much data needs to be downloaded over network.

Generated by performance advisor bot at iscalypsofastyet.com.

[matticbot]

This PR modifies the release build for the following Calypso Apps:

For info about this notification, see here: PCYsg-OT6-p2

• notifications

To test WordPress.com changes, run install-plugin.sh $pluginSlug fix/close-dropdown-on-click-away on your sandbox.

[sirbrillig]

Works as described! Thanks!

[mirka]

Any reason these dropdowns were implemented with low-level components, rather than something like CustomSelectControl? There are a lot of implementational details involved in a custom dropdown like this, including click away behavior as implemented here, but also Escape key handling, Tab key handling, typeahead, etc. that are still missing. It's a lot of extra work to do these correctly from scratch/low-level.