div-custom
Custom element. It is delegated to a host application to create native elements depending on the platform.
Parameters
Parameters | Description |
---|---|
custom_type |
string Required parameter. Subtype of an element for a host application. |
type |
string Required parameter. The value must always be |
accessibility |
object Accessibility settings. The value has the type Available platforms: Android, iOS, web. |
alignment_horizontal |
string Horizontal alignment of an element inside the parent element. Possible values: |
alignment_vertical |
string Vertical alignment of an element inside the parent element. Possible values: |
alpha |
number Sets transparency of the entire element: Restriction for the value Default value: |
animators |
array Declaration of animators that change variable values over time. Available platforms: Android, iOS, web. List of possible values: |
background |
array Element background. It can contain multiple layers. List of possible values: |
border |
object Element stroke. The value has the type |
column_span |
int Merges cells in a column of the grid element. Restriction for the value Available platforms: Android, iOS, web. |
custom_props |
object Element data for a host application. |
disappear_actions |
array Actions when an element disappears from the screen. Available platforms: Android, iOS, web. |
extensions |
array Extensions for additional processing of an element. The list of extensions is given in DivExtension. Available platforms: Android, iOS, web. |
focus |
object Parameters when focusing on an element or losing focus. The value has the type |
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 The value has the type Default value: List of possible values: |
id |
string Element ID. It must be unique within the root element. It is used as |
items |
array Nested elements. List of possible values: |
layout_provider |
object Provides data on the actual size of the element. The size is calculated without taking into account the margins of the element itself. The value has the type Available platforms: Android, iOS, web. |
margins |
object External margins from the element stroke. The value has the type |
paddings |
object Internal margins from the element stroke. The value has the type |
reuse_id |
string ID for the div object structure. Used to optimize block reuse. See block reuse. Available platforms: Android, iOS. |
row_span |
int Merges cells in a string of the grid element. Restriction for the value Available platforms: Android, iOS, web. |
selected_actions |
array List of actions to be executed when selecting an element in pager. Available platforms: Android, iOS, web. |
tooltips |
array Tooltips linked to an element. A tooltip can be shown by 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 Available platforms: Android, iOS, web. |
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 Available platforms: Android, iOS, web. List of possible values: |
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. The value has the type Available platforms: Android, iOS, web. List of possible values: |
transition_out |
object Disappearance animation. It is played when an element disappears in the new layout. The value has the type Available platforms: Android, iOS, web. List of possible values: |
transition_triggers |
array Animation starting triggers. Default value: 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: |
visibility |
string Element visibility. Possible values: Default value: |
visibility_action |
object Tracking visibility of a single element. Not used if the The value has the type |
visibility_actions |
array Actions when an element appears on the screen. |
width |
object Element width. The value has the type Default value: List of possible values: |
JSON
{
type*: "custom",
accessibility: {
description: "string",
hint: "string",
is_checked: "bool_int",
mode: "string",
mute_after_action: "bool_int",
state_description: "string",
type: "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"
}
},
column_span: "int",
custom_props: "object",
custom_type*: "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"
},
...
],
extensions: [
{
id*: "string",
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,
id: "string",
items: [ div, ... ],
layout_provider: {
height_variable_name: "string",
width_variable_name: "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"
},
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"
},
...
],
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",
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",
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"
},
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
}