Перейти к основному содержимому

Свойства и функции колонки табличного вопроса

Получить доступ к колонкам табличного вопроса можно через объект columns, например Q.columns[5]. Колонка содержит код, текст и флаги, но также предоставляет набор различных свойств и функций.

code​

Код колонки (варианта ответа внутри строки), заданный при создании в редакторе анкеты. Например:

if (Q.columns[5].code != 5) {
    // странно…
}

text​

Текст колонки (варианта ответа в строке), заданный при создании в редакторе анкеты. Также позволяет изменить этот текст. Примеры:

variables['Ответ 5'] = Q.columns[5].text;
Q.columns[5].text = Q2.getChecked()[0].openValueTxt;

textLocalizations​

Текст колонки на указанном языке. Язык задаётся с помощью объекта Language.

variables['Ответ 5'] = Q.columns[5].textLocalizations[Language.ru];
Q.columns[5].textLocalizations[Language.ru] = Q2.getChecked()[0].openValueTxt;

plainText​

Текст колонки (варианта ответа в строке), очищенный от html-разметки. Только для чтения.

Q.columns[5].text = '<b>Жирный текст</b>';
Q.columns[5].text = Q.columns[5].plainText;

settings​

Опции колонки табличного вопроса, изменяющие различные её свойства. Подробнее в описании свойства settings у варианта ответа. Например:

// Добавить колонке 5 числовое поле 
Q.columns[5].settings.openValueNum = true;
// Разрешить его не заполнять
Q.columns[5].settings.allowEmptyOpenValue = true;

// Если у колонки 98 есть текстовое поле…
if (Q.columns[98].settings.openValueTxt) {
    // … что-то сделать
}

visible​

Возвращает true, если колонка отображается. Также может использоваться для принудительного скрытия или показа колонок (вариантов ответа) в табличном вопросе. Например:

Q.columns[1].visible = false;

width​

Позволяет задать необходимую ширину колонки. Значение можно указать в процентах (например 40%), либо в пикселях (например 300px). Также можно указать значение auto, тогда ширина колонки будет автоматически рассчитана браузером. Примеры:

Q.columns[1].width = '20%';
Q.columns[2].width = 'auto';
Q.columns[3].width = '150px';

exportCodeOverride​

Переопределение кода колонки (варианта ответа), используемого при выгрузке итогового массива. Подробнее тут.

outputColumnTemplate​

Шаблон имени переменной для колонки (варианта ответа), при выгрузке массива. Подробнее тут.

outputColumnTemplateOVN​

Шаблон имени переменной для числового открытого значения для колонки (варианта ответа). Подробнее тут.

outputColumnTemplateOVT​

Шаблон имени переменной для текстового открытого значения для колонки (варианта ответа). Подробнее тут.

show()​

Делает колонку видимой. Равносильно присваиванию true свойству visible. Например:

Q.columns[5].show();

hide()​

Скрывает колонку. Равносильно присваиванию false свойству visible. Например:

Q.columns[5].hide();

image​

Содержит изображение колонки (варианта ответа), а также позволяет добавить колонке изображение из объекта images. Примеры:

Q.columns[5].image = images['Логотип'];
Q.columns[5].image = Q34.columns[5].image;

imageUrl​

Содержит URL изображения, а также позволяет добавить колонке (варианту ответа) изображение с внешнего сервера по прямой ссылке. Приоритет этого свойства выше свойства image, то есть если они заданы оба, то выполнится только imageUrl. Пример:

if (!Q.columns[5].imageUrl.length) {
    Q.columns[5].imageUrl = 'https://www.surveystudio.ru/content/images/ss2_logo_74x74.png';
}

imagePlacement​

Содержит код расположения изображения относительно текста, а также позволяет задать расположение картинки. Более подробную информацию можно найти здесь. Примеры:

Q.columns[5].imageUrl = 'https://www.surveystudio.ru/content/images/ss2_logo_74x74.png';
Q.columns[5].imagePlacement = 4;
// или
Q.columns[5].imagePlacement = ImagePlacementIds.Right;

getCheckedOrderedCodes()​

Возвращает массив кодов вариантов ответа в порядке расстановки в указанной группе в вопросе Группировка с ранжированием:

Q.columns[5].getCheckedOrderedCodes();