Configuration of the Assignment Elements (CSS)

Last modified by Anna Paul-Hasenfuss on 13.11.2024

ONYX allows you to customise the design of assignment elements via CSS. With CSS, objects such as the elements of a match interaction task (drag-and-drop) can be customised with regard to their size and spacing for the display on a screen.

Note: The individual layout of the assignment element, in terms of size and spacing, works only within the browser. The configured layout is not available for export (PDF export, performance results page, etc.). It is necessary to have a basic understanding in HTML and CSS to use this function.

Content

The procedure for changing the size and the spacing of assignment elements is explained by the example of an assignment task on the subject of Johann Wolfgang von Goethe. The assignment element contains text quotations from the works of the poet. The default display of the assignment task restricts the assignment element to 300 pixels (px) width and provides only a small distance to the edge in order to optimise the space requirement and to optimally integrate picture media. For long text passages, however, a wider display of the boxes and an increased distance to the edge may be desired.

Order_without_css.pngOrder_with_css.png

The increased width of the assignment element, for example, complicates the navigation during tests taken on devices with small screens, e.g. smartphones.

STEP 1: Creating a new match interaction

The configuration is possible for the assignment element of a simple match interaction (drag-and-drop). To create the task, proceed as usual. Detailed instructions can be found in the help section Match interaction.

STEP 2: Configuration of the assignment elements (CSS)

The individual configuration for the size and distance of the content to the edge of the assignment elements is done in a separate CSS file, which you can upload to any task.

You can use the following CSS statements as a template:

.interaction-match .dragCont {min-width: 500px;}
.interaction-match .dragCont div {padding: 10px;}

The setting min-width defines the size of the assignment elements. The default setting, if no CSS configuration is present, is 300 px.

The setting padding defines the distance of the content to the edge of the assignment elements. The default setting, if no CSS configuration is present, is 0 px.

STEP 3: Adding the CSS file to the task

Save your CSS statement in a CSS file *.css. Now you can upload this file in the Options tab under Layout setting. Detailed instructions can be found in the help section Create task > Layout settings or Test configuration.

Please note:

  • If the CSS file is uploaded to a question, it will affect the layout of such.
  • If the CSS file is uploaded to a test, all selection tasks of the entire test are designed accordingly.
  • If the Show all questions of a section per page option is activated on the test, a CSS file on an individual question affects all questions in the same section.