Function _relayout

src/plot_api/plot_api.js:1856–2204

(gd, aobj)

var AX_DOMAIN_RE = /^[xyz]axis[0-9]*\.domain(\[[0|1]\])?$/;

function _relayout(gd, aobj) {
    var layout = gd.layout;
    var fullLayout = gd._fullLayout;
    var guiEditFlag = fullLayout._guiEditing;
    var layoutNP = makeNP(fullLayout._preGUI, guiEditFlag);
    var keys = Object.keys(aobj);
    var axes = Axes.list(gd);
    var eventData = Lib.extendDeepAll({}, aobj);
    var arrayEdits = {};

    var arrayStr, i, j;

    keys = Object.keys(aobj);

    // look for 'allaxes', split out into all axes
    // in case of 3D the axis are nested within a scene which is held in _id
    for (i = 0; i < keys.length; i++) {
        if (keys[i].indexOf('allaxes') === 0) {
            for (j = 0; j < axes.length; j++) {
                var scene = axes[j]._id.slice(1);
                var axisAttr = scene.indexOf('scene') !== -1 ? scene + '.' : '';
                var newkey = keys[i].replace('allaxes', axisAttr + axes[j]._name);

                if (!aobj[newkey]) aobj[newkey] = aobj[keys[i]];
            }

            delete aobj[keys[i]];
        }
    }

    // initialize flags
    var flags = editTypes.layoutFlags();

    // copies of the change (and previous values of anything affected)
    // for the undo / redo queue
    var redoit = {};
    var undoit = {};

    // for attrs that interact (like scales & autoscales), save the
    // old vals before making the change
    // val=undefined will not set a value, just record what the value was.
    // attr can be an array to set several at once (all to the same val)
    function doextra(attr, val) {
        if (Array.isArray(attr)) {
            attr.forEach(function (a) {
                doextra(a, val);
            });
            return;
        }

        // if we have another value for this attribute (explicitly or
        // via a parent) do not override with this auto-generated extra
        if (attr in aobj || helpers.hasParent(aobj, attr)) return;

        var p = layoutNP(layout, attr);
        if (!(attr in undoit)) {
            undoit[attr] = undefinedToNull(p.get());
        }