Differences

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

--- scaledmatrix [2022/09/28 20:37] – admin
+++ scaledmatrix [2024/04/30 07:45] (current) – [Matrix Question] admin
@@ Line 4: / Line 4: @@
 Functionality includes:
   * Option for formatting single row matrix questions
-  * Option for formatting for last column 'NA', 'Not sure' etc. including width and format of divider
+  * Option for formatting one or more 'NA', 'Not sure' etc. columns including width and format of divider
   * Options for repeating headers in middle or on bottom
   * Supports scale images
   * Supports middle labels, not just end labels (unlike NPS question)
+  * Supports choice groups
   * Optionally control width of scale labels
   * Optionally add and format scale dividers
@@ Line 21: / Line 22: @@
 {{ :formatscaledmatrix_mobile.png?300 |}}
-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 =====
 ==== Survey Header ====
-To make the function available to all questions in the survey, copy the function to the Survey Header inside a script tag:
 Add the scaledMatrix 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 scaledMatrix function JS:
 <code>
@@ Line 43: / Line 43: @@
 </code>
-To override the default **[[scalematrix#options|options]**, specify the desired options in the second function argument as an object. For example:
+To override the default **[[scaledmatrix#options|options]]**, specify the desired options in the second function argument as an object. For example:
 <code>
 Qualtrics.SurveyEngine.addOnload(function() {
-	scaledMatrix(this,{lastNA:true,scaleLabels:["Extremely<br>dissatisfied","Extremely<br>satisfied"]});
+	scaledMatrix(this,{NAcols:1,scaleLabels:["Extremely dissatisfied","Extremely satisfied"]});
 });
 </code>
@@ Line 55: / Line 55: @@
 Default: false
 ==== labelsBottomMin ====
-**labelsBottomMin** specifies the minimum number of rows before bottom scale labels will be displayed when [[formatscaledmatrix#labelsBottom|labelsBottom]] is true.
+**labelsBottomMin** specifies the minimum number of rows before bottom scale labels will be displayed when **[[scaledmatrix#labelsBottom|labelsBottom]]** is true.
 Default: 3
@@ Line 66: / Line 66: @@
 Default: false
-==== lastNA ====
+==== NAcols ====
-**lastNA** specifies the last column as 'NA', 'Not sure' etc. when set to true. Turning on automatically adjusts the position of the right scale anchor.
+**NAcols** specifies the number of 'NA', 'Not sure', etc. columns on the right side of the scale. When greater than 0 (zero), the position of the right scale anchor is adjusted.
-Default: false
+Default: 0
 ==== NAdividerStyle ====
-**NAdividerStyle** specifies the CSS style of the NA divider that separate the NA answer from the other answers when **[[scaledmatrix#lastNA|lastNA]]** is true.
+**NAdividerStyle** specifies the CSS style of the NA divider that separate the NA columns from the other answers when **[[scaledmatrix#lastNA|NAcols]]** is greater than 0 (zero).
-Default: : "1px solid #666666"
+Default: : %%"1px solid #666666"%%
 ==== NAwidth ====
-**NAwidth** is used to override the default width of NA column to make it a different width that the other columns when **[[scaledmatrix#lastNA|lastNA]]** is true. Specified as a percentage. Set to 0 (zero) to use default width.
+**NAwidth** is used to override the default width of NA columns to make them a different width that the other columns when **[[scaledmatrix#lastNA|NAcols]]** is greater than 0 (zero). Specified as a percentage. Set to 0 (zero) to use default width.
 Default: 0
@@ Line 89: / Line 89: @@
 **scaleDividerStyle** specifies the CSS style of the scale dividers when **[[scaledmatrix#scaleDividers|scaleDividers]]** is specified.
-Default: "1px solid #666666"
+Default: %%"1px solid #666666"%%
 ==== scaleImage ====
 **scaleImage** specifies the url of the image that will be displayed above the scale.
-Default: "" (none)
+Default: %%""%% (none)
 ==== scaleLabels ====
 **scaleLabels** is an array that specifies the scale labels.
-Default: ["Extremely<br>Unlikely","Extremely<br>Likely"]
+Default: %%["Extremely<br>Unlikely","Extremely<br>Likely"]%%
 ==== scaleLabelWidth ====
 **scaleLabelsWidths** is an array that specifies the width of the scale labels. For example: ["30%","40%","30%"]. If provided it must match the number of **[[scaledmatrix#scaleLabels|scaleLabels]]**.  Setting to [] (blank) auto-calculates the widths.