Placing Gaps on a Background Graphic (CSS)

The procedure for placing gaps on a background graphic is explained using the example of a question about Saxony. A map of the Free State of Saxony serves as a background graphic. Three gaps are placed on the map so that the names of the cities can be entered directly in the correct place on the map.

STEP 1: Create new question in text entry format

The ONYX Editor supports various text entry formats (e. g. text entry, numerical input, calculation, formula comparison). Placing the gaps on a background graphic works the same for all formats. In the following, instructions on how to place gaps are provided for a simple text entry interaction. To create a new question, click on the "New question” button. Then select the "text entry interaction" question type and enter a title for your question.

STEP 2: Edit question and add content

All question content can be added via the HTML input field in the Text entry interaction section. Start by entering your question text, e. g. "Name the three independent cities of the state of Saxony".

Now add the background graphic on which the gaps should be placed later.

Then add any number of gaps directly below the graphic. Define the correct solution and the maximum score for each gap. You can also configure additional settings.

STEP 3: Place gaps on graphic I (HTML)

Placing the gaps on the background graphic is achieved by CSS positioning. The only prerequisite is the definition of CSS classes in the HTML source code. You can view and edit the HTML source code of your question using the "Source code” option of the HTML editor.

You can identify your graphic by the following HTML code:

The gaps are marked in the HTML as follows:

You need to set a container (<div>) with the class "gap-container" around the graphic and your gaps.

If you require CSS placement on the background graphic for several questions in the test, add [TITLEofQUESTION] to the class name. Insert an identifier for “TITLEofQUESTION” that is unique throughout the test.

Make sure that <div> encloses your graphic and all gaps. Do not forget the closing tag (</div>) following the last gap.

Now add another container around each individual gap. For all containers (<span>), the class "gap” should be assigned. Another class should be assigned to identify each gap individually. We recommend to number your gaps in order, starting with class "gap1” for the first gap, "gap2" for the second gap and so on.

Examples

STEP 4: Place gaps on graphic II (CSS)

To place your gaps on the background graphic, you now need to specify the exact position. This is done in a separate CSS file that can be uploaded to each question.

You can use the following CSS statements as a template for individual questions in the test:

If you place gaps for several questions in the test using CSS and have thus used the class name "gap-container [TITLEofQUESTION]" in the HTML of the question, then deploy this template:

Now insert your values for top and left in the statements related to the individual gaps (.gap1, .gap2, etc.) to determine their position. Add as many statements as there are gaps defined in your question. 

Save your file to a CSS file (.css) and add it to your question on the Options tab in the ONYX Editor.

Use the preview in the ONYX Editor to verify whether the question is properly displayed.

Examples

Step 5: Add the CSS file

Save your statement in a CSS file (.css). Now you can upload this file in the Options tab under Layout settings. Detailed instructions on this can be found here Set Options 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.