Function calcBandWidthForNumericAxis

src/coord/axisBand.ts:157–209

(
    out: AxisBandWidthResult,
    axis: Axis,
    scaleLinearSpan: number,
    pxSpan: number,
    fromStat: CalculateBandWidthOpt['fromStat'],
)

}

function calcBandWidthForNumericAxis(
    out: AxisBandWidthResult,
    axis: Axis,
    scaleLinearSpan: number,
    pxSpan: number,
    fromStat: CalculateBandWidthOpt['fromStat'],
): void {

    if (__DEV__) {
        assert(fromStat);
    }

    let onlySingular = false;
    let bandWidthInData = -Infinity;
    each(
        fromStat.key
            ? [getAxisStat(axis, fromStat.key)]
            : getAxisStatBySeries(axis, fromStat.sers || []),
        function (stat) {
            const liPosMinGap = stat.liPosMinGap;
            // NOTE: `liPosMinGap == null` may indicate that `requireAxisStatistics`
            // is not used by any series on this axis. We should not make `bandWidth`
            // for this case.
            if (liPosMinGap != null) {
                if (liPosMinGap > 0) {
                    if (liPosMinGap > bandWidthInData) {
                        bandWidthInData = liPosMinGap;
                    }
                    onlySingular = false;
                }
                else if (liPosMinGap === LINEAR_POSITIVE_MIN_GAP_SINGLE_VALID_VALUE) {
                    onlySingular = true;
                }
            }
        }
    );

    if (isNullableNumberFinite(scaleLinearSpan) && scaleLinearSpan > 0
        && isNullableNumberFinite(bandWidthInData)
    ) {
        out.w = pxSpan / scaleLinearSpan * bandWidthInData;
        out.w2 = bandWidthInData;
    }
    else if (onlySingular) {
        // This is the special handing for single value case, where min gap can not
        // be calculated, but `w` and `w2` (for "containShape") are still needed.
        out.w = pxSpan * FALLBACK_BAND_WIDTH_RATIO;
        out.w2 = out.w * scaleLinearSpan / pxSpan;
        // Consider an axis has both candlestick and bar series, where candlestick has multiple data
        // but the bar series has no data. In this case, that bar series should be ignored; otherwise,
        // the axis will be significantly expanded by "containShape" but no bar shape displayed.
    }
}