Поделиться через

Добавление цветов в визуальные элементы Power BI

  • Статья

В этой статье описывается, как добавить цвета в пользовательские визуальные элементы и как обрабатывать точки данных для визуального элемента с определенными цветами.

IVisualHostКоллекция свойств и служб, взаимодействующих с визуальным узлом, может определять цвета в пользовательских визуальных элементах со службой colorPalette . Пример кода в этой статье изменяет визуальный элемент SampleBarChart. Визуальный код SampleBarChart см. в разделе barChart.ts.

Чтобы приступить к созданию визуальных элементов, ознакомьтесь с разделом "Разработка круга Power BI" карта визуального элемента.

Добавление цвета в точки данных

Чтобы представить каждую точку данных в другом цвете, добавьте color переменную в BarChartDataPoint интерфейс, как показано в следующем примере:

/**
 * Interface for BarChart data points.
 *
 * @interface
 * @property {number} value    - Data value for point.
 * @property {string} category - Corresponding category of data value.
 * @property {string} color    - Color corresponding to data point.
 */
interface BarChartDataPoint {
    value: number;
    category: string;
    color: string;
};

Использование службы цветовой палитры

Служба colorPalette управляет цветами, используемыми в визуальном элементе. Экземпляр colorPalette службы доступен.IVisualHost

Определите цветовую палитру в методе с помощью следующего update кода:

constructor(options: VisualConstructorOptions) {
        this.host = options.host; // host: IVisualHost
        ...
    }

public update(options: VisualUpdateOptions) {

    let colorPalette: IColorPalette = host.colorPalette;
    ...
}

Назначение цвета точкам данных

Затем укажите dataPoints. В этом примере каждый из dataPoints них имеет определенное значение, категорию и свойство цвета. dataPoints также может включать другие свойства.

В SampleBarChartэтом visualTransform методе входит в модель представления линейчатой диаграммы. visualTransform Так как метод выполняет итерацию по всем dataPoints вычислениям, это идеальное место для назначения цветов, как показано в следующем коде:


public update(options: VisualUpdateOptions) {
    ....
    let viewModel: BarChartViewModel = visualTransform(options, this.host);
    ....
}

function visualTransform(options: VisualUpdateOptions, host: IVisualHost): BarChartViewModel {
    let colorPalette: IColorPalette = host.colorPalette; // host: IVisualHost
    for (let i = 0, len = Math.max(category.values.length, dataValue.values.length); i < len; i++) {
        barChartDataPoints.push({
            category: category.values[i],
            value: dataValue.values[i],
            color: colorPalette.getColor(category.values[i]).value,
        });
    }
}

Затем примените данные из dataPoints d3-selectionbarSelection внутри update метода:

// This code is for d3 v5
// in d3 v5 for this case we should use merge() after enter() and apply changes on barSelectionMerged
this.barSelection = this.barContainer
    .selectAll('.bar')
    .data(this.barDataPoints);

const barSelectionMerged = this.barSelection
    .enter()
    .append('rect')
    .merge(<any>this.barSelection);

barSelectionMerged.classed('bar', true);

barSelectionMerged
.attr("width", xScale.bandwidth())
.attr("height", d => height - yScale(<number>d.value))
.attr("y", d => yScale(<number>d.value))
.attr("x", d => xScale(d.category))
.style("fill", (dataPoint: BarChartDataPoint) => dataPoint.color)
.style("stroke", (dataPoint: BarChartDataPoint) => dataPoint.strokeColor)
.style("stroke-width", (dataPoint: BarChartDataPoint) => `${dataPoint.strokeWidth}px`);

this.barSelection
    .exit()
    .remove();

Связанный контент