div-image

Изображение.

JSON

{
  type*: "image",
  accessibility: {
    description: "string",
    hint: "string",
    mode: "string",
    mute_after_action: "bool_int",
    state_description: "string",
    type: "string"
  },
  action: {
    download_callbacks: {
      on_fail_actions: [ div-action, ... ],
      on_success_actions: [ div-action, ... ]
    },
    is_enabled: "bool_int",
    log_id*: "string",
    log_url: "string",
    menu_items: [
      {
        action: div-action,
        actions: [ div-action, ... ],
        text*: "string"
      },
      ...
    ],
    payload: "object",
    referer: "string",
    target: "string",
    typed: div-action-typed,
    url: "string"
  },
  action_animation: {
    duration: "int",
    end_value: "number",
    interpolator: "string",
    items: [ div-animation, ... ],
    name*: "string",
    repeat: div-count,
    start_delay: "int",
    start_value: "number"
  },
  actions: [
    {
      download_callbacks: {
        on_fail_actions: [ div-action, ... ],
        on_success_actions: [ div-action, ... ]
      },
      is_enabled: "bool_int",
      log_id*: "string",
      log_url: "string",
      menu_items: [
        {
          action: div-action,
          actions: [ div-action, ... ],
          text*: "string"
        },
        ...
      ],
      payload: "object",
      referer: "string",
      target: "string",
      typed: div-action-typed,
      url: "string"
    },
    ...
  ],
  alignment_horizontal: "string",
  alignment_vertical: "string",
  alpha: "number",
  appearance_animation: {
    type*: "fade",
    alpha: "number",
    duration: "int",
    interpolator: "string",
    start_delay: "int"
  },
  aspect: {
    ratio*: "number"
  },
  background: [ div-background, ... ],
  border: {
    corner_radius: "int",
    corners_radius: {
      bottom-left: "int",
      bottom-right: "int",
      top-left: "int",
      top-right: "int"
    },
    has_shadow: "bool_int",
    shadow: {
      alpha: "number",
      blur: "int",
      color: "string",
      offset*: {
        x*: {
          unit: "string",
          value*: "number"
        },
        y*: {
          unit: "string",
          value*: "number"
        }
      }
    },
    stroke: {
      color*: "string",
      unit: "string",
      width: "int"
    }
  },
  column_span: "int",
  content_alignment_horizontal: "string",
  content_alignment_vertical: "string",
  disappear_actions: [
    {
      disappear_duration: "int",
      download_callbacks: {
        on_fail_actions: [
          {
            download_callbacks: div-download-callbacks,
            is_enabled: "bool_int",
            log_id*: "string",
            log_url: "string",
            menu_items: [
              {
                action: div-action,
                actions: [ div-action, ... ],
                text*: "string"
              },
              ...
            ],
            payload: "object",
            referer: "string",
            target: "string",
            typed: div-action-typed,
            url: "string"
          },
          ...
        ],
        on_success_actions: [
          {
            download_callbacks: div-download-callbacks,
            is_enabled: "bool_int",
            log_id*: "string",
            log_url: "string",
            menu_items: [
              {
                action: div-action,
                actions: [ div-action, ... ],
                text*: "string"
              },
              ...
            ],
            payload: "object",
            referer: "string",
            target: "string",
            typed: div-action-typed,
            url: "string"
          },
          ...
        ]
      },
      is_enabled: "bool_int",
      log_id*: "string",
      log_limit: "int",
      payload: "object",
      referer: "string",
      typed: div-action-typed,
      url: "string",
      visibility_percentage: "int"
    },
    ...
  ],
  doubletap_actions: [
    {
      download_callbacks: {
        on_fail_actions: [ div-action, ... ],
        on_success_actions: [ div-action, ... ]
      },
      is_enabled: "bool_int",
      log_id*: "string",
      log_url: "string",
      menu_items: [
        {
          action: div-action,
          actions: [ div-action, ... ],
          text*: "string"
        },
        ...
      ],
      payload: "object",
      referer: "string",
      target: "string",
      typed: div-action-typed,
      url: "string"
    },
    ...
  ],
  extensions: [
    {
      id*: "string",
      params: "object"
    },
    ...
  ],
  filters: [ div-filter, ... ],
  focus: {
    background: [ div-background, ... ],
    border: {
      corner_radius: "int",
      corners_radius: {
        bottom-left: "int",
        bottom-right: "int",
        top-left: "int",
        top-right: "int"
      },
      has_shadow: "bool_int",
      shadow: {
        alpha: "number",
        blur: "int",
        color: "string",
        offset*: {
          x*: {
            unit: "string",
            value*: "number"
          },
          y*: {
            unit: "string",
            value*: "number"
          }
        }
      },
      stroke: {
        color*: "string",
        unit: "string",
        width: "int"
      }
    },
    next_focus_ids: {
      down: "string",
      forward: "string",
      left: "string",
      right: "string",
      up: "string"
    },
    on_blur: [
      {
        download_callbacks: {
          on_fail_actions: [ div-action, ... ],
          on_success_actions: [ div-action, ... ]
        },
        is_enabled: "bool_int",
        log_id*: "string",
        log_url: "string",
        menu_items: [
          {
            action: div-action,
            actions: [ div-action, ... ],
            text*: "string"
          },
          ...
        ],
        payload: "object",
        referer: "string",
        target: "string",
        typed: div-action-typed,
        url: "string"
      },
      ...
    ],
    on_focus: [
      {
        download_callbacks: {
          on_fail_actions: [ div-action, ... ],
          on_success_actions: [ div-action, ... ]
        },
        is_enabled: "bool_int",
        log_id*: "string",
        log_url: "string",
        menu_items: [
          {
            action: div-action,
            actions: [ div-action, ... ],
            text*: "string"
          },
          ...
        ],
        payload: "object",
        referer: "string",
        target: "string",
        typed: div-action-typed,
        url: "string"
      },
      ...
    ]
  },
  height: div-size,
  high_priority_preview_show: "bool_int",
  id: "string",
  image_url*: "string",
  longtap_actions: [
    {
      download_callbacks: {
        on_fail_actions: [ div-action, ... ],
        on_success_actions: [ div-action, ... ]
      },
      is_enabled: "bool_int",
      log_id*: "string",
      log_url: "string",
      menu_items: [
        {
          action: div-action,
          actions: [ div-action, ... ],
          text*: "string"
        },
        ...
      ],
      payload: "object",
      referer: "string",
      target: "string",
      typed: div-action-typed,
      url: "string"
    },
    ...
  ],
  margins: {
    bottom: "int",
    end: "int",
    left: "int",
    right: "int",
    start: "int",
    top: "int",
    unit: "string"
  },
  paddings: {
    bottom: "int",
    end: "int",
    left: "int",
    right: "int",
    start: "int",
    top: "int",
    unit: "string"
  },
  placeholder_color: "string",
  preload_required: "bool_int",
  preview: "string",
  row_span: "int",
  scale: "string",
  selected_actions: [
    {
      download_callbacks: {
        on_fail_actions: [ div-action, ... ],
        on_success_actions: [ div-action, ... ]
      },
      is_enabled: "bool_int",
      log_id*: "string",
      log_url: "string",
      menu_items: [
        {
          action: div-action,
          actions: [ div-action, ... ],
          text*: "string"
        },
        ...
      ],
      payload: "object",
      referer: "string",
      target: "string",
      typed: div-action-typed,
      url: "string"
    },
    ...
  ],
  tint_color: "string",
  tint_mode: "string",
  tooltips: [
    {
      animation_in: {
        duration: "int",
        end_value: "number",
        interpolator: "string",
        items: [ div-animation, ... ],
        name*: "string",
        repeat: div-count,
        start_delay: "int",
        start_value: "number"
      },
      animation_out: {
        duration: "int",
        end_value: "number",
        interpolator: "string",
        items: [ div-animation, ... ],
        name*: "string",
        repeat: div-count,
        start_delay: "int",
        start_value: "number"
      },
      div*: div,
      duration: "int",
      id*: "string",
      offset: {
        x*: {
          unit: "string",
          value*: "number"
        },
        y*: {
          unit: "string",
          value*: "number"
        }
      },
      position*: "string"
    },
    ...
  ],
  transform: {
    pivot_x: div-pivot,
    pivot_y: div-pivot,
    rotation: "number"
  },
  transition_change: div-change-transition,
  transition_in: div-appearance-transition,
  transition_out: div-appearance-transition,
  transition_triggers: [ "string", ... ],
  visibility: "string",
  visibility_action: {
    download_callbacks: {
      on_fail_actions: [
        {
          download_callbacks: div-download-callbacks,
          is_enabled: "bool_int",
          log_id*: "string",
          log_url: "string",
          menu_items: [
            {
              action: div-action,
              actions: [ div-action, ... ],
              text*: "string"
            },
            ...
          ],
          payload: "object",
          referer: "string",
          target: "string",
          typed: div-action-typed,
          url: "string"
        },
        ...
      ],
      on_success_actions: [
        {
          download_callbacks: div-download-callbacks,
          is_enabled: "bool_int",
          log_id*: "string",
          log_url: "string",
          menu_items: [
            {
              action: div-action,
              actions: [ div-action, ... ],
              text*: "string"
            },
            ...
          ],
          payload: "object",
          referer: "string",
          target: "string",
          typed: div-action-typed,
          url: "string"
        },
        ...
      ]
    },
    is_enabled: "bool_int",
    log_id*: "string",
    log_limit: "int",
    payload: "object",
    referer: "string",
    typed: div-action-typed,
    url: "string",
    visibility_duration: "int",
    visibility_percentage: "int"
  },
  visibility_actions: [
    {
      download_callbacks: {
        on_fail_actions: [
          {
            download_callbacks: div-download-callbacks,
            is_enabled: "bool_int",
            log_id*: "string",
            log_url: "string",
            menu_items: [
              {
                action: div-action,
                actions: [ div-action, ... ],
                text*: "string"
              },
              ...
            ],
            payload: "object",
            referer: "string",
            target: "string",
            typed: div-action-typed,
            url: "string"
          },
          ...
        ],
        on_success_actions: [
          {
            download_callbacks: div-download-callbacks,
            is_enabled: "bool_int",
            log_id*: "string",
            log_url: "string",
            menu_items: [
              {
                action: div-action,
                actions: [ div-action, ... ],
                text*: "string"
              },
              ...
            ],
            payload: "object",
            referer: "string",
            target: "string",
            typed: div-action-typed,
            url: "string"
          },
          ...
        ]
      },
      is_enabled: "bool_int",
      log_id*: "string",
      log_limit: "int",
      payload: "object",
      referer: "string",
      typed: div-action-typed,
      url: "string",
      visibility_duration: "int",
      visibility_percentage: "int"
    },
    ...
  ],
  width: div-size
}

Параметры

ПараметрыОписание
accessibility

object

Настройки доступности.

Значение имеет тип div-accessibility.

action

object

Одно действие при нажатии на элемент. Не используется, если задан параметр actions.

Значение имеет тип div-action.

action_animation

object

Анимация нажатия. В вебе поддерживаются только значения fade, scale, native, no_animation и set.

Значение имеет тип div-animation.

Значение по умолчанию: {"name": "fade", "start_value": 1, "end_value": 0.6, "duration": 100 }.

actions

array

Несколько действий при нажатии на элемент.

Массив должен быть непустым.

alignment_horizontal

string

Горизонтальное выравнивание элемента внутри родительского.

Возможные значения: left, center, right, start, end.

alignment_vertical

string

Вертикальное выравнивание элемента внутри родительского.

Возможные значения: top, center, bottom, baseline.

alpha

number

Устанавливает прозрачность всего элемента: 0 — полностью прозрачный, 1 — непрозрачный.

Ограничение для значения x: x >= 0.0 && x <= 1.0.

Значение по умолчанию: 1.0.

appearance_animation

object

Анимация прозрачности при загрузке изображения.

Значение имеет тип div-fade-transition.

aspect

object

Фиксированное соотношение размеров элемента. Высота элемента вычисляется исходя из ширины, значение параметра height игнорируется.

Значение имеет тип div-aspect.

background

array

Фон элемента. Может содержать несколько слоев.

Массив должен быть непустым.

border

object

Рамка элемента.

Значение имеет тип div-border.

column_span

int

Объединяет ячейки в столбце элемента grid.

Ограничение для значения x: x >= 0.

content_alignment_horizontal

string

Горизонтальное выравнивание изображения.

Возможные значения: left, center, right, start, end.

Значение по умолчанию: center.

content_alignment_vertical

string

Вертикальное выравнивание изображения.

Возможные значения: top, center, bottom, baseline.

Значение по умолчанию: center.

disappear_actions

array

Действия при исчезновении элемента с экрана.

Массив должен быть непустым.

doubletap_actions

array

Действие при двойном нажатии на элемент.

Массив должен быть непустым.

extensions

array

Расширения для дополнительной обработки элемента. Список расширений см. в разделе Кастомизация.

Массив должен быть непустым.

filters

array

Фильтры для изображений.

Массив должен быть непустым.

Список возможных значений:
  • div-blur
  • div-filter-rtl-mirror
  • focus

    object

    Параметры при фокусировке на элементе или потере фокуса.

    Значение имеет тип div-focus.

    height

    object

    Высота элемента. Для Android: если в этом или в дочернем элементе есть текст, укажите высоту в sp, чтобы элемент масштабировался вместе с текстом. Подробнее о единицах измерения размера в разделе Верстка внутри карточки.

    Значение имеет тип div-size.

    Значение по умолчанию: {"type": "wrap_content"}.

    Список возможных значений:
  • div-fixed-size
  • div-match-parent-size
  • div-wrap-content-size
  • high_priority_preview_show

    bool_int

    Устанавливает приоритет показа превью — превью декодируется в главном потоке и показывается первым кадром. Используйте параметр с осторожностью — он ухудшит время показа превью и может ухудшить время запуска приложения.

    Значение по умолчанию: false.

    Доступные платформы: Android, iOS.

    id

    string

    Идентификатор элемента. На iOS используется в качестве accessibilityIdentifier.

    image_url

    string

    Обязательный параметр.

    Прямая ссылка на изображение.

    Значение должно быть валидным URL.

    longtap_actions

    array

    Действие при долгом нажатии на элемент. Не работает на устройствах без сенсорного экрана.

    Массив должен быть непустым.

    margins

    object

    Внешние отступы от рамки элемента.

    Значение имеет тип div-edge-insets.

    paddings

    object

    Внутренние отступы от рамки элемента.

    Значение имеет тип div-edge-insets.

    placeholder_color

    string

    Фон-заглушка до загрузки изображения.

    Допустимые форматы: #RGB, #ARGB, #RRGGBB, #AARRGGBB.

    Значение по умолчанию: #14000000.

    preload_required

    bool_int

    До показа необходимо предварительно загрузить фоновое изображение.

    Значение по умолчанию: false.

    Доступные платформы: Android, веб.

    preview

    string

    Превью изображения, закодированное в base64. Будет показано до загрузки картинки вместо placeholder_color. Формат data url: data:[;base64],<data>

    row_span

    int

    Объединяет ячейки в строке элемента grid.

    Ограничение для значения x: x >= 0.

    scale

    string

    Масштабирование изображения:
  • fit помещает картинку в элемент целиком (свободное место заполняется фоном);
  • fill масштабирует картинку по размеру элемента и обрезает лишнее.
  • Возможные значения: fill, no_scale, fit, stretch.

    Значение по умолчанию: fill.

    selected_actions

    array

    Список действий, которые будут выполнены при выборе элемента в пейджере.

    Массив должен быть непустым.

    tint_color

    string

    Новый цвет контурного изображения.

    Допустимые форматы: #RGB, #ARGB, #RRGGBB, #AARRGGBB.

    tint_mode

    string

    Метод наложения цвета, указанного в tint_color.

    Возможные значения: source_in, source_atop, darken, lighten, multiply, screen.

    Значение по умолчанию: source_in.

    tooltips

    array

    Привязанные к элементу всплывающие подсказки. Подсказка может быть показана по div-action://show_tooltip?id=, скрыта по div-action://hide_tooltip?id=, где id — id подсказки.

    Массив должен быть непустым.

    transform

    object

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

    Значение имеет тип div-transform.

    transition_change

    object

    Анимация изменения. Воспроизводится при изменении положения или размера элемента в новой верстке.

    Значение имеет тип div-change-transition.

    Список возможных значений:
  • div-change-set-transition
  • div-change-bounds-transition
  • transition_in

    object

    Анимация появления. Воспроизводится при появлении элемента с новым id. Подробнее о концепции переходов в разделе Анимация перехода.

    Значение имеет тип div-appearance-transition.

    transition_out

    object

    Анимация исчезания. Воспроизводится при исчезании элемента в новой верстке.

    Значение имеет тип div-appearance-transition.

    transition_triggers

    array

    Триггеры запуска анимации. Значение по умолчанию: [state_change, visibility_change].

    Массив должен быть непустым.

    type

    string

    Обязательный параметр.

    Значение всегда должно равняться image.

    visibility

    string

    Видимость элемента.

    Возможные значения: visible, invisible, gone.

    Значение по умолчанию: visible.

    visibility_action

    object

    Трекинг видимости одного элемента. Не используется, если задан параметр visibility_actions.

    Значение имеет тип div-visibility-action.

    visibility_actions

    array

    Действия при появлении элемента на экране.

    Массив должен быть непустым.

    width

    object

    Ширина элемента.

    Значение имеет тип div-size.

    Значение по умолчанию: {"type": "match_parent"}.

    Список возможных значений:
  • div-fixed-size
  • div-match-parent-size
  • div-wrap-content-size
  • ПараметрыОписание
    accessibility

    object

    Настройки доступности.

    Значение имеет тип div-accessibility.

    action

    object

    Одно действие при нажатии на элемент. Не используется, если задан параметр actions.

    Значение имеет тип div-action.

    action_animation

    object

    Анимация нажатия. В вебе поддерживаются только значения fade, scale, native, no_animation и set.

    Значение имеет тип div-animation.

    Значение по умолчанию: {"name": "fade", "start_value": 1, "end_value": 0.6, "duration": 100 }.

    actions

    array

    Несколько действий при нажатии на элемент.

    Массив должен быть непустым.

    alignment_horizontal

    string

    Горизонтальное выравнивание элемента внутри родительского.

    Возможные значения: left, center, right, start, end.

    alignment_vertical

    string

    Вертикальное выравнивание элемента внутри родительского.

    Возможные значения: top, center, bottom, baseline.

    alpha

    number

    Устанавливает прозрачность всего элемента: 0 — полностью прозрачный, 1 — непрозрачный.

    Ограничение для значения x: x >= 0.0 && x <= 1.0.

    Значение по умолчанию: 1.0.

    appearance_animation

    object

    Анимация прозрачности при загрузке изображения.

    Значение имеет тип div-fade-transition.

    aspect

    object

    Фиксированное соотношение размеров элемента. Высота элемента вычисляется исходя из ширины, значение параметра height игнорируется.

    Значение имеет тип div-aspect.

    background

    array

    Фон элемента. Может содержать несколько слоев.

    Массив должен быть непустым.

    border

    object

    Рамка элемента.

    Значение имеет тип div-border.

    column_span

    int

    Объединяет ячейки в столбце элемента grid.

    Ограничение для значения x: x >= 0.

    content_alignment_horizontal

    string

    Горизонтальное выравнивание изображения.

    Возможные значения: left, center, right, start, end.

    Значение по умолчанию: center.

    content_alignment_vertical

    string

    Вертикальное выравнивание изображения.

    Возможные значения: top, center, bottom, baseline.

    Значение по умолчанию: center.

    disappear_actions

    array

    Действия при исчезновении элемента с экрана.

    Массив должен быть непустым.

    doubletap_actions

    array

    Действие при двойном нажатии на элемент.

    Массив должен быть непустым.

    extensions

    array

    Расширения для дополнительной обработки элемента. Список расширений см. в разделе Кастомизация.

    Массив должен быть непустым.

    filters

    array

    Фильтры для изображений.

    Массив должен быть непустым.

    Список возможных значений:
  • div-blur
  • div-filter-rtl-mirror
  • focus

    object

    Параметры при фокусировке на элементе или потере фокуса.

    Значение имеет тип div-focus.

    height

    object

    Высота элемента. Для Android: если в этом или в дочернем элементе есть текст, укажите высоту в sp, чтобы элемент масштабировался вместе с текстом. Подробнее о единицах измерения размера в разделе Верстка внутри карточки.

    Значение имеет тип div-size.

    Значение по умолчанию: {"type": "wrap_content"}.

    Список возможных значений:
  • div-fixed-size
  • div-match-parent-size
  • div-wrap-content-size
  • high_priority_preview_show

    bool_int

    Устанавливает приоритет показа превью — превью декодируется в главном потоке и показывается первым кадром. Используйте параметр с осторожностью — он ухудшит время показа превью и может ухудшить время запуска приложения.

    Значение по умолчанию: false.

    Доступные платформы: Android, iOS.

    id

    string

    Идентификатор элемента. На iOS используется в качестве accessibilityIdentifier.

    image_url

    string

    Обязательный параметр.

    Прямая ссылка на изображение.

    Значение должно быть валидным URL.

    longtap_actions

    array

    Действие при долгом нажатии на элемент. Не работает на устройствах без сенсорного экрана.

    Массив должен быть непустым.

    margins

    object

    Внешние отступы от рамки элемента.

    Значение имеет тип div-edge-insets.

    paddings

    object

    Внутренние отступы от рамки элемента.

    Значение имеет тип div-edge-insets.

    placeholder_color

    string

    Фон-заглушка до загрузки изображения.

    Допустимые форматы: #RGB, #ARGB, #RRGGBB, #AARRGGBB.

    Значение по умолчанию: #14000000.

    preload_required

    bool_int

    До показа необходимо предварительно загрузить фоновое изображение.

    Значение по умолчанию: false.

    Доступные платформы: Android, веб.

    preview

    string

    Превью изображения, закодированное в base64. Будет показано до загрузки картинки вместо placeholder_color. Формат data url: data:[;base64],<data>

    row_span

    int

    Объединяет ячейки в строке элемента grid.

    Ограничение для значения x: x >= 0.

    scale

    string

    Масштабирование изображения:
  • fit помещает картинку в элемент целиком (свободное место заполняется фоном);
  • fill масштабирует картинку по размеру элемента и обрезает лишнее.
  • Возможные значения: fill, no_scale, fit, stretch.

    Значение по умолчанию: fill.

    selected_actions

    array

    Список действий, которые будут выполнены при выборе элемента в пейджере.

    Массив должен быть непустым.

    tint_color

    string

    Новый цвет контурного изображения.

    Допустимые форматы: #RGB, #ARGB, #RRGGBB, #AARRGGBB.

    tint_mode

    string

    Метод наложения цвета, указанного в tint_color.

    Возможные значения: source_in, source_atop, darken, lighten, multiply, screen.

    Значение по умолчанию: source_in.

    tooltips

    array

    Привязанные к элементу всплывающие подсказки. Подсказка может быть показана по div-action://show_tooltip?id=, скрыта по div-action://hide_tooltip?id=, где id — id подсказки.

    Массив должен быть непустым.

    transform

    object

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

    Значение имеет тип div-transform.

    transition_change

    object

    Анимация изменения. Воспроизводится при изменении положения или размера элемента в новой верстке.

    Значение имеет тип div-change-transition.

    Список возможных значений:
  • div-change-set-transition
  • div-change-bounds-transition
  • transition_in

    object

    Анимация появления. Воспроизводится при появлении элемента с новым id. Подробнее о концепции переходов в разделе Анимация перехода.

    Значение имеет тип div-appearance-transition.

    transition_out

    object

    Анимация исчезания. Воспроизводится при исчезании элемента в новой верстке.

    Значение имеет тип div-appearance-transition.

    transition_triggers

    array

    Триггеры запуска анимации. Значение по умолчанию: [state_change, visibility_change].

    Массив должен быть непустым.

    type

    string

    Обязательный параметр.

    Значение всегда должно равняться image.

    visibility

    string

    Видимость элемента.

    Возможные значения: visible, invisible, gone.

    Значение по умолчанию: visible.

    visibility_action

    object

    Трекинг видимости одного элемента. Не используется, если задан параметр visibility_actions.

    Значение имеет тип div-visibility-action.

    visibility_actions

    array

    Действия при появлении элемента на экране.

    Массив должен быть непустым.

    width

    object

    Ширина элемента.

    Значение имеет тип div-size.

    Значение по умолчанию: {"type": "match_parent"}.

    Список возможных значений:
  • div-fixed-size
  • div-match-parent-size
  • div-wrap-content-size