div-text
Text.
Parameters
Parameters | Description |
---|---|
text |
string Required parameter. Text. |
type |
string Required parameter. The value must always be |
accessibility |
object Accessibility settings. The value has the type Available platforms: Android, iOS, web. |
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: 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: |
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. List of possible values: |
auto_ellipsize |
bool_int Automatic text cropping to fit the container size. Available platforms: Android, web, Flutter. |
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. |
disappear_actions |
array Actions when an element disappears from the screen. Available platforms: Android, iOS, web. |
doubletap_actions |
array Action when double-clicking on an element. Available platforms: Android, iOS, web. |
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. Available platforms: Android, iOS, web. |
focus |
object Parameters when focusing on an element or losing focus. The value has the type |
focused_text_color |
string Text color when focusing on the element. Valid formats: Available platforms: Android, web. |
font_family |
string Font family: text — a standard text font;display — a family of fonts with a large font size.Available platforms: Android, iOS, web. |
font_feature_settings |
string List of OpenType font features. The format matches the CSS attribute "font-feature-settings". Learn more: https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop Available platforms: Android, iOS, web. |
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: |
font_weight_value |
int Style. Numeric value. Restriction for the value Available platforms: iOS, Android, web. |
functions |
array User functions. Available platforms: iOS. |
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 |
images |
array Images embedded in text. Available platforms: Android, iOS, web. |
layout_provider |
object Provides data on the actual size of the element. The value has the type Available platforms: Android, iOS, web. |
letter_spacing |
number Spacing between characters. Default value: Available platforms: Android, iOS, web. |
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. Available platforms: Android, iOS, web. |
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 Available platforms: Android, iOS, web. |
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. |
selectable |
bool_int Ability to select and copy text. Default 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. |
strike |
string Strikethrough. Possible values: Default value: |
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 Available platforms: Android, iOS, web. List of possible values: |
text_shadow |
object Parameters of the shadow applied to the text. The value has the type Available platforms: Android, web. |
tighten_width |
bool_int Set text width to maximal line width, works only with wrap_content width with constrained=true and max_size set Default value: Available platforms: Android, iOS. |
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. |
truncate |
string Parameter is deprecated. Text cropping method. Use Possible values: Default value: Available platforms: Android, iOS. |
underline |
string Underline. Possible values: Default value: |
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 Available platforms: Android, iOS, web. |
visibility_actions |
array Actions when an element appears on the screen. Available platforms: Android, iOS, web. |
width |
object Element width. The value has the type Default value: List of possible values: |
range
Parameters | Description |
---|---|
actions |
array Action when clicking on text. Available platforms: Android, iOS, web. |
alignment_vertical |
string Vertical text alignment within the row. Possible values: Available platforms: Android, web. |
background |
object Character range background. The value has the type Available platforms: Android, iOS, web. List of possible values: |
border |
object Character range border. The value has the type Available platforms: Android, iOS, web. |
end |
int Ordinal number of the last character to be included in the range. If property is omitted, the range will end at the last character of the text. Restriction for the value Available platforms: Android, iOS, web. |
font_family |
string Font family: text — a standard text font;display — a family of fonts with a large font size.Available platforms: Android, iOS, web. |
font_feature_settings |
string List of OpenType font features. The format matches the CSS attribute "font-feature-settings". Learn more: https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop Available platforms: Android, iOS, web. |
font_size |
int Font size. Restriction for the value Available platforms: Android, iOS, web. |
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: Available platforms: Android, iOS, web. |
font_weight_value |
int Style. Numeric value. Restriction for the value Available platforms: iOS, web, Android. |
letter_spacing |
number Spacing between characters. Available platforms: Android, iOS, web. |
line_height |
int Line spacing of the text. Units specified in Restriction for the value Available platforms: Android, iOS, web. |
start |
int Ordinal number of a character which the range begins from. The first character has a number Restriction for the value Default value: Available platforms: Android, iOS, web. |
strike |
string Strikethrough. Possible values: Available platforms: Android, iOS, web. |
text_color |
string Text color. Valid formats: Available platforms: Android, iOS, web. |
text_shadow |
object Parameters of the shadow applied to the character range. The value has the type Available platforms: Android, web. |
top_offset |
int Top margin of the character range. Units specified in Restriction for the value Available platforms: Android, iOS, web. |
underline |
string Underline. Possible values: Available platforms: Android, iOS, web. |
image
Parameters | Description |
---|---|
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 Available platforms: Android, iOS, web. |
url |
string Required parameter. Image URL. The value must be a valid URL. Available platforms: Android, iOS, web. |
accessibility |
object The value has the type Available platforms: Android. |
alignment_vertical |
string Vertical image alignment within the row. Possible values: Default value: Available platforms: Android, web. |
height |
object Image height. The value has the type Default value: Available platforms: Android, iOS, web. |
preload_required |
bool_int Background image must be loaded before the display. Default value: Available platforms: web. |
tint_color |
string New color of a contour image. Valid formats: Available platforms: Android, iOS, web. |
tint_mode |
string Blend mode of the color specified in Possible values: Default value: Available platforms: Android, web. |
width |
object Image width. The value has the type Default value: Available platforms: Android, iOS, web. |
accessibility
Parameters | Description |
---|---|
description |
string Element description. It is used as the main description for screen reading applications. Available platforms: Android. |
type |
string Element role. Used to correctly identify an element by the accessibility service. For example, the Possible values: Default value: Available platforms: Android. |
ellipsis
Parameters | Description |
---|---|
text |
string Required parameter. Marker text. Available platforms: Android, iOS. |
actions |
array Actions when clicking on a crop marker. Available platforms: Android, iOS, web. |
images |
array Images embedded in a crop marker. Available platforms: Android, iOS, web. |
ranges |
array Character ranges inside a crop marker with different text styles. Available platforms: Android, iOS, web. |
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, ... ]
},
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, ... ],
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: "number"
}
},
column_span: "int",
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"
},
...
],
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"
},
...
],
ellipsis: {
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"
},
...
],
images: [
{
accessibility: {
description: "string",
type: "string"
},
alignment_vertical: "string",
height: {
type*: "fixed",
unit: "string",
value*: "int"
},
preload_required: "bool_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, ... ]
},
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_vertical: "string",
background: div-text-range-background,
border: {
corner_radius: "int",
stroke: {
color*: "string",
unit: "string",
width: "number"
}
},
end: "int",
font_family: "string",
font_feature_settings: "string",
font_size: "int",
font_size_unit: "string",
font_weight: "string",
font_weight_value: "int",
letter_spacing: "number",
line_height: "int",
start: "int",
strike: "string",
text_color: "string",
text_shadow: {
alpha: "number",
blur: "int",
color: "string",
offset*: {
x*: {
unit: "string",
value*: "number"
},
y*: {
unit: "string",
value*: "number"
}
}
},
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: "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"
},
...
]
},
focused_text_color: "string",
font_family: "string",
font_feature_settings: "string",
font_size: "int",
font_size_unit: "string",
font_weight: "string",
font_weight_value: "int",
functions: [
{
arguments*: [
{
name*: "string",
type*: "string"
},
...
],
body*: "string",
name*: "string",
return_type*: "string"
},
...
],
height: div-size,
id: "string",
images: [
{
accessibility: {
description: "string",
type: "string"
},
alignment_vertical: "string",
height: {
type*: "fixed",
unit: "string",
value*: "int"
},
preload_required: "bool_int",
start*: "int",
tint_color: "string",
tint_mode: "string",
url*: "string",
width: {
type*: "fixed",
unit: "string",
value*: "int"
}
},
...
],
layout_provider: {
height_variable_name: "string",
width_variable_name: "string"
},
letter_spacing: "number",
line_height: "int",
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"
},
max_lines: "int",
min_hidden_lines: "int",
paddings: {
bottom: "int",
end: "int",
left: "int",
right: "int",
start: "int",
top: "int",
unit: "string"
},
ranges: [
{
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_vertical: "string",
background: div-text-range-background,
border: {
corner_radius: "int",
stroke: {
color*: "string",
unit: "string",
width: "number"
}
},
end: "int",
font_family: "string",
font_feature_settings: "string",
font_size: "int",
font_size_unit: "string",
font_weight: "string",
font_weight_value: "int",
letter_spacing: "number",
line_height: "int",
start: "int",
strike: "string",
text_color: "string",
text_shadow: {
alpha: "number",
blur: "int",
color: "string",
offset*: {
x*: {
unit: "string",
value*: "number"
},
y*: {
unit: "string",
value*: "number"
}
}
},
top_offset: "int",
underline: "string"
},
...
],
reuse_id: "string",
row_span: "int",
selectable: "bool_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"
},
...
],
strike: "string",
text*: "string",
text_alignment_horizontal: "string",
text_alignment_vertical: "string",
text_color: "string",
text_gradient: div-text-gradient,
text_shadow: {
alpha: "number",
blur: "int",
color: "string",
offset*: {
x*: {
unit: "string",
value*: "number"
},
y*: {
unit: "string",
value*: "number"
}
}
},
tighten_width: "bool_int",
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",
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
}