Справочник по схеме StylesObject для динамических карт

Статья
11/08/2023

StylesObject представляет собой массив StyleObject стилей наборов состояний. Используйте службу состояния функции Azure Maps Creator, чтобы применить стили оформления состояний к функциям схем помещений. После создания стилей наборов состояний и связывания их с функциями схем помещений их можно использовать для создания динамических схем. Дополнительные сведения о создании динамических схем помещений см. в разделе Реализация динамического стиля для схем помещений Creator.

StyleObject

StyleObject — одно из следующих правил стилей:

BooleanTypeStyleRule
NumericTypeStyleRule
StringTypeStyleRule

В следующем формате JSON показан пример использования каждого из трех типов стилей. BooleanTypeStyleRule используется для определения динамического стиля для компонентов, свойство occupied которых имеет значение true и false. NumericTypeStyleRule используется для определения стиля компонентов, свойство temperature которых попадает в определенный диапазон. Наконец, StringTypeStyleRule используется для сопоставления конкретных стилей с 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

NumericTypeStyleRule — это StyleObject, который включает следующие свойства.

Свойство	Type	Описание	Обязательное поле
`keyName`	строка	Состояние или имя динамического свойства. `keyName` должен быть уникальным в массиве `StyleObject`.	Да
`type`	строка	Значение — `numeric`.	Да
`rules`	`NumberRuleObject`	Массив числовых диапазонов стилей со связанными цветами. Каждый диапазон определяет цвет, который будет использоваться, если значение состояния соответствует диапазону.	Да

NumberRuleObject

Объект NumberRuleObject состоит из RangeObject и свойства color. Если значение состояния попадает в диапазон, его цвет для отображения — это цвет, указанный в свойствеcolor.

Если вы задали несколько перекрывающихся диапазонов, будет выбран цвет, определенный в первом диапазоне.

В следующем примере JSON оба диапазона имеют значение true, если значение состояния составляет от 50 до 60. Однако используемый цвет заключается #343deb в том, что он является первым диапазоном в списке, который был удовлетворен.


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

Свойство	Type	Описание	Обязательное поле
`range`	RangeObject	RangeObject определяет набор логических условий диапазона, который при значении `true` меняет цвет отображения состояния на цвет, указанный в свойстве `color`. Если `range` не указано, то всегда используется цвет, определенный в свойстве `color` .	Нет
`color`	строка	Цвет, используемый, когда значение состояния попадает в диапазон. Это `color` свойство представляет собой строку JSON в одном из следующих форматов: Шестнадцатеричные значения стилей HTML RGB ("#ff0", "#ffff00", "rgb(255, 255, 0)") RGBA ("rgba(255, 255, 0, 1)") HSL ("hsl(100, 50%, 50%)") HSLA ("hsla(100, 50%, 50%, 1)") Заранее заданные HTML-имена цветов, например "желтый" и "синий".	Да

RangeObject

RangeObject определяет числовое значение NumberRuleObject. Чтобы значение состояния попадало в диапазон, все заданные условия должны иметь значение true.

Свойство	Type	Описание	Обязательное поле
`minimum`	двойной точности	Все цифры x, где x ≥ `minimum`.	No
`maximum`	двойной точности	Все цифры x, где x ≤ `maximum`.	No
`exclusiveMinimum`	двойной точности	Все цифры x, где x >`exclusiveMinimum`.	No
`exclusiveMaximum`	двойной точности	Все цифры x, где x <`exclusiveMaximum`.	No

Пример NumericTypeStyleRule

Следующий код JSON показывает состояниеNumericTypeStyleRule с именем temperature. В этом примере элемент NumberRuleObject содержит два определенных диапазона температуры и связанные с ними цвета. При температуре в диапазоне от 50 до 69 на дисплее должен выводиться цвет #343deb. При температуре в диапазоне от 31 до 70 на дисплее должен выводиться цвет #eba834.

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

StringTypeStyleRule

StringTypeStyleRule — это StyleObject, который включает следующие свойства.

Свойство	Type	Описание	Обязательное поле
`keyName`	строка	Состояние или имя динамического свойства. `keyName` должен быть уникальным в массиве `StyleObject`.	Да
`type`	строка	Значение — `string`.	Да
`rules`	`StringRuleObject`	Массив из N значений состояния.	Да

StringRuleObject

StringRuleObject содержит до N значений состояния, которые являются возможными строковыми значениями свойства функции. Если значение свойства функции не совпадает ни с одним из определенных значений состояния, эта функция не будет иметь динамического стиля. Если заданы дублирующиеся значения состояния, приоритет имеет первое.

Значения строк чувствительны к регистру.

Свойство	Type	Описание	Обязательное поле
`stateValue1`	строка	Цвет для значения строки stateValue1.	Нет
`stateValue2`	строка	Цвет для значения строки stateValue.	Нет
`stateValueN`	строка	Цвет для значения строки stateValueN.	No

Пример StringTypeStyleRule

Следующий код JSON показывает StringTypeStyleRule, определяющий стили, связанные с конкретными типами собраний.

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

BooleanTypeStyleRule

BooleanTypeStyleRule — это StyleObject, который включает следующие свойства.

Свойство	Type	Описание	Обязательное поле
`keyName`	строка	Состояние или имя динамического свойства. `keyName` должен быть уникальным в массиве `StyleObject`.	Да
`type`	строка	Значение — `boolean`.	Да
`rules`	`BooleanRuleObject`	Логическая пара с цветами для состояния`true` и `false`.	Да

BooleanRuleObject

BooleanRuleObject определяет цвета для значений true и false.

Свойство	Type	Описание	Обязательное поле
`true`	строка	Цвет, используемый, если значение состояния равно `true`. Это `color` свойство представляет собой строку JSON в одном из следующих форматов: Шестнадцатеричные значения стилей HTML RGB ("#ff0", "#ffff00", "rgb(255, 255, 0)") RGBA ("rgba(255, 255, 0, 1)") HSL ("hsl(100, 50%, 50%)") HSLA ("hsla(100, 50%, 50%, 1)") Заранее заданные HTML-имена цветов, например "желтый" и "синий".	Да
`false`	строка	Цвет, используемый, если значение состояния равно `false`.	Да

Пример BooleanTypeStyleRule

Следующий код JSON показывает состояниеBooleanTypeStyleRule с именем occupied. BooleanRuleObject определяет цвета для значений true и false.

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

Следующие шаги

Узнайте больше о Создателе для карт помещений, прочитав следующее:

Что такое Azure Карты Creator?

Creator для схем помещений