ตั้งค่าสถานะส่วนการจัดรูปแบบการเลือก

FlagsSelection ชิ้นเป็นชิ้นการจัดรูปแบบอย่างง่ายซึ่งใช้เพื่อแสดงการแจงนับ ชนิดออบเจ็กต์จากไฟล์ capabilities.json มีสองส่วนค่าสถานะ - ItemFlagsSelection และ AutoFlagsSelection

ความแตกต่างคือสําหรับชิ้น AutoFlagsSelection ที่คุณจําเป็นต้องประกาศรายการการแจงนับภายใต้วัตถุที่เหมาะสมในไฟล์ capabilities.json และสําหรับ ItemFlagsSelection ในระดับการตั้งค่าการจัดรูปแบบ

ตัวอย่าง: การใช้งาน FlagsSelection

ในตัวอย่างนี้ เราจะแสดงวิธีการสร้างส่วนข้อมูลของการตั้งค่าสถานะโดยใช้ยูทิลิตี้แบบจําลองการจัดรูปแบบ แท็บต่อไปนี้แสดงตัวอย่างของ ItemFlagsSelection และ AutoFlagsSelection แบ่งส่วนข้อมูล

วัตถุ Capabilities

แทรกส่วนย่อย JSON ต่อไปนี้ลงในไฟล์ capabilities.json

{
  // ... same level as dataRoles and dataViewMappings
  "objects": {
    "labels": {
      "properties": {
        "itemFlag": {
          "type": {
            "enumeration": []
          }
        },
      }
    }
  }
}

การจัดรูปแบบคลาสแบบจําลอง

แทรกส่วนย่อยของโค้ดต่อไปนี้ลงในไฟล์การตั้งค่า

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

const itemFlagOptions : powerbi.IEnumMember[] = [
    {value : "1", displayName : "Top"}, 
    {value : "2", displayName : "Bottom"},
    {value : "4", displayName : "Left"}, 
    {value : "8", displayName : "Right"}
];

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

    public itemFlag: formattingSettings.ItemFlagsSelection = new formattingSettings.ItemFlagsSelection({
        name: "itemFlag", // same as capabilities property name
        displayName: "Item flag",
        items: itemFlagOptions,
        value: "1"
    });

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

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

วัตถุ Capabilities

แทรกส่วนย่อย JSON ต่อไปนี้ลงในไฟล์ capabilities.json

{
  // ... same level as dataRoles and dataViewMappings
  "objects": {
    "labels": {
      "properties": {
        "autoFlag": {
          "type": {
            "enumeration": [
              {
                "value": "1",
                "displayName": "Left"
              },
              {
                "value": "2",
                "displayName": "Right"
              },
              {
                "value": "4",
                "displayName": "Top"
              },
              {
                "value": "8",
                "displayName": "Bottom"
              }
            ]
          }
        }
      }
    }
  }
}

การจัดรูปแบบคลาสแบบจําลอง

แทรกส่วนย่อยของโค้ดต่อไปนี้ลงในไฟล์การตั้งค่า

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

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

    public autoFlag: formattingSettings.AutoFlagsSelection = new formattingSettings.AutoFlagsSelection({
        name: "autoFlag", // same as capabilities property name
        displayName: "Auto flag",
        value: "1"
    });

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

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

เนื้อหาที่เกี่ยวข้อง

• บานหน้าต่างการจัดรูปแบบ
• ยูทิลิตี้แบบจําลองการจัดรูปแบบ