Kort for formateringsinnstillinger

Et kort for formateringsinnstillinger angir et formateringskort i formaterings- eller analyseruten. Et formateringsinnstillinger-kort kan inneholde flere formateringssektorer, beholdere, grupper og egenskaper.

Hvis du legger til sektorer på et formateringsinnstillingerkort, legges alle disse sektorene inn i ett formateringskort.

Kort, sektorer og grupper kan skjules dynamisk ved å angi parameteren visible for å usann (sann som standard).

Kortet kan fylle ut enten formateringsruten eller analyseruten ved å angi analyticsPane-parameteren for å sann eller usann.

Eksempel: Implementering av kort for formateringsinnstillinger

Forutsetninger

Hvis du vil bygge en formateringsmodell med formateringskort ved hjelp av formateringsverktøy, må du

• Oppdater powerbi-visuals-api-versjonen til 5.1 og nyere.
• Installer powerbi-visuals-utils-formattingmodel.
• Initialiser formattingSettingsService.
• Initialiser formattingSettingsModel-klassen.

Notat

• Kortnavnet må samsvare med objektnavnet i capabilities.json
• Slice-navnet må samsvare med egenskapsnavnet i capabilities.json

implementering av enkelt formateringskort

I dette eksemplet viser vi hvordan du bygger en egendefinert visuell formateringsmodell med ett enkelt kort ved hjelp av formateringsverktøy. Kortet har to sektorer:

• Vis egenskap representert av ToggleSwitch-sektoren.
• Visningsenheter-egenskapen representert av AutoDropdown-sektoren.

Først legger du til objekter i den capabilities.json filen:

{
  // ... same level as dataRoles and dataViewMappings
  "objects": {
    "values": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayUnits": {
          "type": {
            "formatting": {
              "labelDisplayUnits": true
            }
          }
        }
      }
    }
  }
}

Deretter setter du inn følgende kodefragment i innstillingsfilen:

import { formattingSettings } from "powerbi-visuals-utils-formattingmodel";

class ValuesCardSetting extends formattingSettings.SimpleCard {
    public show: formattingSettings.ToggleSwitch = new formattingSettings.ToggleSwitch({
        name: "show",
        value: true
    });

    public displayUnits: formattingSettings.AutoDropdown = new formattingSettings.AutoDropdown({
        name: "displayUnits",
        displayName: "Display units",
        value: 0
    });

    topLevelSlice: formattingSettings.ToggleSwitch = this.show;
    name: string = "values";
    displayName: string = "Values settings";

    public slices: formattingSettings.Slice[] = [ this.displayUnits ];
}

export class VisualSettingsModel  extends formattingSettings.Model {
    public values: ValuesCardSetting = new ValuesCardSetting();
    public cards: formattingSettings.SimpleCard[] = [this.values];
}

Følg trinn 4 – 8 fra bygge formateringsruten opplæring.

Her er resultatruten:

implementering av sammensatt formateringskort

I dette eksemplet viser vi hvordan du bygger en egendefinert visuell formateringsmodell med ett sammensatt formateringskort ved hjelp av formateringsverktøy. Kortet har én gruppe:

• myVisualGroupSettings med to enkle egenskaper
  • Presisjon
  • Vis enheter

Først legger du til objekter i den capabilities.json filen:

{
  // ... same level as dataRoles and dataViewMappings
  "objects": {
    "values": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayUnits": {
          "type": {
            "formatting": {
              "labelDisplayUnits": true
            }
          }
        },
        "displayUnits": {
          "type": {
            "formatting": {
              "labelDisplayUnits": true
            }
          }
        }
      }
    }
  }
}

Deretter setter du inn følgende kodefragment i innstillingsfilen:

import { formattingSettings } from "powerbi-visuals-utils-formattingmodel";

class LabelsSettingsGroup extends formattingSettings.SimpleCard {
    public displayUnits: formattingSettings.AutoDropdown = new formattingSettings.AutoDropdown({
        name: "displayUnits",
        displayName: "Display units",
        value: 0
    });

    public precision: formattingSettings.NumUpDown = new formattingSettings.NumUpDown({
        name: "precision",
        displayName: "Precision",
        value: 2
    });

    name: string = "labelsGroup";
    displayName: string = "Labels group";
    slices: formattingSettings.Slice[] = [this.displayUnits, this.precision];
}

class ValuesCardSetting extends formattingSettings.CompositeCard {
    public show: formattingSettings.ToggleSwitch = new formattingSettings.ToggleSwitch({
        name: "show",
        value: true
    });

    public labelsGroup: LabelsSettingsGroup = new LabelsSettingsGroup();

    topLevelSlice: formattingSettings.ToggleSwitch = this.show;
    name: string = "values";
    displayName: string = "Values settings";
    groups: formattingSettings.Group[] = [this.labelsGroup];
}

export class VisualSettingsModel  extends formattingSettings.Model {
    public values: ValuesCardSetting = new ValuesCardSetting();
    public cards: formattingSettings.SimpleCard[] = [this.values];
}

Følg trinn 4 – 8 fra bygge formateringsruten opplæring.

Her er resultatruten:

Relatert innhold

• Format-ruten
• formateringsmodellverktøy