Voting
Voting is a comfortable tool for automatic calculation of the users votes and save the information about that. The vote is counted only after clicking on the icon.
Functional Characteristics
Use this element to vote for any topic. It's also handy for collecting likes under posts.
Value Format
The value of the voting element are the IDs of the user who had voted, separated by commas.
{
"field_value": "1547"
}
Element Options
The voting options consists of one group - Field Settings. It contains its own unique set of options.
Field Settings
The main settings of configuration the voting element are contained here. Two of them are the standard Field Name and Name Space.
Name | Description |
---|---|
Icon | allows to select icon which will be displayed; details... |
Show Legend | allows users to see others who voted; details... |
Icon Color | allows to select icon color; details... |
Icon
This button allows to open the catalogue of different icons and to select which of them will be displayed in application.
Legend
The legend is a list of users who voted. It is displayed in application as a black popup list with users names and icons.
Icon Color
This option allows you to set the color of the icon with the help of color picker.
Element Style
As you can see, this element does not have special options of its style, only have standard settings about that you can read in Setting Overview. As for its interpretations, they are described below.
Data Model
This element has quite big data model. Part of its properties related to the icon.
{
"data_model":{
"icon": "love_heart",
"icon_color": "#18a9e8",
"interpretation": [],
"min_digits_count": -1,
"show_legend": 1
}
}
Name | Type | Description |
---|---|---|
icon | string |
name of selected icon |
icon_color | string |
selected color of icon |
interpretation | array |
contains all interpretation types of voting |
min_digits_count | number |
minimum number of digits |
show_legend | boolean |
shows voting legend is displayed or not |
Filtration
Since the voting element always has a value, it can be filtered out by only that filters that search by comparing full values.
Interpretation
The voting element has only three types of interpretation.
Default
The default type allows users to vote and accordingly update the value.
Plain text
This interpretation allows only display the number of votes. Namely, it makes the element uneditable.
Value
The last interpretation type displays the value of the field.