Learn how to style Learnosity components.
Learnosity is designed with a neutral design so that it blends seamlessly with your existing platform and styling. This also provides a great starting point on which to apply further styling with CSS, to fit perfectly with your design vision.
All Learnosity APIs use scoping to prevent any Learnosity CSS from affecting the host page. This has the added benefit of allowing the host page to specifically target and style the component using standard CSS class selectors.
All API's have a .lrn
class at the root level, as well as an API-specific class. For example .lrn_widget
is at the root level of the Questions API, .lrn-assess
for the Assess API and .lrn-qe
for the Question Editor API.
Examples
These live demos show how a Learnosity assessment can be fully restyled with standard CSS.
See the following sections for useful selectors for each API.
Questions API
Common selectors
The are a number of common selectors that can be used across all Question types.
.lrn.lrn_widget
wraps each Question at the top level,.lrn_stimulus
is the Question stimulus that is being asked,.lrn_response
targets the response area for the Question,.lrn_validate
wraps the optional "Check Answer" button, and.lrn_correctAnswerList
(Review Only) targets the correct answer feedback area.
Question type selectors
It is also possible to target classes of Questions based on their core type - some examples of these are:
.lrn_mcq
for MCQ Question types, including single select (radio) and multi Select (checkbox)..lrn_association
for association Question type..lrn_clozetext
for cloze text Question type.
The Questions API styling demo has interactive examples of all the available selectors.
Other selectors
There are also a number of components that may be common across Question types, or may be shared across similar Question types. Some examples of these are:
.lrn_cloze_response
Response area for all cloze types including dropdowns, text input, and drop areas..lrn_possibilityList
container area for buttons to be dragged from..lrn_btn_drag
draggable buttons that may contain text, math, or images..lrn_mcqgroup label
MCQ Question labels.
The Questions API styling demo has interactive examples of all the available selectors.
Assess API
The Assess API has a number of selectors that allows it to be targeted easily with CSS, and it uses all the CSS from the Questions API, too.
.lrn.lrn-assess
wrapper for the whole Assess player,.lrn-region
this exists on all regions of Assess when using regions mode,.lrn-top-left-region
target the top left region,.lrn-top-right-region
target the top right region,.lrn-items-region
target the main content area where Items & Questions are displayed,.lrn-right-region
target the right hand side region,.lrn-bottom-left-region
target the bottom left region,.lrn-bottom-region
target the bottom region, and.lrn-bottom-right-region
target the bottom right region.
Items API
The Items API is a light wrapper around the Assess or Questions API. Use a different selector depending on which mode is initialized:
- In
inline
mode all Items on will be wrapped with a.lrn.learnosity-item
class, or - In
assess
mode the Assess API will have the.lrn.lrn-assess
class.
Author API
The Author API has the following classes defined at the root level:
.lrn.lrn-author
standard wrapper class for Author API.
Question Editor API
The Question Editor API has the following classes defined at the root level:
.lrn.lrn-qe
standard wrapper class for Question Editor.
The following additional selectors can be used with the Question selection view:
.lrn-qe-tiles-nav
container for the left hand tile navigation when selecting Question groups..lrn-qe-tiles-list
container for the right hand side tiles when selecting a Question.
These additional selectors can be used with the Question edit view:
.lrn-qe-toolbar
container for toolbar at top of the editing pane..lrn-qe-col-edit
container for the editing column..lrn-qe-col-slider
container for the slider between the editing and preview columns..lrn-qe-col-preview
container for the preview column.
Additional detail is available for the Question Editor on the Question Editor API - CSS Classname Utility page.
Reports API
The Reports API has the learnosity-report
at the top level of every report that it renders, and it also includes a class which matches the type of report. For example: sessions-summary
or sessions-summary-by-tag
which allows for easy targetting of specific report styles.
Last Score by Item by User
Obtain the latest activity score with a break-down of its constituent items. Hover over Items to see the fine grain score break-down. Below is the color value to each possible outcome and the common selector.
.lrn-circle-correct
provides a green circle to indicate fully correct,.lrn-circle-incorrect
provides a red circle to indicate completely incorrect,.lrn-circle-partial
provides a yellow circle to indicate partially correct,.lrn-circle-not-attempted
provides a light gray circle to indicate not attempted, and.lrn-circle-not-marked
provides a dark gray circle to indicate not marked.
Keeping your styles up to date
With every Long Term Support (LTS) release for the Learnosity APIs, we often add new features and make adjustments to our products to ensure they meet (or exceed) web accessibility standards. We often try to keep our UI changes to a minimum to reduce the amount of work required when upgrading to a newer LTS version. For more information on keeping up to date with UI improvements, see Viewing Interface Changes Between LTS Versions and our LTS Migration Guides.