tuxx/src/TuxxGetOwnerPropsMixin.js

Framework built on React and Flux

//getOwnerPropsMixin OBJECT: adds mixin to React class that will attach the nearestOwner's __tuxxOwnerProps__ under the key of nearestOwnerProps
//If component is a tuxx Owner Component:
//expected Key:
// registerOwnerProps FUNCTION: returns an OBJECT that represents the properties the owner will expose to its direct Ownees. The function will be invoked with the context of the owner component
module.exports = {
  //add property under componentWillMount so that other lifecycle methods will be able to access it
  componentWillMount: function () {
    var owner = this._reactInternalInstance._currentElement._owner;
    //if the owner is an OwnerComponent get its __tuxxOwnerProps__, otherwise get its nearestOwnerProps
    while (owner) {
      // if there is an owner get its _instance
      owner = owner._instance;

      //approach takes advantage of cascading order of componentWillMount invocations.  Since componentWillMount is called on an owner before its ownee, a component can just read from its owner to get the needed props
      var nearestOwnerProps = owner.nearestOwnerProps;
      if (owner.__tuxxIsOwnerComponent__) {
        this.nearestOwnerProps = owner.__tuxxOwnerProps__;
        break;
      } else if (nearestOwnerProps) {
        this.nearestOwnerProps = nearestOwnerProps;
        break;
      }
      owner = owner._reactInternalInstance._currentElement._owner;
    }
    //if this component is an owner component and its ownerProps have not been registered already
    if (this.__tuxxIsOwnerComponent__ && !this.__tuxxOwnerProps__) {
      //invoke registerOwnerProps after getting nearestOwnerProps so that owner can cascade down nearestOwnerProps to its direct Ownees
      var __tuxxOwnerProps__ = this.registerOwnerProps.call(this);
      //assign object to key of __tuxxOwnerProps__ on component
      this.__tuxxOwnerProps__ = __tuxxOwnerProps__;
    }
  }
};