react-float-anchor

react-float-anchor

This is a React component for anchoring a fixed position element, such as a dropdown menu, to the edge of an element on the page. The fixed position element will automatically be placed so that it fits on the screen if possible, and it will automatically reposition if needed when the user scrolls.

The above example can be tried here:

https://streakyc.github.io/react-float-anchor/example/

You can find its code in the example directory. The example may be compiled by running:

npm install
npm run example-build

You can build the example with live editing enabled (using react-transform-hmr and browserify-hmr) by running:

npm run example-watch

FloatAnchor

This module exports the FloatAnchor React component, which takes the following props:

• anchor must be a single React Element. This element will be placed in the page where the FloatAnchor element was used, with no added wrapper elements around it.
• float must be null or a single React Element. This element will be placed in a container div which has position:fixed styling, is attached directly to the document body, and is positioned to line up with the anchor element.
• options is an optional object of options to control how the float element is aligned to the anchor element. The options are the same as those supported by contain-by-screen (version ^1.0).

The FloatAnchor component has a reposition method, which you should call if you change the size of the contents of the anchor or float elements.

Related

If you want interactive dropdown menus, check out the react-menu-list module that is built with this!

Types

Flow Type declarations for this module are included! As of Flow v0.22, you must add the following entries to your .flowconfig file's options section for them to work:

[options]
esproposal.class_static_fields=enable
esproposal.class_instance_fields=enable

Changelog

1.0.0 (2016-03-30)

Initial stable release.