토글 스위치 서식 구성 요소

ToggleSwitchcapabilities.json 파일에서 bool 개체 형식을 나타내는 데 사용되는 간단한 서식 조각입니다.

예: ToggleSwitch 구현

이 예제에서는 서식 지정 모델 유틸리티를 사용하여 ToggleSwitch 슬라이스를 작성하는 방법을 보여 줍니다.

기능 개체

capabilities.json 파일에 다음 JSON 조각을 삽입합니다.

{
  // ... same level as dataRoles and dataViewMappings
  "objects": {
    "labels": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        }
      }
    }
  }
}

모델 클래스 서식 지정

설정 파일에 다음 코드 조각을 삽입합니다.

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

class LabelsCardSetting extends formattingSettings.SimpleCard {
    name: string = "labels"; // same as capabilities object name
    displayName: string = "Labels";

    public showLabels: formattingSettings.ToggleSwitch = new formattingSettings.ToggleSwitch({
        name: "show", // same as capabilities property name
        displayName: "Show",
        value: true
    });
    
    public slices: formattingSettings.Slice[] = [ this.showLabels ];
}

export class VisualSettings extends formattingSettings.Model {
    public labels: LabelsCardSetting = new LabelsCardSetting();
    public cards: formattingSettings.SimpleCard[] = [this.labels];
}

추가 옵션

ToggleSwitch 조각은 최상위 카드 토글로 사용할 수도 있습니다.

ToggleSwitch를 최상위 항목으로 설정하려면 슬라이스 배열에서 슬라이스를 제거하고, 카드 설정 클래스에 다음 줄을 추가합니다.

topLevelSlice: formattingSettings.ToggleSwitch = this.showLabels;

최종 서식 설정 파일은 다음 예제와 일치해야 합니다.

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

class LabelsCardSetting extends formattingSettings.SimpleCard {
    name: string = "labels"; // same as capabilities object name
    displayName: string = "Labels";

    public showLabels: formattingSettings.ToggleSwitch = new formattingSettings.ToggleSwitch({
        name: "show", // same as capabilities property name
        displayName: "Show",
        value: true
    });
    
    topLevelSlice: formattingSettings.ToggleSwitch = this.showLabels;
    public slices: formattingSettings.Slice[] = [];
}

export class VisualSettings extends formattingSettings.Model {
    public labels: LabelsCardSetting = new LabelsCardSetting();
    public cards: formattingSettings.SimpleCard[] = [this.labels];
}

관련 콘텐츠

• 서식 창
• 서식 지정 모델 유틸리티