Skip to content

Ordinal Bin

Bryan Fox edited this page Oct 4, 2018 · 1 revision

Purpose

The ordinal bin interface allows ordinal data to be assigned to nodes. The participant drags nodes into an appropriate "bin" to assign the value.

Configuration

Each prompt defines a variable, whose value identifies an entry in the variable registry. The valid options for the ordinal value are defined in that variable registry entry.

See also the General Interface API.

Example definition

{
  "id": "ordinalBin1",
  "type": "OrdinalBin",
  "label": "Contact Freq.",
  "subject": {
    "entity": "node",
    "type": "person"
  },
  "prompts": [
    {
      "id": "contactFreq",
      "text": "Contact frequency ordinal variable",
      "variable": "contactFreq",
      "//": "Ordinal variables have valid options defined in variable registry.",
      "bucketSortOrder": [
        {
          "property": "nickname",
          "direction": "desc"
        }
      ],
      "binSortOrder": [
        {
          "property": "nickname",
          "direction": "desc"
        },
        {
          "property": "age",
          "direction": "desc"
        }
      ]
    },
    {
      "id": "discussFreq",
      "text": "Discussion Frequency variable, with a much longer prompt than the previous prompt. Please also note that this prompt uses the color override to style these bins differently than the main prompt.",
      "variable": "discussFreq",
      "color": "ord-color-seq-2"
    }
  ]
}