gem-hunter
Language: JavaScript
A smart popover component for React
react-popover >= 0.5.0 supports React 16 while react-popover < 0.5.0 works with React 15.x.x and likely lower. There is no plan to support older versions of this library with back-ported patches and PRs for that purpose are not welcome since it increases maintenance for the authors.
Look at the stories in our storybook.
Sets a preference of where to position the Popover. Only useful to specify placement in case of multiple available fits. Defaults to null. Valid values are:
above | right | below | left Prefer an explicit side.
row | column Prefer an orientation.
start | end Prefer an order.
null No preference, automatic resolution. This is the default.
Like preferPlace except that the given place is a requirement. The resolver becomes scoped or disabled. It is scoped if the place is an orientation or order but disabled if it is a side. For example place: "row" scopes the resolver to above or below placement but place: "above" removes any need for the resolver.
A callback function executed every time the user does an action (mousedown or touchstart) outside the DOM tree of both Popover and Target. A canonical use-case is to automatically close the Popover on any external user action.
The polling speed (AKA time between each poll) in milliseconds for checking if a layout refresh is required. This polling is required because it is the only robust way to track the position of a target in the DOM. Defaults to 200. Set to a falsey value to disable.
The amount of time in milliseconds that it takes to complete the enter and exit animation. Defaults to '500'.
Defines the size of the tip pointer. Use .01 to disable tip. Defaults to '7'.
The React Element that this popover will orient itself around. target rendering tree is unaffected. Popover will become its owner.
The DOM element which the portal will mount into. In effect the popover will become an appended child of this DOM element. Defaults to 'document.body'.