Tldraw/packages/tldraw/src/lib/ui/components/Toolbar
alex adebb680e5
Component-based toolbar customisation API (#3067)
When we went from overrides-based to component based UI customisation
APIs, we didn't do the toolbar because it had some significant extra
complexity around overflowing the contents of the menu into the
dropdown. This is really hard to do at render-time with react - you
can't introspect what a component will return to move some of it into an
overflow.

Instead, this diff runs that logic in a `useLayoutEffect` - we render
all the items into both the main toolbar and the overflow menu, then in
the effect (or if the rendered components change) we use CSS to remove
the items we don't need, check which was last active, etc. Originally, I
wasn't really into this approach - but i've actually found it to work
super well and be very reliable.

### Change Type

- [x] `major` — Breaking change
- [ ] `dependencies` — Changes to package dependencies[^1]
- [ ] `documentation` — Changes to the documentation only[^2]
- [ ] `tests` — Changes to any test code only[^2]
- [ ] `internal` — Any other changes that don't affect the published
package[^2]
- [ ] I don't know

[^1]: publishes a `patch` release, for devDependencies use `internal`
[^2]: will not publish a new version

### Test Plan

1. Test the toolbar at many different sizes with many different 'active
tools'

---------

Co-authored-by: Steve Ruiz <steveruizok@gmail.com>
2024-03-12 16:14:28 +00:00
..
DefaultToolbar.tsx Component-based toolbar customisation API (#3067) 2024-03-12 16:14:28 +00:00
DefaultToolbarContent.tsx Component-based toolbar customisation API (#3067) 2024-03-12 16:14:28 +00:00
OverflowingToolbar.tsx Component-based toolbar customisation API (#3067) 2024-03-12 16:14:28 +00:00
ToggleToolLockedButton.tsx E2e tests for the toolbar (#2709) 2024-02-16 14:15:00 +00:00