How to use Tether with React

README.md

Tether is a great library for positioning stuff (tooltips, modals, hints, etc) in your web app.

But, as I use React, it was pretty problematic for me, as Tether mutates the DOM and React breaks miserably when it sees mutated DOM. The solution is to have the tethered element outside the part of the DOM tree which is controlled by React (in this case, I use document.body).

That's why I created 2 helpers to use Tether with React.

The first one, TetheredElement is a plain JS helper to create a new element, attach it to some other one via Tether, and populate it with some React component.

The second one, TetherTarget is a React component and it uses TetheredElement to integrate it further with React, so that you can attach components to each other with Tether, without leaving the cozy React/JSX world and worrying about manual DOM operations. Just write:

var tetherOptions = {
    // element and target are set automatically
    attachment: 'top center',
    constraints: [
        {to: 'window', pin: true, attachment: 'together'},
    ],
};
<TetherTarget tethered={ <i>I'm tethered!</i> } tetherOptions={ tetherOptions }>
    <h1>Hello world! I'm a big box, which is the Tether target!</h1>
</TetherTarget>

Comments are welcome :)

TetheredElement.js

'use strict';

var _ = require('lodash');
var React = require('react');
var Tether = require('tether-browserify/tether');


// NOTE: This is not a React component. It's a plain JS object that manages a React component.

function TetheredElement(reactComponent, tetherOptions) {
    this.reactComponent = reactComponent;

    this.domNode = document.createElement('div');
    this.domNode.style.position = 'absolute'; // needed for Tether
    document.body.appendChild(this.domNode);

    this.tether = new Tether(_.merge({
        element: this.domNode,
    }, tetherOptions));

    this.update();
}
TetheredElement.prototype.update = function () {
    React.render(
        this.reactComponent,
        this.domNode,
        () => this.tether.position()
    );
};
TetheredElement.prototype.destroy = function () {
    React.unmountComponentAtNode(this.domNode);
    this.domNode.parentNode.removeChild(this.domNode);
    this.tether.destroy();
};

module.exports = TetheredElement;

TetherTarget.jsx

/** @jsx React.DOM */
'use strict';

var _ = require('lodash');
var React = require('react');

var TetheredElement = require('./TetheredElement');


var TetherTarget = React.createClass({
    propTypes: {
        tethered: React.PropTypes.node.isRequired,
        tetherOptions: React.PropTypes.object.isRequired
    },
    getInitialState: function () {
        return {tooltipVisible: false};
    },
    componentDidMount: function () {
        var tetherOptions = _.merge({
            target: this.getDOMNode(),
        }, this.props.tetherOptions);
        this.tethered = new TetheredElement(this.props.tethered, tetherOptions);
    },
    componentWillUnmount: function () {
        this.tethered.destroy();
    },
    componentDidUpdate: function () {
        this.tethered.update();
    },
    render: function () {
        var divProps = _.omit(this.props, ['tethered', 'tetherOptions']);
        return <div {... divProps }>
            { this.props.children }
        </div>;
    },
});

module.exports = TetherTarget;

Actually, you should try react-tether by @souporserious, much cleaner.