Add onVisibilityChange, update README

Author: denisborovikov

README.md

@@ -154,14 +154,22 @@ the section "[Children and tooltip functions](#children-and-tooltip-functions)".
 
 This is the initial visibility state of the tooltip.
 
+### onVisibilityChange
+
+> `function(tooltipShown: boolean)`
+
+Called when the visibility of the tooltip changes. `tooltipShown` is a new state.
+
 ### tooltipShown
 
 > `boolean` | **control prop**
 
 Use this prop if you want to control the visibility state of the tooltip.
 
-Package manages its own state internally. You can use this prop to pass the visibility state of the
-tooltip from the outside.
+`react-popper-tooltip` manages its own state internally. You can use this prop to pass the 
+visibility state of the tooltip from the outside. You will be required to keep this state up to 
+date (this is where `onVisibilityChange` becomes usefull), but you can also control the state 
+from anywhere, be that state from other components, `redux`, `react-router`, or anywhere else.
 
 ### delayShow
 
@@ -221,15 +229,6 @@ Modifiers, applied by default:
 }
 ```
 
-You also have the ability to attach ref to the `TooltipTrigger` component which exposes following 
-methods for programmatic control of the tooltip:
-- `showTooltip` (show immediately)
-- `hideTooltip` (hide immediately)
-- `toggleTooltip` (toggle immediately)
-- `scheduleShow` (show respecting delayShow prop)
-- `scheduleHide` (hide respecting delayHide prop)
-- `scheduleToggle` (toggle respecting delayShow and delayHide props)
-
 ## Children and tooltip functions
 
 This is where you render whatever you want. `react-popper-tooltip` uses two render props `children`

src/TooltipTrigger.js

@@ -6,7 +6,7 @@ import { createPortal } from 'react-dom';
 import T from 'prop-types';
 import { Manager, Reference, Popper } from 'react-popper';
 import Tooltip from './Tooltip';
-import { callAll } from './utils';
+import { callAll, noop } from './utils';
 
 const DEFAULT_MODIFIERS = {
   preventOverflow: {
@@ -35,6 +35,10 @@ export default class TooltipTrigger extends PureComponent {
      * use to create controlled tooltip
      */
     tooltipShown: T.bool,
+    /**
+     * use to create controlled tooltip
+     */
+    onVisibilityChange: T.func,
     /**
      * delay in showing the tooltip
      */
@@ -77,11 +81,34 @@ export default class TooltipTrigger extends PureComponent {
     defaultTooltipShown: false,
     placement: 'right',
     trigger: 'hover',
-    closeOnOutOfBoundaries: true
+    closeOnOutOfBoundaries: true,
+    onChange: noop
   };
 
   state = {
-    tooltipShown: this.props.defaultTooltipShown
+    tooltipShown: this._isControlled()
+      ? undefined
+      : this.props.defaultTooltipShown || false
+  };
+
+  _isControlled() {
+    return this.props.tooltipShown !== undefined;
+  }
+
+  _getState() {
+    return this._isControlled()
+      ? this.props.tooltipShown
+      : this.state.tooltipShown;
+  }
+
+  _setTooltipState = state => {
+    const cb = () => this.props.onVisibilityChange(state);
+
+    if (this._isControlled()) {
+      cb();
+    } else {
+      this.setState({ tooltipShown: state }, cb);
+    }
   };
 
   _clearScheduled = () => {
@@ -91,37 +118,24 @@ export default class TooltipTrigger extends PureComponent {
 
   _showTooltip = (delay = this.props.delayShow) => {
     this._clearScheduled();
-
-    this._showTimeout = setTimeout(
-      () => this.setState({ tooltipShown: true }),
-      delay
-    );
+    this._showTimeout = setTimeout(() => this._setTooltipState(true), delay);
   };
 
   _hideTooltip = (delay = this.props.delayHide) => {
     this._clearScheduled();
-
-    this._hideTimeout = setTimeout(
-      () => this.setState({ tooltipShown: false }),
-      delay
-    );
+    this._hideTimeout = setTimeout(() => this._setTooltipState(false), delay);
   };
 
   _toggleTooltip = delay => {
-    const action = this.state.tooltipShown ? '_hideTooltip' : '_showTooltip';
+    const action = this._getState() ? '_hideTooltip' : '_showTooltip';
     this[action](delay);
   };
 
   _contextMenuToggle = event => {
     event.preventDefault();
-    this.scheduleToggle();
+    this._toggleTooltip();
   };
 
-  static getDerivedStateFromProps(props) {
-    const { tooltipShown } = props;
-    return tooltipShown != null ? { tooltipShown } : null;
-  }
-
   componentWillUnmount() {
     this._clearScheduled();
   }
@@ -143,7 +157,7 @@ export default class TooltipTrigger extends PureComponent {
         props.onMouseEnter
       ),
       onMouseLeave: callAll(
-        isHoverTriggered && this._hideTooltip(),
+        isHoverTriggered && this._hideTooltip,
         props.onMouseLeave
       )
     };
@@ -166,7 +180,7 @@ export default class TooltipTrigger extends PureComponent {
             children({ getTriggerProps: this.getTriggerProps, triggerRef: ref })
           }
         </Reference>
-        {this.state.tooltipShown &&
+        {this._getState() &&
           createPortal(
             <Popper
               placement={placement}

src/utils.js

@@ -1,2 +1,4 @@
 export const callAll = (...fns) => (...args) =>
   fns.forEach(fn => fn && fn(...args));
+
+export const noop = () => {};