https://github.com/needim/react-useoverlay
if floating-ui and framer-motion had a baby
https://github.com/needim/react-useoverlay
floating floating-ui tooltip
Last synced: about 1 year ago
JSON representation
if floating-ui and framer-motion had a baby
- Host: GitHub
- URL: https://github.com/needim/react-useoverlay
- Owner: needim
- License: mit
- Created: 2022-06-23T23:53:15.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-07-30T18:16:09.000Z (almost 4 years ago)
- Last Synced: 2025-04-11T05:13:52.780Z (about 1 year ago)
- Topics: floating, floating-ui, tooltip
- Language: TypeScript
- Homepage: https://needim.github.io/react-useoverlay/
- Size: 1.89 MB
- Stars: 12
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Create floating things easily
useOverlay uses floating-ui and framer-moting under the hood, giving you an API that provides great usability.
> **Warning** Documentation is not complete!
> useOverlay is a very fresh hook. API can be changed.
> **Note** You should know!
> For styling useOverlay doesn't do anything than passing className parameter to floating overlay for now. You can use Tailwind or some other solutions.
```console
npm install react-useoverlay
```
## Why Floating UI?
> Floating UI is a tiny, low-level library for creating "floating" elements.
The library provides two key functionalities:
### 1. Anchored positioning primitives
> CSS is currently missing a feature called “anchored positioning” — the ability to anchor an element (like a tooltip) to another one (like a button) while simultaneously keeping it in view as best as possible by avoiding clipping and overflow.
> Attempting to do fully dynamic anchored positioning with today’s plain CSS is not possible. Floating UI provides a JavaScript implementation of this feature.
### 2. User interaction primitives
> When creating a popover, dropdown menu, select, or combobox component that follows WAI-ARIA authoring practices, the complexity increases dramatically. Focus traps, indexed navigation, and typeahead are difficult to get right.
This functionality is currently available for React DOM but will be made agnostic in the future.
---
## Why framer-motion?
### 1. Production-ready motion library for React
> Utilize the power behind Framer, the best prototyping tool for teams. Proudly open source.
### 2. Simple declarative syntax means you write less code
> Less code means your codebase is easier to read and maintain. Animations that work like magic. When animating between two separate components, Framer Motion will take care of everything in between.
---
## Why useOverlay?
### 1. Because it simplifies the API you need to deal with it.
> That's it.
## Use cases
- If you don't wanna handle all the logic of floating elements
- If you are building your own UI Library
- If you wanna create a custom build floating overlays