Documentation

Paragraph

Description

The Paragraph module allows the user to enter a free-form text. It also allows providing basic formatting in a WYSIWYG way (similar to MS Word and other rich text editors).

Properties

The list starts with the common properties, learn more about them by visiting the Modules description section. The other available properties are described below.

Property name Description
Default font family Set the default font family for the editor's body. The value should be expressed in the same way as in the CSS. It is a comma-separated list of font names.
For example: Helvetica, Arial, Verdana.
For more information, visit:
http://www.w3schools.com/cssref/pr_font_font-family.asp
Default font size Set the default font size for the editor's body. The value should be expressed in the same way as in the CSS. It is a numeric value with a unit.
For example: 14px, 3em.
For more information, please visit:
http://www.w3schools.com/cssref/pr_font_font-size.asp
Hide toolbar Hides the toolbar and thus extends the editable area.
Editable placeholder Makes placeholder editable, so its contents will not be cleared on focus on the module.
Custom toolbar Enables to define a custom toolbar. Below is a list of all available toolbar/menu controls that you can add to your Paragraph module:

newdocument bold italic underline strikethrough alignleft aligncenter alignright alignjustify styleselect formatselect fontselect fontsizeselect bullist numlist outdent indent blockquote undo redo removeformat subscript superscript

Note: Use pipe "|" to group buttons.
Custom CSS This property lets you specify a separate file with custom CSS styles extending the main CSS content. This CSS file is used within the editor (the editable area).
If "Default font family" and "Default font size" are defined, they have higher priority than styles used in the "Custom CSS" file.

This property allows online resources. Find out more »

Placeholder text This property enables you to specify free text content to be used as a placeholder in the Paragraph. Allows for HTML styling.
Layout Type Choose the "Default" or "French" layout.
Manual grading Selecting this Paragraph's property allows the teacher to manually grade the Paragraph’s content when the lesson is part of the submitted Assignment. The Paragraph can be instantly viewed by the teacher in the Assignment's results on the LMS and possibly be verified without previewing the lesson.
Show Answers A list of correct answers. On Show Answers, all correct answers are displayed at the same time, each answer separated by a new line. On Gradual Show Answers, correct answers are displayed gradually, one after another, each time a Gradual Show Answers event is triggered.
Title The title of the Paragraph is visible when the Assignment’s open activities are manually graded on mCourser. The title is visible above each Paragraph's preview; however, it is not visible in the lesson itself.
Weight The maximum number of points the teacher can grant when grading the Assignment's open activities. This can be only a natural number. The default Paragraph’s weight equals 1.
Printable Allows to choose if the module should be included in the printout.
Speech texts List of speech texts: Selected, Deselected, Paragraph content, Bold, Italic, Underline, Align left, Align center, Align right, Justify. This text will be read by the Text to Speech module after the user performs a certain action.
Lang attribute This property allows defining the language for this module (different than the language of the lesson).
Block in error checking mode If this option is selected, the module is blocked in the error checking mode.

Supported commands

Command name Params Description
show --- Shows the module if it is hidden.
hide --- Hides the module if it is visible.
isVisible --- Returns true if the module is visible, otherwise false.
getText --- Returns module's content.
setText text Sets the content of the module to the text given as parameter.
isAttempted --- Returns true if any text was inserted.
lock --- Covers the module with the mask.
unlock --- Removes the mask from the module.

Scoring

This module does not provide any score information.

Events

Field name Description
Value blur - event sent on exiting the module.

Demo presentation

Demo presentation contains examples of the Paragraph module.