User Tools

Site Tools


sideqs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
sideqs [2022/11/25 16:37] – created adminsideqs [2025/04/07 10:49] (current) admin
Line 1: Line 1:
-====== sideQs - Move one or more question to the left or right of the other questions ====== +====== sideQs - Move one or more questions to the left or right of the other questions ====== 
-The **sideQs** function moves one or more questions to the left or right of other questions. It's primary use is displaying reference material such as a reading passage, a concept, or directions to the left or right of the questions. It moves the first n questions on the page to the left or right. Features include: +The **sideQs** function moves one or more questions to the left or right of other questions. It's primary use is displaying reference material such as a reading passage, a concept, or directions to the left or right of the related questions. It moves the first //n// questions on the page to the left or right. Features include: 
- specify the number of questions to be placed to the side +  * Specify the number of questions to be placed to the side 
- configure the column widths using CSS +  * Configure the column widths using CSS 
- optionally match the height of the reference material to the height of the questions+  * Optionally match the height of the reference material to the height of the questions 
 +  * Supports 'New Survey Experience' (aka Simple layout)
  
 Here is an example: Here is an example:
-{{ ::sideqs.png?650 |sideQs Example}}+{{ ::sideqs.png?800 |sideQs Example}}
  
-This function is available for a reasonable fee. Contact **[[https://community.qualtrics.com/XMcommunity/messages/add/TomG|TomG]]** on the Qualtrics Community to learn more.+This function is available for a reasonable fee. Contact **[[https://community.qualtrics.com/inbox/conversation?with=373|TomG]]** on the Qualtrics Community to learn more.
 ===== Set-up Instructions ===== ===== Set-up Instructions =====
 ==== Survey Header ==== ==== Survey Header ====
-To make the function available to all pages in the survey, copy the function to the Survey Header inside a script tag: 
 Add the sideQs function to the survey header to make it available to any question in the survey.   Go to Look & Feel -> General -> Header edit -> {{::icon_source.jpg?20|}} and paste the provided carryForwardNA function JS: Add the sideQs function to the survey header to make it available to any question in the survey.   Go to Look & Feel -> General -> Header edit -> {{::icon_source.jpg?20|}} and paste the provided carryForwardNA function JS:
 <code> <code>
Line 17: Line 17:
 </code> </code>
 Alternatively, paste the sideQs function JS into a question's JS outside the existing Qualtrics functions to make it available to questions on the page. Alternatively, paste the sideQs function JS into a question's JS outside the existing Qualtrics functions to make it available to questions on the page.
-=== Question JavaScript === +==== Custom CSS ==== 
-Add JS to call the sideQ function to the first qeustion on the page.+Add the following CSS to set the columns widths. Go to Look & Feel -> Style -> Custom CSS and paste the code below. Adjust percentages as needed. 
 +<code> 
 +.sideQs .left { max-width:50%;
 +.sideQs .right { max-width:50%;
 +</code> 
 +==== Question JavaScript ==== 
 +Add JS to call the sideQ function from the first question on the page.
 <code> <code>
 Qualtrics.SurveyEngine.addOnload(function() { Qualtrics.SurveyEngine.addOnload(function() {
Line 33: Line 39:
 ===== Options ===== ===== Options =====
 ==== matchHeight ==== ==== matchHeight ====
-**matchHeight** is a boolean that specifies if the height of the numQs questions should be set to match the height of the remaining questions. When **matchHeight** is true the content will scroll vertically if necessary. +**matchHeight** is a boolean that specifies if the height of the **[[sideQs#numQs|numQs]]** questions should be set to match the height of the remaining questions. When **matchHeight** is true the content will scroll vertically if necessary. 
  
 default:true default:true
 ==== numQs ==== ==== numQs ====
-**numQs** is a number that specifies the number of questions, starting at the top of the page, to move to the left or right.+**numQs** is a number that specifies the number of questions, starting at the top of the page, to move to the **[[sideQs#side|side]]**.
  
 default: 1 default: 1
 ==== side ==== ==== side ====
-**side** is text that specifies the side, left or right, to move the first **[[sideQs#numQs\numQs]]** to.+**side** is text that specifies the side, left or right, to move the first **[[sideQs#numQs|numQs]]** to.
  
-default: "left"+default: %%"left"%%
 ====== Qualtrics Wiki ====== ====== Qualtrics Wiki ======
 [[start|Qualtrics Wiki]] [[start|Qualtrics Wiki]]
sideqs.1669412253.txt.gz · Last modified: by admin

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki