Select Text

Use it in an item

Map the tag to an exact package version and match the model ID to the markup. The item player loads the views. You can use any frontend framework.

{
  "elements": {
    "select-text": "@pie-element/select-text@14.0.4"
  },
  "markup": "<select-text id=\"example\"></select-text>",
  "models": [
    {
      "id": "example",
      "element": "select-text",
      "highlightChoices": false,
      "feedback": {
        "correct": {
          "type": "default",
          "default": "Correct"
        },
        "incorrect": {
          "type": "default",
          "default": "Incorrect"
        },
        "partial": {
          "type": "default",
          "default": "Nearly"
        }
      },
      "partialScoring": false,
      "maxSelections": 2,
      "mode": "sentence",
      "rationale": "Rationale goes here.",
      "prompt": "What sentences contain the character 6 in them?",
      "promptEnabled": true,
      "toolbarEditorPosition": "bottom",
      "text": "<p>If 'tweren't for sight and sound and smell,<br />\nI'd like the city pretty well,<br />\nBut when it comes to getting rest,<br />\nI like the country lots the best.</p>\n\n<p>Sometimes it seems to me I must<br />\nJust quit the city's din and dust,<br />\nAnd get out where the sky is blue,<br />\nAnd say, now, how does it seem to you?</p>",
      "tokens": [
        {
          "text": "If 'tweren't for sight and sound and smell,",
          "start": 0,
          "end": 43
        },
        {
          "text": "I'd like the city pretty well,",
          "start": 44,
          "end": 74
        },
        {
          "text": "But when it comes to getting rest,",
          "start": 75,
          "end": 109
        },
        {
          "text": "I like the country lots the best.",
          "start": 110,
          "end": 143
        },
        {
          "text": "Sometimes it seems to me I must",
          "start": 145,
          "end": 176
        },
        {
          "text": "Just quit the city's din and dust,",
          "start": 177,
          "end": 211
        },
        {
          "text": "And get out where the sky is blue,",
          "start": 212,
          "end": 246
        },
        {
          "text": "And say, now, how does it seem to you?",
          "start": 247,
          "end": 285
        }
      ],
      "rubricEnabled": false
    }
  ]
}

Embed an item · Embed authoring · Print integration

Responses and scoring

The controller defines scoring for this element. Browser scoring returns one outcome per element. Your application combines those outcomes into an item score and handles trusted server scoring.

Scoring, partial credit and rubrics →

Model, configuration and session reference

The model holds content, configuration controls the editor, and the session holds the response. Fields below come from generated JSON Schemas.

Schema version: @pie-element/select-text@14.0.6. Example version: 14.0.4. Use the schema matching your content. Schema checks cover data structure; controller validation checks authoring rules.

How to use the schemas →

Accessibility and content requirements

PIE targets WCAG 2.2 AA. Provide clear prompts and media alternatives, and test the question with a keyboard and assistive technology. Manual testing is still incomplete; see the coverage notes below.

Accessibility and evidence · Element evidence and manual checks(opens in new tab)