div-text
Text.
JSON
{
type*: "text",
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, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
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, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
alignment_horizontal: "string",
alignment_vertical: "string",
alpha: "number",
auto_ellipsize: "bool_int",
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",
doubletap_actions: [
{
download_callbacks: {
on_fail_actions: [ div-action, ... ],
on_success_actions: [ div-action, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
ellipsis: {
actions: [
{
download_callbacks: {
on_fail_actions: [ div-action, ... ],
on_success_actions: [ div-action, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
images: [
{
height: {
type*: "fixed",
unit: "string",
value*: "int"
},
start*: "int",
tint_color: "string",
tint_mode: "string",
url*: "string",
width: {
type*: "fixed",
unit: "string",
value*: "int"
}
},
...
],
ranges: [
{
actions: [
{
download_callbacks: {
on_fail_actions: [ div-action, ... ],
on_success_actions: [ div-action, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
background: div-text-range-background,
border: {
corner_radius: "int",
stroke: {
color*: "string",
unit: "string",
width: "int"
}
},
end*: "int",
font_family: "string",
font_size: "int",
font_size_unit: "string",
font_weight: "string",
letter_spacing: "number",
line_height: "int",
start*: "int",
strike: "string",
text_color: "string",
top_offset: "int",
underline: "string"
},
...
],
text*: "string"
},
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",
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, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
on_focus: [
{
download_callbacks: {
on_fail_actions: [ div-action, ... ],
on_success_actions: [ div-action, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
]
},
focused_text_color: "string",
font_family: "string",
font_size: "int",
font_size_unit: "string",
font_weight: "string",
height: div-size,
id: "string",
images: [
{
height: {
type*: "fixed",
unit: "string",
value*: "int"
},
start*: "int",
tint_color: "string",
tint_mode: "string",
url*: "string",
width: {
type*: "fixed",
unit: "string",
value*: "int"
}
},
...
],
letter_spacing: "number",
line_height: "int",
longtap_actions: [
{
download_callbacks: {
on_fail_actions: [ div-action, ... ],
on_success_actions: [ div-action, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
margins: {
bottom: "int",
left: "int",
right: "int",
top: "int",
unit: "string"
},
max_lines: "int",
min_hidden_lines: "int",
paddings: {
bottom: "int",
left: "int",
right: "int",
top: "int",
unit: "string"
},
ranges: [
{
actions: [
{
download_callbacks: {
on_fail_actions: [ div-action, ... ],
on_success_actions: [ div-action, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
background: div-text-range-background,
border: {
corner_radius: "int",
stroke: {
color*: "string",
unit: "string",
width: "int"
}
},
end*: "int",
font_family: "string",
font_size: "int",
font_size_unit: "string",
font_weight: "string",
letter_spacing: "number",
line_height: "int",
start*: "int",
strike: "string",
text_color: "string",
top_offset: "int",
underline: "string"
},
...
],
row_span: "int",
selectable: "bool_int",
selected_actions: [
{
download_callbacks: {
on_fail_actions: [ div-action, ... ],
on_success_actions: [ div-action, ... ]
},
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
strike: "string",
text*: "string",
text_alignment_horizontal: "string",
text_alignment_vertical: "string",
text_color: "string",
text_gradient: div-text-gradient,
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", ... ],
truncate: "string",
underline: "string",
visibility: "string",
visibility_action: {
download_callbacks: {
on_fail_actions: [
{
download_callbacks: div-download-callbacks,
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
on_success_actions: [
{
download_callbacks: div-download-callbacks,
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
]
},
log_id*: "string",
log_limit: "int",
payload: "object",
referer: "string",
url: "string",
visibility_duration: "int",
visibility_percentage: "int"
},
visibility_actions: [
{
download_callbacks: {
on_fail_actions: [
{
download_callbacks: div-download-callbacks,
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
],
on_success_actions: [
{
download_callbacks: div-download-callbacks,
log_id*: "string",
log_url: "string",
menu_items: [
{
action: div-action,
actions: [ div-action, ... ],
text*: "string"
},
...
],
payload: "object",
referer: "string",
target: "string",
url: "string"
},
...
]
},
log_id*: "string",
log_limit: "int",
payload: "object",
referer: "string",
url: "string",
visibility_duration: "int",
visibility_percentage: "int"
},
...
],
width: div-size
}Parameters
| Parameters | Description |
|---|---|
accessibility | object Accessibility settings. The value has the type |
action | object One action when clicking on an element. Not used if the The value has the type |
action_animation | object Click animation. The web only supports the following values: The value has the type Default value: |
actions | array Multiple actions when clicking on an element. An array must not be empty. |
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: |
auto_ellipsize | bool_int Automatic text cropping to fit the container size. Available platforms: Android. |
background | array Element background. It can contain multiple layers. An array must not be empty. |
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 |
doubletap_actions | array Action when double-clicking on an element. An array must not be empty. |
ellipsis | object Text cropping marker. It is displayed when text size exceeds the limit on the number of lines. The value has the type Available platforms: Android, iOS. |
extensions | array Extensions for additional processing of an element. The list of extensions is given in DivExtension. An array must not be empty. Available platforms: Android, iOS. |
focus | object Parameters when focusing on an element or losing focus. The value has the type Available platforms: Android. |
focused_text_color | string Text color when focusing on the element. Valid formats: Available platforms: Android. |
font_family | string Font family: text — a standard text font;display — a family of fonts with a large font size.Possible values: Default value: |
font_size | int Font size. Restriction for the value Default value: |
font_size_unit | string Possible values: Default value: Available platforms: Android, iOS. |
font_weight | string Style. Possible values: Default value: |
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: |
id | string Element ID. It must be unique within the root element. It is used as A string must not be empty. |
images | array Images embedded in text. An array must not be empty. |
letter_spacing | number Spacing between characters. Default value: |
line_height | int Line spacing of the text. Restriction for the value |
longtap_actions | array Action when long-clicking an element. Doesn't work on devices that don't support touch gestures. An array must not be empty. |
margins | object External margins from the element stroke. The value has the type |
max_lines | int Maximum number of lines not to be cropped when breaking the limits. Restriction for the value |
min_hidden_lines | int Minimum number of cropped lines when breaking the limits. Restriction for the value Available platforms: Android, iOS. |
paddings | object Internal margins from the element stroke. The value has the type |
ranges | array A character range in which additional style parameters can be set. Defined by mandatory An array must not be empty. |
row_span | int Merges cells in a string of the grid element. Restriction for the value |
selectable | bool_int Ability to select and copy text. Default value: |
selected_actions | array List of actions to be executed when selecting an element in pager. An array must not be empty. |
strike | string Strikethrough. Possible values: Default value: |
text | string Required parameter. Text. A string must not be empty. |
text_alignment_horizontal | string Horizontal text alignment. Possible values: Default value: |
text_alignment_vertical | string Vertical text alignment. Possible values: Default value: |
text_color | string Text color. Not used if the Valid formats: Default value: |
text_gradient | object Gradient text color. The value has the type List of possible values: |
tooltips | array Tooltips linked to an element. A tooltip can be shown by An array must not be empty. Available platforms: Android, iOS. |
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, browser. |
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 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 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 List of possible values: |
transition_triggers | array Animation starting triggers. Default value: An array must not be empty. |
truncate | string Parameter is deprecated. Text cropping method. Use Possible values: Default value: |
type | string Required parameter. The value must always be |
underline | string Underline. Possible values: Default value: |
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. An array must not be empty. |
width | object Element width. The value has the type Default value: |
| Parameters | Description |
|---|---|
accessibility | object Accessibility settings. The value has the type |
action | object One action when clicking on an element. Not used if the The value has the type |
action_animation | object Click animation. The web only supports the following values: The value has the type Default value: |
actions | array Multiple actions when clicking on an element. An array must not be empty. |
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: |
auto_ellipsize | bool_int Automatic text cropping to fit the container size. Available platforms: Android. |
background | array Element background. It can contain multiple layers. An array must not be empty. |
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 |
doubletap_actions | array Action when double-clicking on an element. An array must not be empty. |
ellipsis | object Text cropping marker. It is displayed when text size exceeds the limit on the number of lines. The value has the type Available platforms: Android, iOS. |
extensions | array Extensions for additional processing of an element. The list of extensions is given in DivExtension. An array must not be empty. Available platforms: Android, iOS. |
focus | object Parameters when focusing on an element or losing focus. The value has the type Available platforms: Android. |
focused_text_color | string Text color when focusing on the element. Valid formats: Available platforms: Android. |
font_family | string Font family: text — a standard text font;display — a family of fonts with a large font size.Possible values: Default value: |
font_size | int Font size. Restriction for the value Default value: |
font_size_unit | string Possible values: Default value: Available platforms: Android, iOS. |
font_weight | string Style. Possible values: Default value: |
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: |
id | string Element ID. It must be unique within the root element. It is used as A string must not be empty. |
images | array Images embedded in text. An array must not be empty. |
letter_spacing | number Spacing between characters. Default value: |
line_height | int Line spacing of the text. Restriction for the value |
longtap_actions | array Action when long-clicking an element. Doesn't work on devices that don't support touch gestures. An array must not be empty. |
margins | object External margins from the element stroke. The value has the type |
max_lines | int Maximum number of lines not to be cropped when breaking the limits. Restriction for the value |
min_hidden_lines | int Minimum number of cropped lines when breaking the limits. Restriction for the value Available platforms: Android, iOS. |
paddings | object Internal margins from the element stroke. The value has the type |
ranges | array A character range in which additional style parameters can be set. Defined by mandatory An array must not be empty. |
row_span | int Merges cells in a string of the grid element. Restriction for the value |
selectable | bool_int Ability to select and copy text. Default value: |
selected_actions | array List of actions to be executed when selecting an element in pager. An array must not be empty. |
strike | string Strikethrough. Possible values: Default value: |
text | string Required parameter. Text. A string must not be empty. |
text_alignment_horizontal | string Horizontal text alignment. Possible values: Default value: |
text_alignment_vertical | string Vertical text alignment. Possible values: Default value: |
text_color | string Text color. Not used if the Valid formats: Default value: |
text_gradient | object Gradient text color. The value has the type List of possible values: |
tooltips | array Tooltips linked to an element. A tooltip can be shown by An array must not be empty. Available platforms: Android, iOS. |
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, browser. |
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 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 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 List of possible values: |
transition_triggers | array Animation starting triggers. Default value: An array must not be empty. |
truncate | string Parameter is deprecated. Text cropping method. Use Possible values: Default value: |
type | string Required parameter. The value must always be |
underline | string Underline. Possible values: Default value: |
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. An array must not be empty. |
width | object Element width. The value has the type Default value: |
range
| Parameters | Description |
|---|---|
actions | array Action when clicking on text. An array must not be empty. |
background | object Character range background. The value has the type List of possible values: |
border | object Character range border. The value has the type |
end | int Required parameter. Ordinal number of the last character to be included in the range. Restriction for the value |
font_family | string Font family: text — a standard text font;display — a family of fonts with a large font size.Possible values: |
font_size | int Font size. Restriction for the value |
font_size_unit | string Unit of measurement: px — a physical pixel.dp — a logical pixel that doesn't depend on screen density.sp — a logical pixel that depends on the font size on a device. Specify height in sp. Only available on Android.Possible values: Default value: Available platforms: Android, iOS. |
font_weight | string Style. Possible values: |
letter_spacing | number Spacing between characters. |
line_height | int Line spacing of the text. Units specified in Restriction for the value |
start | int Required parameter. Ordinal number of a character which the range begins from. The first character has a number Restriction for the value |
strike | string Strikethrough. Possible values: |
text_color | string Text color. Valid formats: |
top_offset | int Top margin of the character range. Units specified in Restriction for the value |
underline | string Underline. Possible values: |
| Parameters | Description |
|---|---|
actions | array Action when clicking on text. An array must not be empty. |
background | object Character range background. The value has the type List of possible values: |
border | object Character range border. The value has the type |
end | int Required parameter. Ordinal number of the last character to be included in the range. Restriction for the value |
font_family | string Font family: text — a standard text font;display — a family of fonts with a large font size.Possible values: |
font_size | int Font size. Restriction for the value |
font_size_unit | string Unit of measurement: px — a physical pixel.dp — a logical pixel that doesn't depend on screen density.sp — a logical pixel that depends on the font size on a device. Specify height in sp. Only available on Android.Possible values: Default value: Available platforms: Android, iOS. |
font_weight | string Style. Possible values: |
letter_spacing | number Spacing between characters. |
line_height | int Line spacing of the text. Units specified in Restriction for the value |
start | int Required parameter. Ordinal number of a character which the range begins from. The first character has a number Restriction for the value |
strike | string Strikethrough. Possible values: |
text_color | string Text color. Valid formats: |
top_offset | int Top margin of the character range. Units specified in Restriction for the value |
underline | string Underline. Possible values: |
image
| Parameters | Description |
|---|---|
height | object Image height. The value has the type Default value: |
start | int Required parameter. A symbol to insert prior to an image. To insert an image at the end of the text, specify the number of the last character plus one. Restriction for the value |
tint_color | string New color of a contour image. Valid formats: |
tint_mode | string Blend mode of the color specified in Possible values: Default value: Available platforms: Android, browser. |
url | string Required parameter. Image URL. The value must be a valid URL. |
width | object Image width. The value has the type Default value: |
| Parameters | Description |
|---|---|
height | object Image height. The value has the type Default value: |
start | int Required parameter. A symbol to insert prior to an image. To insert an image at the end of the text, specify the number of the last character plus one. Restriction for the value |
tint_color | string New color of a contour image. Valid formats: |
tint_mode | string Blend mode of the color specified in Possible values: Default value: Available platforms: Android, browser. |
url | string Required parameter. Image URL. The value must be a valid URL. |
width | object Image width. The value has the type Default value: |
ellipsis
| Parameters | Description |
|---|---|
actions | array Actions when clicking on a crop marker. An array must not be empty. |
images | array Images embedded in a crop marker. An array must not be empty. |
ranges | array Character ranges inside a crop marker with different text styles. An array must not be empty. |
text | string Required parameter. Marker text. A string must not be empty. |
| Parameters | Description |
|---|---|
actions | array Actions when clicking on a crop marker. An array must not be empty. |
images | array Images embedded in a crop marker. An array must not be empty. |
ranges | array Character ranges inside a crop marker with different text styles. An array must not be empty. |
text | string Required parameter. Marker text. A string must not be empty. |