Referentiehandleiding voor StylesObject-schema's voor dynamische Kaarten

Artikel
01/04/2024

Dit StylesObject is een StyleObject matrix die statussetstijlen vertegenwoordigt. Gebruik de functiestatusservice van Azure Kaarten Creator om uw statussetstijlen toe te passen op gegevensfuncties voor binnenkaart. Zodra u uw statussetstijlen hebt gemaakt en deze hebt gekoppeld aan functies voor indoorkaarten, kunt u deze gebruiken om dynamische indoorkaarten te maken. Zie Dynamische stijl voor creator-indoorkaarten implementeren voor indoorkaarten voor meer informatie over het maken van dynamische indoorkaarten.

StyleObject

A StyleObject is een van de volgende stijlregels:

BooleanTypeStyleRule
NumericTypeStyleRule
StringTypeStyleRule

In de volgende JSON ziet u een voorbeeld van het gebruik van elk van de drie stijltypen. Deze BooleanTypeStyleRule wordt gebruikt om de dynamische stijl te bepalen voor functies waarvan occupied de eigenschap waar en onwaar is. De NumericTypeStyleRule stijl wordt gebruikt om de stijl te bepalen voor functies waarvan temperature de eigenschap binnen een bepaald bereik valt. Ten slotte wordt het StringTypeStyleRule gebruikt om specifieke stijlen aan te passen aan meetingType.

 "styles": [
     {
        "keyname": "occupied",
        "type": "boolean",
        "rules": [
            {
                "true": "#FF0000",
                "false": "#00FF00"
            }
        ]
    },
    {
        "keyname": "temperature",
        "type": "number",
        "rules": [
             {
                "range": {
                "minimum": 50,
                "exclusiveMaximum": 70
                },
                "color": "#343deb"
            },
            {
                "range": {
                "maximum": 70,
                "exclusiveMinimum": 30
              },
              "color": "#eba834"
            }
        ]
    },
    {
      "keyname": "meetingType",
      "type": "string",
      "rules": [
        {
          "private": "#FF0000",
          "confidential": "#FF00AA",
          "allHands": "#00FF00",
          "brownBag": "#964B00"
        }
      ]
    }
]

NumericTypeStyleRule

A NumericTypeStyleRule is een StyleObject en bestaat uit de volgende eigenschappen:

Eigenschap	Type	Beschrijving	Vereist
`keyName`	tekenreeks	De naam van de status of dynamische eigenschap. A `keyName` moet uniek zijn binnen de `StyleObject` matrix.	Ja
`type`	tekenreeks	Waarde is `numeric`.	Ja
`rules`	`NumberRuleObject`	Een matrix met numerieke stijlbereiken met bijbehorende kleuren. Elk bereik definieert een kleur die moet worden gebruikt wanneer de statuswaarde voldoet aan het bereik.	Ja

NumberRuleObject

Een NumberRuleObject bestaat uit een RangeObject en een color eigenschap. Als de statuswaarde in het bereik valt, is de kleur voor weergave de kleur die is opgegeven in de color eigenschap.

Als u meerdere overlappende bereiken definieert, is de gekozen kleur de kleur die is gedefinieerd in het eerste bereik dat is voldaan.

In het volgende JSON-voorbeeld zijn beide bereiken waar wanneer de statuswaarde tussen 50 en 60 ligt. De kleur die wordt gebruikt, is #343deb echter omdat het het eerste bereik in de lijst is waaraan is voldaan.


    {
        "rules":[
            {
                "range": {
                "minimum": 50,
                "exclusiveMaximum": 70
                },
                "color": "#343deb"
            },
            {
                "range": {
                "minimum": 50,
                "maximum": 60
                },
                "color": "#eba834"
            }
        ]
    }
]

Eigenschap	Type	Beschrijving	Vereist
`range`	RangeObject	Het RangeObject definieert een set logische bereikvoorwaarden, die, indien `true`, de weergavekleur van de status wijzigen in de kleur die is opgegeven in de `color` eigenschap. Als `range` dit niet is opgegeven, wordt de kleur die in de `color` eigenschap is gedefinieerd, altijd gebruikt.	Nee
`color`	tekenreeks	De kleur die moet worden gebruikt wanneer de statuswaarde binnen het bereik valt. De `color` eigenschap is een JSON-tekenreeks in een van de volgende indelingen: HEX-waarden in HTML-stijl RGB ("#ff0", "#ffff00", "rgb(255, 255, 0)") RGBA ("rgba(255, 255, 0, 1)") HSL("hsl(100, 50%, 50%)") HSLA("hsla(100, 50%, 50%, 1)") Vooraf gedefinieerde HTML-kleurennamen, zoals geel en blauw.	Ja

RangeObject

Hiermee RangeObject definieert u een numerieke bereikwaarde van een NumberRuleObject. Als de statuswaarde in het bereik valt, moeten alle gedefinieerde voorwaarden waar zijn.

Eigenschap	Type	Beschrijving	Vereist
`minimum`	dubbel	Alle x x x ≥ `minimum`.	Nee
`maximum`	dubbel	Alle getallen x die x ≤ `maximum`.	Nee
`exclusiveMinimum`	dubbel	Alle getal x die x >`exclusiveMinimum`.	Nee
`exclusiveMaximum`	dubbel	Alle getal x die x <`exclusiveMaximum`.	Nee

Voorbeeld van NumericTypeStyleRule

De volgende JSON illustreert een status met de NumericTypeStyleRulenaam temperature. In dit voorbeeld bevat het NumberRuleObject twee gedefinieerde temperatuurbereiken en de bijbehorende kleurstijlen. Als het temperatuurbereik 50-69 is, moet de weergave de kleur #343debgebruiken. Als het temperatuurbereik 31-70 is, moet de display de kleur #eba834gebruiken.

{
    "keyname": "temperature",
    "type": "number",
    "rules":[
        {
            "range": {
            "minimum": 50,
            "exclusiveMaximum": 70
            },
            "color": "#343deb"
        },
        {
            "range": {
            "maximum": 70,
            "exclusiveMinimum": 30
            },
            "color": "#eba834"
        }
    ]
}

StringTypeStyleRule

A StringTypeStyleRule is een StyleObject en bestaat uit de volgende eigenschappen:

Eigenschap	Type	Beschrijving	Vereist
`keyName`	tekenreeks	De naam van de status of dynamische eigenschap. A `keyName` moet uniek zijn binnen de `StyleObject` matrix.	Ja
`type`	tekenreeks	Waarde is `string`.	Ja
`rules`	`StringRuleObject`	Een matrix van N-aantal statuswaarden .	Ja

StringRuleObject

Een StringRuleObject bestaat uit maximaal N aantal statuswaarden die de mogelijke tekenreekswaarden van de eigenschap van een functie zijn. Als de eigenschapswaarde van de functie niet overeenkomt met een van de gedefinieerde statuswaarden, heeft die functie geen dynamische stijl. Als er dubbele statuswaarden worden opgegeven, heeft de eerste prioriteit.

De overeenkomende tekenreekswaarde is hoofdlettergevoelig.

Eigenschap	Type	Beschrijving	Vereist
`stateValue1`	tekenreeks	De kleur wanneer de waardetekenreeks stateValue1 is.	Nee
`stateValue2`	tekenreeks	De kleur wanneer de waardetekenreeks stateValue is.	Nee
`stateValueN`	tekenreeks	De kleur wanneer de waardetekenreeks stateValueN is.	Nee

Voorbeeld van StringTypeStyleRule

De volgende JSON illustreert een StringTypeStyleRule sjabloon waarmee stijlen worden gedefinieerd die zijn gekoppeld aan specifieke typen vergaderingen.

    {
      "keyname": "meetingType",
      "type": "string",
      "rules": [
        {
          "private": "#FF0000",
          "confidential": "#FF00AA",
          "allHands": "#00FF00",
          "brownBag": "#964B00"
        }
      ]
    }

BooleanTypeStyleRule

A BooleanTypeStyleRule is een StyleObject en bestaat uit de volgende eigenschappen:

Eigenschap	Type	Beschrijving	Vereist
`keyName`	tekenreeks	De naam van de status of dynamische eigenschap. A `keyName` moet uniek zijn binnen de `StyleObject` matrix.	Ja
`type`	tekenreeks	Waarde is `boolean`.	Ja
`rules`	`BooleanRuleObject`	Een Booleaanse waarde met kleuren voor `true` en `false`statuswaarden .	Ja

BooleanRuleObject

A BooleanRuleObject definieert kleuren voor true en false waarden.

Eigenschap	Type	Beschrijving	Vereist
`true`	tekenreeks	De kleur die moet worden gebruikt wanneer de statuswaarde is `true`. De `color` eigenschap is een JSON-tekenreeks in een van de volgende indelingen: HEX-waarden in HTML-stijl RGB ("#ff0", "#ffff00", "rgb(255, 255, 0)") RGBA ("rgba(255, 255, 0, 1)") HSL("hsl(100, 50%, 50%)") HSLA("hsla(100, 50%, 50%, 1)") Vooraf gedefinieerde HTML-kleurennamen, zoals geel en blauw.	Ja
`false`	tekenreeks	De kleur die moet worden gebruikt wanneer de statuswaarde is `false`.	Ja

Voorbeeld van BooleanTypeStyleRule

De volgende JSON illustreert een status met de BooleanTypeStyleRulenaam occupied. Hiermee BooleanRuleObject definieert u kleuren voor true en false waarden.

{
    "keyname": "occupied",
    "type": "boolean",
    "rules": [
    {
        "true": "#FF0000",
        "false": "#00FF00"
    }
    ]
}

Volgende stappen

Lees voor meer informatie over Creator voor indoorkaarten:

Wat is Azure Kaarten Creator?

Maker voor indoorkaarten