--- metadata: - name: generator content: Diplodoc Platform v5.50.3 alternate: - https://divkit.tech/docs/en/concepts/divs/2/div-state.md - https://divkit.tech/docs/ru/concepts/divs/2/div-state.md --- > **Documentation Index:** Fetch the complete configuration index at https://divkit.tech/docs/en/llms.txt # div-state It contains sets of states for visual elements and switches between them. ## Parameters | Parameters | Description | | --- | --- | | `states` |

**array**

Required parameter.

States. Each element can have a few states with a different layout. Transition between states is performed using [special scheme](../../interaction) of the [action](div-action.md) element.

An array must not be empty.

| | `type` |

**string**

Required parameter.

The value must always be `state`.

| | `accessibility` |

**object**

Accessibility settings.

The value has the type `div-accessibility`.

Available platforms: Android, iOS, web.

| | `action` |

**object**

One action when clicking on an element. Not used if the `actions` parameter is set.

The value has the type `div-action`.

| | `action_animation` |

**object**

Click animation. The web only supports the following values: `fade`, `scale`, `native`, `no_animation` and `set`.

The value has the type `div-animation`.

Default value: `{"name": "fade", "start_value": 1, "end_value": 0.6, "duration": 100 }`.

Available platforms: Android, iOS, web.

| | `actions` |

**array**

Multiple actions when clicking on an element.

| | `alignment_horizontal` |

**string**

Horizontal alignment of an element inside the parent element.

Possible values: `left`, `center`, `right`, `start`, `end`.

| | `alignment_vertical` |

**string**

Vertical alignment of an element inside the parent element.

Possible values: `top`, `center`, `bottom`, `baseline`.

| | `alpha` |

**number**

Sets transparency of the entire element: `0` — completely transparent, `1` — opaque.

Restriction for the value `x`: `x >= 0.0 && x <= 1.0`.

Default value: `1.0`.

| | `animators` |

**array**

Declaration of animators that change variable values over time.

Available platforms: Android, iOS, web.

List of possible values:

  • [div-color-animator](div-color-animator.md#div-color-animator)
  • [div-number-animator](div-number-animator.md#div-number-animator)

    • | | `background` |

    **array**

    Element background. It can contain multiple layers.

    List of possible values:

  • [div-linear-gradient](div-linear-gradient.md#div-linear-gradient)
  • [div-radial-gradient](div-radial-gradient.md#div-radial-gradient)
  • [div-image-background](div-image-background.md#div-image-background)
  • [div-solid-background](div-solid-background.md#div-solid-background)
  • [div-nine-patch-background](div-nine-patch-background.md#div-nine-patch-background)

    • | | `border` |

    **object**

    Element stroke.

    The value has the type `div-border`.

    | | `capture_focus_on_action` |

    **bool**

    If the value is:

  • `true` - when the element action is activated, the focus will be moved to that element. That means that the accessibility focus will be moved and the virtual keyboard will be hidden, unless the target element implies its presence (e.g. `input`).
  • `false` - when you click on an element, the focus will remain on the currently focused element.

    • Default value: `true`.

    Available platforms: Android, iOS, web.

    | | `clip_to_bounds` |

    **bool_int**

    Enables the bounding of child elements by the parent's borders.

    Default value: `true`.

    Available platforms: Android, web, iOS.

    | | `column_span` |

    **int**

    Merges cells in a column of the [grid](div-grid.md) element.

    Restriction for the value `x`: `x >= 0`.

    Available platforms: Android, iOS, web.

    | | `default_state_id` |

    **string**

    ID of the status that will be set by default. If the parameter isnt set, the first state of the `states` will be set.

    | | `disappear_actions` |

    **array**

    Actions when an element disappears from the screen.

    Available platforms: Android, iOS, web.

    | | `div_id` |

    **string**

    Parameter is deprecated.

    ID of an element to search in the hierarchy. The ID must be unique at one hierarchy level.

    | | `doubletap_actions` |

    **array**

    Action when double-clicking on an element.

    Available platforms: Android, iOS, web.

    | | `extensions` |

    **array**

    Extensions for additional processing of an element. The list of extensions is given in [DivExtension](../../extensions).

    Available platforms: Android, iOS, web.

    | | `focus` |

    **object**

    Parameters when focusing on an element or losing focus.

    The value has the type `div-focus`.

    | | `functions` |

    **array**

    User functions.

    Available platforms: Android, iOS, web.

    | | `height` |

    **object**

    Element height. For Android: if there is text in this or in a child element, specify height in `sp` to scale the element together with the text. To learn more about units of size measurement, see [Layout inside the card](../../layout).

    The value has the type `div-size`.

    Default value: `{"type": "wrap_content"}`.

    List of possible values:

  • [div-fixed-size](div-fixed-size.md#div-fixed-size)
  • [div-match-parent-size](div-match-parent-size.md#div-match-parent-size)
  • [div-wrap-content-size](div-wrap-content-size.md#div-wrap-content-size)

    • | | `hover_end_actions` |

    **array**

    Actions performed after hovering over an element. Available on platforms that support pointing devices (such as a mouse or stylus).

    Available platforms: web, Android, iOS.

    | | `hover_start_actions` |

    **array**

    Actions performed when hovering over an element. Available on platforms that support pointing devices (such as a mouse or stylus).

    Available platforms: web, Android, iOS.

    | | `id` |

    **string**

    Element ID. It must be unique within the root element. It is used as `accessibilityIdentifier` on iOS.

    | | `layout_provider` |

    **object**

    Provides data on the actual size of the element.

    The value has the type `div-layout-provider`.

    Available platforms: Android, iOS, web.

    | | `longtap_actions` |

    **array**

    Action when long-clicking an element. Doesn't work on devices that don't support touch gestures.

    Available platforms: Android, iOS, web.

    | | `margins` |

    **object**

    External margins from the element stroke.

    The value has the type `div-edge-insets`.

    | | `paddings` |

    **object**

    Internal margins from the element stroke.

    The value has the type `div-edge-insets`.

    | | `press_end_actions` |

    **array**

    Actions performed after clicking/tapping an element.

    Available platforms: web, Android, iOS.

    | | `press_start_actions` |

    **array**

    Actions performed at the start of a click/tap on an element.

    Available platforms: web, Android, iOS.

    | | `reuse_id` |

    **string**

    ID for the div object structure. Used to optimize block reuse. See [block reuse](../../reuse/reuse.md).

    Available platforms: Android, iOS.

    | | `row_span` |

    **int**

    Merges cells in a string of the [grid](div-grid.md) element.

    Restriction for the value `x`: `x >= 0`.

    Available platforms: Android, iOS, web.

    | | `selected_actions` |

    **array**

    List of [actions](div-action.md) to be executed when selecting an element in [pager](div-pager.md).

    Available platforms: Android, iOS, web.

    | | `state_id_variable` |

    **string**

    The name of the variable that stores the ID for the current state. If the variable changes, the active state will also change. The variable is prioritized over the default_state_id parameter.

    | | `tooltips` |

    **array**

    Tooltips linked to an element. A tooltip can be shown by `div-action://show_tooltip?id=`, hidden by `div-action://hide_tooltip?id=` where `id` — tooltip id.

    Available platforms: Android, iOS, web.

    | | `transform` |

    **object**

    Applies the passed transformation to the element. Content that doesn't fit into the original view area is cut off.

    The value has the type `div-transform`.

    Available platforms: Android, iOS, web.

    | | `transformations` |

    **array**

    Array of transformations to be applied to the element in sequence.

    Available platforms: web.

    List of possible values:

  • [div-rotation-transformation](div-rotation-transformation.md#div-rotation-transformation)
  • [div-translation-transformation](div-translation-transformation.md#div-translation-transformation)

    • | | `transition_animation_selector` |

    **string**

    Parameter is deprecated.

    It determines which events trigger transition animations.

    Possible values: `none`, `data_change`, `state_change`, `any_change`.

    Default value: `state_change`.

    | | `transition_change` |

    **object**

    Change animation. It is played when the position or size of an element changes in the new layout.

    The value has the type `div-change-transition`.

    Available platforms: Android, iOS, web.

    List of possible values:

  • [div-change-set-transition](div-change-set-transition.md#div-change-set-transition)
  • [div-change-bounds-transition](div-change-bounds-transition.md#div-change-bounds-transition)

    • | | `transition_in` |

    **object**

    Appearance animation. It is played when an element with a new ID appears. To learn more about the concept of transitions, see [Animated transitions](../../interaction#animation/transition-animation).

    The value has the type `div-appearance-transition`.

    Available platforms: Android, iOS, web.

    List of possible values:

  • [div-appearance-set-transition](div-appearance-set-transition.md#div-appearance-set-transition)
  • [div-fade-transition](div-fade-transition.md#div-fade-transition)
  • [div-scale-transition](div-scale-transition.md#div-scale-transition)
  • [div-slide-transition](div-slide-transition.md#div-slide-transition)

    • | | `transition_out` |

    **object**

    Disappearance animation. It is played when an element disappears in the new layout.

    The value has the type `div-appearance-transition`.

    Available platforms: Android, iOS, web.

    List of possible values:

  • [div-appearance-set-transition](div-appearance-set-transition.md#div-appearance-set-transition)
  • [div-fade-transition](div-fade-transition.md#div-fade-transition)
  • [div-scale-transition](div-scale-transition.md#div-scale-transition)
  • [div-slide-transition](div-slide-transition.md#div-slide-transition)

    • | | `transition_triggers` |

    **array**

    Animation starting triggers. Default value: `[state_change, visibility_change]`.

    An array must not be empty.

    Available platforms: Android, iOS, web.

    | | `variable_triggers` |

    **array**

    Triggers for changing variables within an element.

    Available platforms: Android, iOS, web.

    | | `variables` |

    **array**

    Declaration of variables that can be used within an element. Variables declared in this array can only be used within the element and its child elements.

    Available platforms: iOS, web, Android.

    List of possible values:

  • [string_variable](string_variable.md#string_variable)
  • [number_variable](number_variable.md#number_variable)
  • [integer_variable](integer_variable.md#integer_variable)
  • [boolean_variable](boolean_variable.md#boolean_variable)
  • [color_variable](color_variable.md#color_variable)
  • [url_variable](url_variable.md#url_variable)
  • [dict_variable](dict_variable.md#dict_variable)
  • [array_variable](array_variable.md#array_variable)
  • [property_variable](property_variable.md#property_variable)

    • | | `visibility` |

    **string**

    Element visibility.

    Possible values: `visible`, `invisible`, `gone`.

    Default value: `visible`.

    | | `visibility_action` |

    **object**

    Tracking visibility of a single element. Not used if the `visibility_actions` parameter is set.

    The value has the type `div-visibility-action`.

    | | `visibility_actions` |

    **array**

    Actions when an element appears on the screen.

    | | `width` |

    **object**

    Element width.

    The value has the type `div-size`.

    Default value: `{"type": "match_parent"}`.

    List of possible values:

  • [div-fixed-size](div-fixed-size.md#div-fixed-size)
  • [div-match-parent-size](div-match-parent-size.md#div-match-parent-size)
  • [div-wrap-content-size](div-wrap-content-size.md#div-wrap-content-size)

    • | ### state | Parameters | Description | | --- | --- | | `state_id` |

    **string**

    Required parameter.

    State ID. It must be unique at one hierarchy level.

    | | `animation_in` |

    **object**

    Parameter is deprecated.

    State appearance animation. Use `transition_in` instead.

    The value has the type `div-animation`.

    Available platforms: Android, iOS.

    | | `animation_out` |

    **object**

    Parameter is deprecated.

    State disappearance animation. Use `transition_out` instead.

    The value has the type `div-animation`.

    Available platforms: Android, iOS.

    | | `div` |

    **object**

    Contents. If the parameter is missing, the state won't be displayed.

    The value has the type `div`.

    List of possible values:

  • [div-image](div-image.md#div-image)
  • [div-gif-image](div-gif-image.md#div-gif-image)
  • [div-text](div-text.md#div-text)
  • [div-separator](div-separator.md#div-separator)
  • [div-container](div-container.md#div-container)
  • [div-grid](div-grid.md#div-grid)
  • [div-gallery](div-gallery.md#div-gallery)
  • [div-pager](div-pager.md#div-pager)
  • [div-tabs](div-tabs.md#div-tabs)
  • [div-state](div-state.md#div-state)
  • [div-custom](div-custom.md#div-custom)
  • [div-indicator](div-indicator.md#div-indicator)
  • [div-slider](div-slider.md#div-slider)
  • [div-switch](div-switch.md#div-switch)
  • [div-input](div-input.md#div-input)
  • [div-select](div-select.md#div-select)
  • [div-video](div-video.md#div-video)

    • | | `swipe_out_actions` |

    **array**

    Parameter is deprecated.

    Actions when swiping the state horizontally.

    Available platforms: Android, iOS.

    |
    JSON ```json { type*: "state", accessibility: { description: "string", hint: "string", is_checked: "bool_int", 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", scope_id: "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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ], alignment_horizontal: "string", alignment_vertical: "string", alpha: "number", animators: [ div-animator, ... ], 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", style: div-stroke-style, unit: "string", width: "number" } }, capture_focus_on_action: "bool", clip_to_bounds: "bool_int", column_span: "int", default_state_id: "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", scope_id: "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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ] }, is_enabled: "bool_int", log_id*: "string", log_limit: "int", payload: "object", referer: "string", scope_id: "string", typed: div-action-typed, url: "string", visibility_percentage: "int" }, ... ], div_id: "string", 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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ], extensions: [ { id*: "string", is_enabled: "bool_int", params: "object" }, ... ], 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", style: div-stroke-style, unit: "string", width: "number" } }, 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", scope_id: "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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ] }, functions: [ { arguments*: [ { name*: "string", type*: "string" }, ... ], body*: "string", name*: "string", return_type*: "string" }, ... ], height: div-size, hover_end_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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ], hover_start_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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ], id: "string", layout_provider: { height_variable_name: "string", width_variable_name: "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", scope_id: "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" }, press_end_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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ], press_start_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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ], reuse_id: "string", row_span: "int", 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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ], state_id_variable: "string", states*: [ { 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, state_id*: "string", swipe_out_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", scope_id: "string", target: "string", typed: div-action-typed, url: "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" }, background_accessibility_description: "string", bring_to_top_id: "string", close_by_tap_outside: "bool", div*: div, duration: "int", id*: "string", mode: div-tooltip-mode, offset: { x*: { unit: "string", value*: "number" }, y*: { unit: "string", value*: "number" } }, position*: "string", substrate_div: div, tap_outside_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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ] }, ... ], transform: { pivot_x: div-pivot, pivot_y: div-pivot, rotation: "number" }, transformations: [ div-transformation, ... ], transition_animation_selector: "string", transition_change: div-change-transition, transition_in: div-appearance-transition, transition_out: div-appearance-transition, transition_triggers: [ "string", ... ], variable_triggers: [ { 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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ], condition*: "bool_int", mode: "string" }, ... ], variables: [ div-variable, ... ], 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", scope_id: "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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ] }, is_enabled: "bool_int", log_id*: "string", log_limit: "int", payload: "object", referer: "string", scope_id: "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", scope_id: "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", scope_id: "string", target: "string", typed: div-action-typed, url: "string" }, ... ] }, is_enabled: "bool_int", log_id*: "string", log_limit: "int", payload: "object", referer: "string", scope_id: "string", typed: div-action-typed, url: "string", visibility_duration: "int", visibility_percentage: "int" }, ... ], width: div-size } ```