'Selection' tends to signify that a user has chosen a subset of options from a visible list. it is the common term for the _isActive status of the ComponentItemModel and ItemModel code.
Name
Description
Selected
The user has chosen this item
Not Selected
The user has not chosen this item
The indicators for selection include:
MCQ radio and checkboxes, either unfilled or filled
GMCQ highlighting
Hotgraphic pagination
Accordion highlighting / expansion
Narrative indicator highlighting
Matching highlighting / dropdown
Slider handle
Text input cursor
Completion
'Completion' usually denotes that a component, item or page has been interacted with in totality.
Completion is subject to the 'priority' of its children (blocks to articles, items to components, etc) and the rules governing their completion, such as inview states, item visited states, _requireCompletionOf, correctness criteria, branching ends etc.
Completion can also refer to the fulfillment of the course tracking criteria, a course is said to be complete at its conclusion.
Completion applies to menus, pages, articles, blocks and components.
Completion is usually called _isVisited for presentation component items.
Name
Description
Complete
Content does not need to be completed to mark the parent or tracking criteria complete.
Incomplete
Content needs to be completed to mark the parent or tracking criteria complete.
Current completion indicators include:
PageLevelProgress bars are either unfilled, partly filled or filled on menu items, the navigation bar, drawer items and title asides where utilised
Question buttons marking central icon with a tick or crosses
Question buttons button disablement
Question interface disablement
Menu ticks
Item visited ticks in Hotgraphic, Accordion, Media and Narrative
Item visited highlighting in Accordion, Narrative
Correctness
'Correctness' is a sub state of the 'complete', such that something generally can't be wholly marked for correctness whilst being incomplete.
Correctness tends to apply to question components, question component items and assessments.
Name
Current indicator
Correct
Tick and/or feedback
Partly correct
Cross and/or feedback
Incorrect
Cross and/or feedback
Current correctness indicators include:
Tutor for notify or inline feedback
Question buttons ticks and crosses
MCQ, GMCQ, Matching item ticks and crosses
Assessment correctness tends to have more complex criteria than item and question correctness, such as score or the number of items correct thresholds.
Name
Description
Pass
The specified criteria have been met.
Fail
The specified criteria have not been met.
Correctness feedback includes:
Assessment results
LMS completion/pass/fail status
Todo
Please add examples and references accordingly
If you need to critique or require changes, please open a new issue and reference this one
Add links to existing works
Add standard accessibility practises for conveying these statuses to users
Priority
'Priority' is a proposed name for the concept of 'optional vs required'. Priority applies to menus, pages, articles, blocks and components.
Existing priority indicators:
Works
Locked
Items which should not yet be accessed or which have criteria to unlock them can be considered 'locked'.
We use a locked icon and/or a disabled state to signify that something is locked.
Works
Visited
'Visited' is typically used to show that a some of page's children have been interacted with or that a component item had been selected.
Page visited has two potential modes:
Indicators for visited include:
Works
Selection
'Selection' tends to signify that a user has chosen a subset of options from a visible list. it is the common term for the
_isActivestatus of theComponentItemModelandItemModelcode.The indicators for selection include:
Completion
'Completion' usually denotes that a component, item or page has been interacted with in totality.
Completion is subject to the 'priority' of its children (blocks to articles, items to components, etc) and the rules governing their completion, such as inview states, item visited states,
_requireCompletionOf, correctness criteria, branching ends etc.Completion can also refer to the fulfillment of the course tracking criteria, a course is said to be complete at its conclusion.
Completion applies to menus, pages, articles, blocks and components.
Completion is usually called _isVisited for presentation component items.
Current completion indicators include:
Correctness
'Correctness' is a sub state of the 'complete', such that something generally can't be wholly marked for correctness whilst being incomplete.
Correctness tends to apply to question components, question component items and assessments.
Current correctness indicators include:
Assessment correctness tends to have more complex criteria than item and question correctness, such as score or the number of items correct thresholds.
Correctness feedback includes:
Todo