Documentation
Clock
Description
This addon allows users to create activities related to clock and time.
Properties
| Property name | Description |
|---|---|
| Time Standard | Enables to choose the time display (12H or 24H). |
| Initial Time | Enables to set the initial time for the addon. The time should be entered in a 00:00 or 0:00 format. If Show Second Hand is active this property requires format 00:00:00. |
| Minutes step | Enables to choose the big hand minute step. For example, if you define the step as 5, the big hand will be moved every 5 minutes. |
| Show Clock Labels | Enables to show the clock labels. |
| Show second hand | Enables third hand for seconds. |
| Seconds step | Same as the Minutes step but defined for seconds. |
| Active Hand | This property allows choosing the active clock hand. |
| Synchronize Hands | This property allows you to choose how the hands should be synchronized. |
| Images | Enables to set an image as a background. Please note that this property does not support the SVG format. This property allows online resources. Find out more » |
| Correct Answer | Defines the correct answer (required when “Is Activity” is checked). The time should be entered in a 00:00 or 0:00 format. |
| Is Disabled | Defines whether the clock addon is disabled. |
| Is Activity | Enables to define whether the Clock addon is an activity or not. |
Supported commands
| Command name | Params | Description |
|---|---|---|
| setClockTime | time (h : min) |
Sets the clock's time. |
| getCurrentTime | --- | Returns current time (hours : minutes). |
| getCurrentHour | --- | Returns current hour. |
| getCurrentMinute | --- | Returns current minute. |
| show | --- | Shows the addon. |
| hide | --- | Hides the addon. |
| enable | --- | Enables the addon |
| disable | --- | Disables the addon. |
| markAsCorrect | --- | Marks the addon as correct. |
| markAsWrong | --- | Marks the addon as wrong. |
| markAsEmpty | --- | Removes all addon marks. |
Events
The Clock addon sends events to Event Bus when a user selects/deselects its element.
| Field name | Description |
|---|---|
| Item | Always 1 |
| Value | Current time |
| Score | 1 when the addon has a correct answer, 0 for other answers |
CSS classes
| Class name | Description |
|---|---|
| .analog-clock | Main class containing the entire Addon's content. |
| .analog-clock.disable | Added when the module is disabled. |
| .analog-clock.incorrect | Added when the module is incorrect in the show errors mode. |
| .analog-clock.correct | Added when the module is correct in the show errors mode. |
Styles from a sample presentation
To imrove the user experience while working with the Clock addon on mobile devices, there is the possibility of enlarging the active/clickable area of the clock hands without visually increasing their size. It can be achieved by adding the "stroke-width" class and setting the "stroke-opacity" to zero. Please note that if the "stroke-width" value is too big, it may cause the clock hands to cover each other up. By default, the "stroke-width" is set to 50px.
.Clock_test{
}
.Clock_test .analog-clock{
padding: 10px;
border: 3px solid #bbbbbb;
background: #ffffff;
}
.Clock_test .analog-clock #m-hand{
stroke-width:50px;
stroke-opacity:0;
}
.Clock_test2 .analog-clock #h-hand{
stroke-width:50px;
stroke-opacity:0;
}
.Clock_test .analog-clock.disable{
opacity: 0.5;
}
.Clock_test .analog-clock.incorrect{
border: 3px solid #ff4901;
}
.Clock_test .analog-clock.correct{
border: 3px solid #06d401;
}
Demo presentation
Demo presentation contains examples of how this addon can be used.
