Function injectCoordSysByOption

src/core/CoordinateSystem.ts:290–347

(opt: {
    // series or component
    targetModel: ComponentModel;
    coordSysType: string;
    coordSysProvider: CoordSysInjectionProvider;
    isDefaultDataCoordSys?: boolean;
    allowNotFound?: boolean
})

 *  once for each series/components.
 */
export function injectCoordSysByOption(opt: {
    // series or component
    targetModel: ComponentModel;
    coordSysType: string;
    coordSysProvider: CoordSysInjectionProvider;
    isDefaultDataCoordSys?: boolean;
    allowNotFound?: boolean
}): CoordinateSystemUsageKind {
    const {
        targetModel,
        coordSysType,
        coordSysProvider,
        isDefaultDataCoordSys,
        allowNotFound,
    } = opt;
    if (__DEV__) {
        zrUtil.assert(!!coordSysType);
    }

    let {kind, coordSysType: declaredType} = decideCoordSysUsageKind(targetModel, true);

    if (isDefaultDataCoordSys
        && kind !== COORD_SYS_USAGE_KIND_DATA
    ) {
        // If both `COORD_SYS_USAGE_KIND_DATA` and `COORD_SYS_USAGE_KIND_BOX` declared in one model.
        // There is the only case in series-graph, and no other cases yet.
        kind = COORD_SYS_USAGE_KIND_DATA;
        declaredType = coordSysType;
    }

    if (kind === COORD_SYS_USAGE_KIND_NONE || declaredType !== coordSysType) {
        return COORD_SYS_USAGE_KIND_NONE;
    }

    const coordSys = coordSysProvider(coordSysType, targetModel);
    if (!coordSys) {
        if (__DEV__) {
            if (!allowNotFound) {
                error(`${coordSysType} cannot be found for`
                    + ` ${targetModel.type} (index: ${targetModel.componentIndex}).`
                );
            }
        }
        return COORD_SYS_USAGE_KIND_NONE;
    }

    if (kind === COORD_SYS_USAGE_KIND_DATA) {
        if (__DEV__) {
            zrUtil.assert(targetModel.mainType === 'series');
        }
        (targetModel as SeriesModel).coordinateSystem = coordSys;
    }
    else { // kind === COORD_SYS_USAGE_KIND_BOX
        targetModel.boxCoordinateSystem = coordSys;
    }

    return kind;
}