public withCategory()

in src/dataViewBuilder/dataViewBuilder.ts [125:157]


    public withCategory(options: DataViewBuilderCategoryColumnOptions): IDataViewBuilderCategorical {
        let categoryValues = options.values,
            identityFrom = options.identityFrom,
            sourceType = options.source.type;

        let categoryColumn: DataViewCategoryColumn = {
            source: options.source,
            identityFields: options.identityFrom.fields,
            identity: options.identityFrom.identities || [],
            values: categoryValues,
        };

        if (!options.identityFrom.identities) {
            for (let categoryIndex = 0, categoryLength = categoryValues.length;
                categoryIndex < categoryLength;
                categoryIndex++) {

                categoryColumn.identity.push(getScopeIdentity(
                    identityFrom,
                    categoryIndex,
                    categoryValues[categoryIndex],
                    sourceType));
            }
        }

        if (!this.categories) {
            this.categories = [];
        }

        this.categories.push(categoryColumn);

        return this;
    }