서식 설정 카드
서식 설정 카드은 서식 또는 분석 창에서 서식 카드를 지정합니다. 서식 설정 카드에는 여러 서식 조각, 컨테이너, 그룹 및 속성이 포함될 수 있습니다.
서식 설정 카드에 조각을 추가하면 이러한 모든 조각이 하나의 서식 카드로 전환됩니다.
카드, 조각 및 그룹은 visible 매개 변수를 false (기본값은true)로 설정하여 동적으로 숨길 수 있습니다.
카드는 analyticsPane 매개 변수를 true 또는 false로 설정하여 서식 창 또는 분석 창을 각각 채울 수 있습니다.
예: 서식 지정 설정 카드 구현
필수 구성 요소
formattingmodel 유틸리티를 사용하여 서식 카드가 있는 서식 모델을 빌드하려면 다음을 수행해야 합니다.
- powerbi-visuals-api 버전을 5.1 이상으로 업데이트합니다.
- powerbi-visuals-utils-formattingmodel을 설치합니다.
- formattingSettingsService초기화합니다.
- formattingSettingsModel 클래스를 초기화합니다.
메모
- 카드 이름은 capabilities.json 개체 이름과 일치해야 합니다.
- 조각 이름은 capabilities.json의 속성 이름과 일치해야 합니다.
이 예제에서는 하나의 간단한 카드을 사용하여 formattingmodel util로 사용자 지정 시각적 서식 모델을 빌드하는 방법을 보여드립니다. 카드에는 다음 두 조각이 있습니다.
- ToggleSwitch 슬라이스가 나타내는 속성을 표시합니다.
- AutoDropdown 슬라이스로 나타내는 디스플레이 단위 속성입니다.
먼저 capabilities.json 파일에 개체를 추가합니다.
{
// ... same level as dataRoles and dataViewMappings
"objects": {
"values": {
"properties": {
"show": {
"type": {
"bool": true
}
},
"displayUnits": {
"type": {
"formatting": {
"labelDisplayUnits": true
}
}
}
}
}
}
}
그런 다음, 설정 파일에 다음 코드 조각을 삽입합니다.
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];
}
빌드 서식 창 자습서에서 4번 단계부터 8번 단계까지 수행합니다.
결과 창은 다음과 같습니다.
