Compound Grids

Overview

A Compound Grid allows multiple questions within a loop or iteration to be displayed together in a single grid.

Instead of presenting each question one at a time, all questions in the iteration can be shown simultaneously, providing a more compact and efficient data entry experience.

Steps to Create:

1. Create a chapter that will hold different question types (Single Choice, Multiple Selection, Open Ended etc.)

2. Set the chapter to run in a loop. 

• 

3. On the Loops tab we’ve added the new “Render as grid”:
 

This will render the loop as a grid with:

• each question as a column
• each loop iteration as a row
   
   

Compound Grid Callback Function - OnRenderGridInit()

In order to pipe the function, use 'OnRenderGridInit() as follows:

function OnRenderGridInit(inChapterIndex, ioParams){
 if(inChapterIndex==3) //Verifies that the chapter is chapter index 3 in the script
 {
 for(var i=1; i<=6; i++)
 {
  var IterationText = AnswerChoice(QRef(101),i);
  ioParams.Rows[i].Name = IterationText;
  }
 }
}

You can also use this function to set the alignment and other params for the Grid

function OnRenderGridInit(inChapterIndex, ioParams){
if (inChapterIndex == 3){ 
ioParams.CellAlignment = eRenderGridAlignment.Center;
ioParams.ColumnHeaderAlignment = eRenderGridAlignment.Top;
ioParams.RowHeaderAlignment = eRenderGridAlignment.Bottom;

ioParams.Columns[0].WidthPercentage = 10;
ioParams.Columns[1].WidthPercentage = 70;
ioParams.Columns[2].WidthPercentage = 20;
}
}

ioParams Available

• Columns Parameters
  • WidthPercentage - will set the column width
  • ColumnHeaderAlignment - Will set the Column Alignment
    Values: Top/Bottom/Center

• Rows Parameters
  • RowHeaderAlignment - Will set the Row Alignment
    Values: Top/Bottom/Center

• Cell Parameters
  • CellAlignment - Will set the Cell Alignment
    Values: Top/Bottom/Center

 

IMPORTANT NOTE: 

Unlike text piping to "regular" questions (inside a piping grid), the piping code should be placed in the loop chapter's start script .

Example:

If you have question index 10 inside loop chapter index 5 (that is a compound grid) , and you want to pipe "MyText" to that Q10, add this code in the chapter's start script: 

SetTextFormat(QRef(10), "MyText");

See the attached example survey to find a demonstration of this.