Ranker
The Ranker
tag is used to rank items in a list or pick relevant items from a list, depending on mode
parameter. Task data referred in value
parameter should be an array of objects with id
, title
, and body
fields.
Results are saved as an array of id
s in result
field.
Columns and items can be styled in Style
tag by using respective .htx-ranker-column
and .htx-ranker-item
classes. Titles of one or two columns are defined in single title
parameter.
Parameters
Param | Type | Description |
---|---|---|
value | string |
Data field containing a JSON with array of objects (id, title, body) to rank |
[mode] | rank | select |
rank: 1 column, reorder to rank, select: 2 columns, drag results to second column to select |
[title] | string |
Title(s) of the column(s), separate them by ` |
Example
Visual appearance can be changed via Style tag with these classnames
<View>
<Style>
.htx-ranker-column { background: cornflowerblue; }
.htx-ranker-item { background: lightgoldenrodyellow; }
</Style>
<Ranker name="ranker" value="$items" mode="rank" title="Search Results"/>
</View>
Example
Example data and result for Ranker tag
{
"items": [
{ "id": "blog", "title": "10 tips to write a better function", "body": "There is nothing worse than being left in the lurch when it comes to writing a function!" },
{ "id": "mdn", "title": "Arrow function expressions", "body": "An arrow function expression is a compact alternative to a traditional function" },
{ "id": "wiki", "title": "Arrow (computer science)", "body": "In computer science, arrows or bolts are a type class..." },
]
}
{
"from_name": "ranker",
"to_name": "ranker",
"type": "ranker",
"value": { "ranker": ["mdn", "wiki", "blog"] }
}