====== 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 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
  * configure the column widths using CSS
  * optionally match the height of the reference material to the height of the questions

Here is an example:
{{ ::sideqs.png?800 |sideQs Example}}

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 =====
==== Survey Header ====
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>
<script>/*Paste sideQs function JS here*/</script>
</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.
==== Custom CSS ====
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>
Qualtrics.SurveyEngine.addOnload(function() {
	sideQs(this);
});
</code>

To override the default options, specify the desired **[[sideQs#options|options]]** is the second function argument as an object. For example:
<code>
Qualtrics.SurveyEngine.addOnload(function() {
	sideQs(this,{side:"right",matchHeight:false});
});
</code>
===== Options =====
==== matchHeight ====
**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
==== numQs ====
**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
==== side ====
**side** is text that specifies the side, left or right, to move the first **[[sideQs#numQs|numQs]]** to.

default: %%"left"%%
====== Qualtrics Wiki ======
[[start|Qualtrics Wiki]]