plotly.js/src/traces/scatter/marker_defaults.js

The open source javascript graphing library that powers plotly

'use strict';

var Color = require('../../components/color');
var hasColorscale = require('../../components/colorscale/helpers').hasColorscale;
var colorscaleDefaults = require('../../components/colorscale/defaults');

var subTypes = require('./subtypes');

/*
 * opts: object of flags to control features not all marker users support
 *   noLine: caller does not support marker lines
 *   gradient: caller supports gradients
 *   noSelect: caller does not support selected/unselected attribute containers
 */
module.exports = function markerDefaults(traceIn, traceOut, defaultColor, layout, coerce, opts = {}) {
    var isBubble = subTypes.isBubble(traceIn);
    var lineColor = (traceIn.line || {}).color;
    var defaultMLC;

    // marker.color inherit from line.color (even if line.color is an array)
    if (lineColor) defaultColor = lineColor;

    coerce('marker.symbol');
    coerce('marker.opacity', isBubble ? 0.7 : 1);
    coerce('marker.size');
    if (!opts.noAngle) {
        coerce('marker.angle');
        if (!opts.noAngleRef) coerce('marker.angleref');
        if (!opts.noStandOff) coerce('marker.standoff');
    }

    coerce('marker.color', defaultColor);
    if (hasColorscale(traceIn, 'marker')) {
        colorscaleDefaults(traceIn, traceOut, layout, coerce, { prefix: 'marker.', cLetter: 'c' });
    }

    if (!opts.noSelect) {
        coerce('selected.marker.color');
        coerce('unselected.marker.color');
        coerce('selected.marker.size');
        coerce('unselected.marker.size');
    }

    if (!opts.noLine) {
        // if there's a line with a different color than the marker, use
        // that line color as the default marker line color
        // (except when it's an array)
        // mostly this is for transparent markers to behave nicely
        if (lineColor && !Array.isArray(lineColor) && traceOut.marker.color !== lineColor) {
            defaultMLC = lineColor;
        } else if (isBubble) {
            defaultMLC = Color.background;
        } else {
            defaultMLC = Color.defaultLine;
        }

        coerce('marker.line.color', defaultMLC);
        if (hasColorscale(traceIn, 'marker.line')) {
            colorscaleDefaults(traceIn, traceOut, layout, coerce, { prefix: 'marker.line.', cLetter: 'c' });
        }

        coerce('marker.line.width', isBubble ? 1 : 0);
        if (!opts.noLineDash) coerce('marker.line.dash');
    }

    if (isBubble) {
        coerce('marker.sizeref');
        coerce('marker.sizemin');
        coerce('marker.sizemode');
    }

    if (opts.gradient) {
        var gradientType = coerce('marker.gradient.type');
        if (gradientType !== 'none') coerce('marker.gradient.color');
    }
};