The Items API (with assessment player) can be initialized to display content from right-to-left (RTL), to support languages such as Arabic.
This feature helps facilitate internationalization of the assessment player and assessments for languages that rely on RTL script.
Initializing Items API in RTL mode
Right-To-Left script mode has only minimal additional criteria on top of the regular initialization of Items API.
It requires a data attribute data-lrn-dir="rtl"
to be added to the API script element:
<script src="https://items.learnosity.com?[version]"
data-lrn-dir="rtl"></script>
In conjunction with the internationalization configurations available (compiled below), Items API with assessment player can be flexibly localized.
<div id="learnosity_assess"></div>
<script src="https://items.learnosity.com?[version]" data-lrn-dir="rtl"></script>
<script>
var initOptions = {
"rendering_type": "assess",
"config": {
...
"labelBundle": {
// Here is where we can replace UI labels
// for the Assess player with key-value pairs
// (referenced below)
},
"questions_api_init_options": {
"labelBundle": {
// Here is where we can replace
// UI labels for Questions with
// key-value pairs (referenced below)
}
}
}
};
var itemsApp = LearnosityItems.init(initOptions);
</script>
Code Example 1: Items API Internationalization Configurations
Supported Question types
The following Question types are supported in RTL:
- Choice Matrix (choicematrix)
- Drawing (drawing)
- Essay (longtextV2)
- Fill in the Blanks - text (clozetext)
- Fill in the Blanks - dropdown (clozedropdown)
- Fill in the Blanks - drag & drop (clozeassociation)
- Fill in the Blanks w/image background - text (imageclozetext)
- Fill in the Blanks w/image background - dropdown (imageclozedropdown)
- Fill in the Blanks w/image background - drag & drop (imageclozeassociationV2)
- Image highlight Deprecated (highlight)
- Multiple Choice (mcq)
- Passage (sharedpassage)
- Token Highlight (tokenhighlight)
Demo
You can see the Learnosity RTL implementation on our demo site.
Mixed usage
Cases, where you want to render the assessment player in one direction and have the Item contents rendered in another, are also supported. The list of supported combinations for the data-lrn-dir
data attribute are listed below.
For example, this can be useful when you want to render the assessment player in Arabic and want to display an Activity that is related to learning English.
data-lrn-dir |
Assessment player | Item content |
ltr | Left-to-right | Left-to-right |
rtl | Right-to-left | Right-to-left |
ltr-rtl | Left-to-right | Right-to-left |
rtl-ltr | Right-to-left | Left-to-right |
Next steps
For more information, see the article about Configuring Author API in RTL mode, or Translating the Learnosity UI with Label Bundles.
To get up and running, consider looking at the internationalization repo that contains label bundles, Question Editor templates and thumbnails. You can see these in action via our authoring RTL demo.