Sdílet prostřednictvím

Vytvoření vizuálu

  • Článek

Toto rozhraní API poskytuje způsob, jak vytvořit nový vizuál na stránce sestavy.

Jak vytvořit vizuál a svázat ho s daty

Vytvořte prázdný vizuál určitého typu a pak vytvořte vazbu vizuálu na datová pole. Seznam typů vizuálů najdete předefinovaných typů vizuálů.

Poznámka

Do sestavy nelze přidat vizuály, které nejsou nainstalované v podokně vizualizace. To platí pro vlastní vizuály, které nejsou nainstalované, i u předinstalovaných vizuálů.

  1. Pomocí následujících parametrů nakonfigurujte vizuál, který chcete vytvořit:

    • typ vizuálu: Typ vizuálu, který chcete vytvořit, například barChart.
    • Rozložení (volitelné): Rozložení, které se má použít pro nový vizuál.
    • autoFocus (volitelné): Zvolte, jestli se stránka automaticky posune na nově vytvořený vizuál (ve výchozím nastavení je nastavená na True).

  2. K vytvoření vizuálu použijte následující metodu:

    createVisual(visualType: string, layout?: models.IVisualLayout, autoFocus?: boolean): Promise<models.ICreateVisualResponse>

Vrácená hodnota obsahuje objekt, který představuje nově vytvořený vizuál. K úpravě vizuálu můžete použít vizuální datové vazby a vlastnosti vizuálu rozhraní API.

Například:

let createVisualResponse = await page.createVisual('areaChart');
let visual = createVisualResponse.visual;

Příklady kódu

Následující příklady kódu ukazují, jak vytvářet vizuály s různými parametry.

Poznámka

Informace o vytváření vlastních rozložení naleznete v tématu Vizuální rozložení.

Vytvoření vizuálu plošného grafu s vlastním rozložením a bez fokusu

const customLayout = {
    x: 20,
    y: 35,
    width: 1600,
    height: 1200
}

let createVisualResponse = await page.createVisual('areaChart', customLayout, false /* autoFocus */);

Vytvořte plošný graf s výchozím rozložením.

let createVisualResponse = await page.createVisual('areaChart');

Dostupné předefinované typy vizuálů

  • actionButton

  • areaChart

  • barChart

  • basicShape

  • karta

  • clusteredBarChart

  • clusteredColumnChart

  • columnChart

  • debugVisual

  • Rozkladový strom

  • prstencový graf

  • esriVisual

  • filledMap

  • trychtýř

  • měřidlo

  • setPercentStackedBarChart

  • stovkaPercentStackedColumnChart

  • obraz

  • keyDriversVisual

  • Klíčový ukazatel výkonu

  • lineChart

  • lineClusteredColumnComboChart

  • lineStackedColumnComboChart

  • mapa

  • multiRowCard

  • výsečový graf

  • kontingenční tabulka

  • PowerApps

  • PythonVisual

  • qnaVisual

  • ribbonChart

  • bodový graf

  • scriptVisual

  • shapeMap

  • kráječ

  • stackedAreaChart

  • tableEx

  • textové pole

  • mapa stromové struktury

  • vodopádový graf

Důležité informace a omezení

Rozhraní API pro vytváření vizuálů jsou k dispozici až po vykreslení sestavy. Poslechněte si událost rendered sestavy a aktivujte rozhraní API pro vytváření vizuálů až po jejím zavolání. Další informace najdete v tématu zpracování událostí.

Související obsah