tags
- Introduction
Object Tags
- Audio
- HyperText
- Image
- Paragraphs
- Table
- Text
- TimeSeries
- Video
Control Tags
- Brush
- BrushLabels
- Choice
- Choices
- DateTime
- Ellipse
- EllipseLabels
- HyperTextLabels
- KeyPoint
- KeyPointLabels
- Label
- Labels
- List
- Number
- Pairwise
- ParagraphLabels
- Polygon
- PolygonLabels
- Ranker
- Rating
- Rectangle
- RectangleLabels
- Relation
- Relations
- Shortcut
- Taxonomy
- TextArea
- TimeSeriesLabels
- VideoRectangle
Visual & Experience Tags
- Collapse
- Filter
- Header
- Repeater
- Style
- View
Choices
The Choices
tag is used to create a group of choices, with radio buttons or checkboxes. It can be used for single or multi-class classification. Also, it is used for advanced classification tasks where annotators can choose one or multiple answers.
Choices can have dynamic value to load labels from task. This task data should contain a list of options to create underlying
The Choices
tag can be used with any data types.
Parameters
Param | Type | Default | Description |
---|---|---|---|
name | string |
Name of the group of choices | |
toName | string |
Name of the data item that you want to label | |
[choice] | single | single-radio | multiple |
single |
Single or multi-class classification |
[showInline] | boolean |
false |
Show choices in the same visual line |
[required] | boolean |
false |
Validate whether a choice has been selected |
[requiredMessage] | string |
Show a message if validation fails | |
[visibleWhen] | region-selected | choice-selected | no-region-selected |
Control visibility of the choices. | |
[whenTagName] | string |
Use with visibleWhen. Narrow down visibility by name of the tag. For regions, use the name of the object tag, for choices, use the name of the choices tag | |
[whenLabelValue] | string |
Narrow down visibility by label value | |
[whenChoiceValue] | string |
Narrow down visibility by choice value | |
[perRegion] | boolean |
Use this tag to select a choice for a specific region instead of the entire task | |
[value] | string |
Task data field containing a list of dynamically loaded choices (see example below) | |
[allowNested] | boolean |
Allow to use children field in dynamic choices to nest them. Submitted result will contain array of arrays, every item is a list of values from topmost parent choice down to selected one. |
Example
Basic text classification labeling configuration
<View>
<Choices name="gender" toName="txt-1" choice="single-radio">
<Choice alias="M" value="Male" />
<Choice alias="F" value="Female" />
<Choice alias="NB" value="Nonbinary" />
<Choice alias="X" value="Other" />
</Choices>
<Text name="txt-1" value="John went to see Mary" />
</View>
Example (This config with dynamic labels)
<View>
<Audio name="audio" value="$audio" />
<Choices name="transcription" toName="audio" value="$variants" />
</View>
<!-- {
"data": {
"variants": [
{ "value": "Do or doughnut. There is no try." },
{ "value": "Do or do not. There is no trial." },
{ "value": "Do or do not. There is no try." },
{ "value": "Duo do not. There is no try." }
]
}
} -->
Example (is equivalent to this config)
<View>
<Audio name="audio" value="$audio" />
<Choices name="transcription" toName="audio" value="$variants">
<Choice value="Do or doughnut. There is no try." />
<Choice value="Do or do not. There is no trial." />
<Choice value="Do or do not. There is no try." />
<Choice value="Duo do not. There is no try." />
</Choices>
</View>
Couldn't find what you were looking for? Please let us know on
Slack
If you found an error, you can file an issue on GitHub!

If you found an error, you can file an issue on GitHub!