Общие свойства

В этом разделе описываются свойства компонента Таблица данных, общие для всех унаследованных компонентов.

Показать строку поиска

Если включено, позволяет осуществлять поиск по данным в компоненте.

Имя переменной:

enableSearch

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableSearch

Boolean

Показать строку поиска

Заполнитель в поиске

Сообщение, которое отображается в строке поиска, если не введен другой текст.

Имя переменной:

searchPlaceholder

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

searchPlaceholder

String

Заполнитель в поиске

Разрешить расширенный поиск

Включает расширенные параметры фильтрации для компонента.

Имя переменной:

enableAdvancedSearch

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableAdvancedSearch

Boolean

Разрешить расширенный поиск

Расширенный поиск по вычисляемым полям

Применяется только к классовым таблицам. Если эта опция включена, она позволяет использовать расширенные параметры фильтрации для фильтрации значений, генерируемых выражением именования формата таблицы, и других вычисляемых полей. Включение этого параметра может привести к снижению производительности, если системных ресурсов недостаточно для количества экземпляров классов и вычисляемых полей, подвергаемых фильтрации.

Имя переменной:

classInstanceAdvancedSearchCalculatedFields

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

classInstanceAdvancedSearchCalculatedFields

Boolean

Расширенный поиск по вычисляемым полям.

Только чтение

Если включено, запрещает любое редактирование пользователем в таблице данных.

Имя переменной:

readOnly

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

readOnly

Boolean

Только чтение

Генерировать события “Строка добавлена”

Включает генерацию событий “Строка добавлена”.

Имя переменной:

generateRowAddedEvents

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

generateRowAddedEvents

Boolean

Генерировать события “Строка добавлена”

Генерировать события “Строка удалена”

Включает генерацию событий “Строка удалена”.

Имя переменной:

generateRowRemovedEvents

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

generateRowRemovedEvents

Boolean

Генерировать события “Строка удалена”.

Генерировать события “Строка обновлена”

Включает генерацию событий “Строка обновлена”.

Имя переменной:

generateCellUpdatedEvents

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

generateCellUpdatedEvents

Boolean

Генерировать события “Строка обновлена”.

Множественная сортировка колонок

Если включено, разрешает использовать сортировку по более чем одному столбцу таблицы данных.

Имя переменной:

multipleSorting

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

multipleSorting

Boolean

Сортировка нескольких столбцов.

Показать панель инструментов

Этот флаг определяет отображение панели инструментов таблицы данных.

Имя переменной:

showToolbar

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

showToolbar

Boolean

Показать панель инструментов.

Включить контекстное меню

Этот флаг определяет, будет ли отображаться контекстное меню при щелчке правой кнопкой мыши на ячейке таблицы данных.

Имя переменной:

enableContextMenu

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableContextMenu

Boolean

Включить контекстное меню

Показать кнопку импорта

Если включено, кнопка импорта будет отображаться пользователю.

Имя переменной:

showImportButton

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

showImportButton

Boolean

Показать кнопку импорта.

Показать кнопку экспорта

Если включено, кнопка экспорта будет отображаться пользователю.

Имя переменной:

showExportButton

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

showExportButton

Boolean

Показать кнопку экспорта.

Число элементов на странице

Определяет количество строк таблицы данных по умолчанию для отображения на одной странице.

Имя переменной:

rowsPerPage

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

rowsPerPage

Integer

Элементы на странице.

Пользовательские значения выбора 'Строка на странице'

Это свойство позволяет указать пользовательские значения для списка, выбирающего количество записей на каждой странице.

Имя переменной:

customPaginatorValues

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

value

Integer

Значение. Количество элементов на странице.

Показать селектор «Число элементов на странице»

Этот флаг указывает, будет ли отображаться селектор 'Элементы на странице'.

Имя переменной:

showRowsPerPageSelector

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

showRowsPerPageSelector

Boolean

Показать селектор «Число элементов на странице».

Тип селектора 'Элементы на странице'

Определяет тип селектора 'Items per Page'. Это свойство имеет два значения выбора.

  • Поле со списком - селектор будет отображаться в виде выпадающего списка со значениями выбора.

  • Группа кнопок - селектор будет отображаться в виде набора кнопок.

Имя переменной:

rowsPerPageSelectorType

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

rowsPerPageSelectorType

String

Тип селектора 'Элементы на странице'

Цвет четной выбранной строки

Цвет, указанный этой переменной, будет применен к четным строкам таблицы данных при их выборе.

Имя переменной:

evenSelectedRowColor

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

evenSelectedRowColor

Color

Цвет четной выбранной строки

Цвет нечетной выбранной строки

Цвет, указанный этой переменной, будет применен к нечетным строкам таблицы данных при их выборе.

Имя переменной:

oddSelectedRowColor

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

oddSelectedRowColor

Color

Цвет нечетной выбранной строки

Пользовательские значения селектора «Число элементов на странице»

Это свойство позволяет указать пользовательские значения для списка, выбирающего количество записей на каждой странице.

Имя переменной:

pageSizeOptions

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

value

Integer

Значение. Количество элементов на странице.

Показать селектор «Число элементов на странице»

Этот флаг определяет, будет ли отображаться селектор "Число элементов на странице".

Имя переменной:

showPageSizeSelector

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

showPageSizeSelector

Boolean

Показать селектор «Число элементов на странице».

Тип селектора «Число элементов на странице»

Определяет тип селектора "Строк на странице". Данное свойство имеет два возможных значения:

  • Поле со списком - селектор будет отображаться в виде поля с выпадающим списком возможных значений.

  • Группа кнопок - селектор будет отображаться в виде набора кнопок.

Имя переменной:

pageSizeSelectorType

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

pageSizeSelectorType

String

Тип селектора «Число элементов на странице».

Фиксированный формат

Если включено, компонент отобразит пустую таблицу данных в формате, указанном в свойстве Формат, а любые данные в свойстве Таблица данных будут игнорироваться.

Имя переменной:

fixedFormat

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

fixedFormat

Boolean

Фиксированный формат

Формат

Пользовательский формат таблицы. Полное и подробное описание формата таблицы данных см. в соответствующем разделе.

Имя переменной:

format

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

format

Data Table

Формат

Имя столбца идентификатора записи

Должно быть строкой, точно совпадающей с одним из имен столбцов таблицы. Если задано, указанный столбец будет рассматриваться как столбец, содержащий уникальный ключ для каждой строки таблицы. Каждое значение в указанном столбце должно быть уникальным для каждой строки таблицы данных.

Имя переменной:

idColumn

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

idColumn

String

Имя столбца идентификатора записи.

Выражение выбора строк

Выражение, указывающее, какие строки таблицы данных отображать как выбранные. Выражение оценивается для каждой строки таблицы данных, если результат оценки равен True, строка отображается как выбранная, в противном случае строка будет отображаться как невыбранная. Выражение оценивается при каждом изменении таблицы данных.

Имя переменной:

selectedRowsExpression

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

selectedRowsExpression

String

Должно возвращать булево значение. Выполняется для каждой строки таблицы данных. Выражение выполняется при каждом изменении таблицы.

  • Если результат True, строка будет отображаться как выделенная.

  • Иначе, выбранная строка будет отображаться как невыделенная.

Среда вычисления выражения выбора строк:

Таблица данных по умолчанию

Таблица данных компонента.

Контекст по умолчанию

Нет.

Ряд по умолчанию

Текущая обрабатываемая строка таблицы данных по умолчанию.

Переменные окружения

Только Стандартные переменные.

Настройки столбцов

Данное свойство включает различные настройки визуального представления и поведения столбцов таблицы.

Имя переменной:

columnsSettings

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

name

String

Имя. Имя столбца.

fixed

String

Фиксированная Колонка. Если не указан параметр Не установлено, позволяет зафиксировать столбец на левой или правой стороне таблицы, фактически изменяя положение столбца. Фиксированная колонка игнорирует горизонтальную прокрутку.

headerTextBehavior

String

Поведение текста заголовка. Управляет тем, как отображается заголовок столбца, если текст заголовка не вписывается в ширину столбца по умолчанию:

  • Развернуть колонку позволяет расширить ширину столбца настолько, чтобы вместить текст заголовка в одну строку.

  • Обрезать текст обрезает текст заголовка.

  • Перенос слов сохраняет ширину столбца, увеличивая высоту столбца и отображая текст заголовка на нескольких строках. Столбцы без текста и содержимого будут отображаться с минимальной шириной столбца 75 пикселей.

wordBreak

String

Перенос строк. Определяет поведение переноса строки для обычных ячеек столбца:

  • Разделить все позволяет разрывать текст на любом символе.

  • Разделить слово позволяет делать разрыв строки в конце любого слова.

  • Не разделять полностью запрещает разрыв текста на несколько строк.

visibleLength

Integer

Видимая длина. Определяет максимальное количество символов строки для отображения. Полное значение будет отображаться во всплывающей подсказке при наведении мыши.

textAlignHorizontal

String

Горизонтальное выравнивание текста ячейки. Определяет горизонтальное положение текста в ячейке столбца.

textAlignHeaderHorizontal

String

Горизонтальное выравнивание текста заголовка. Определяет горизонтальное положение текста в заголовке столбца.

textAlignVertical

String

Вертикальное выравнивание текста ячейки. Определяет вертикальное положение текста в ячейке столбца.

textAlignHeaderVertical

String

Вертикальное выравнивание текста заголовка. Определяет вертикальное положение текста в заголовке колонки.

sorter

Boolean

Сортировщие. Активирует сортировку по столбцу.

sorterPreset

String

Предустановка сортировки

Доступные значения:

  • По возрастанию (ASC).

  • По убыванию (DESC).

  • Не установлено (unset).

filtering

String

Поиск. Активирует поиск по данным столбца.

filterTable

Data Table

Фильтр таблицы. Позволяет создавать фильтры для определенного столбца. Вложенная таблица данных с тремя полями:

  • Значение - значение ячейки для фильтрации. Обратите внимание, что если столбец имеет тип полей Boolean, разрешены только значения true или false.

  • Описание - описание фильтра.

  • Выбран (Boolean).

width

Integer

Ширина. Ширина столбца, в пикселях.

visibility

Boolean

Видимый. Укажите, должен ли столбец отображаться для пользователя.

index

Integer

Индекс. Укажите начальный порядок столбцов: 0 - самый левый столбец.

loading

String

Загрузка. Выберите, как будет загружен столбец:

  • Eager - значение по умолчанию. Данные столбца загружаются немедленно с начальной визуализацией таблицы.

  • Lazy - данные столбца загружаются после начальной визуализации таблицы, что потенциально повышает скорость загрузки таблицы. Для использования этой опции необходимо определить ширину столбца.

Максимальная высота без вертикальной прокрутки

Максимальная высота в пикселях, после которой включается вертикальный скролл в ячейке журнала событий.

Имя переменной:

heightScrollEnabled

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

heightScrollEnabled

Integer

Максимальная высота без вертикальной прокрутки.

Включить выбор нескольких строк

Если включено, позволяет выбирать строки с помощью флажков.

Имя переменной:

checkRows

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

checkRows

Boolean

Включить выбор нескольких строк.

Колонка с режимом только для чтения строки

Имя столбца типа Boolean, ложные значения в котором сделают строки таблицы доступными только для чтения.

Имя переменной:

columnToDefineRowLock

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

columnToDefineRowLock

String

Колонка с режимом только для чтения строки

Колонка с включенным дополнительным меню

Имя столбца типа Boolean в таблице. Меню будет активно только в тех строках, где значение этого столбца равно True.

Имя переменной:

columnToDefineKebabLock

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

columnToDefineKebabLock

String

Колонка с включенным дополнительным меню.

Разрешить изменение размера столбца

Если включено, позволяет менять размер столбца.

Имя переменной:

resizableColumn

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

resizableColumn

Boolean

Разрешить изменение размера столбца.

Подтверждение удаления строк

Если включено, действие панели инструментов Удалить ряд потребует подтверждения.

Имя переменной:

confirmActionDelete

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

confirmActionDelete

Boolean

Подтверждение добавления строк

Если включено, действие панели инструментов Добавить ряд потребует подтверждения.

Имя переменной:

confirmActionAdd

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

confirmActionAdd

Boolean

Иконка фильтрации

Изображение для иконки фильтрации.

Имя переменной:

filterIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

filterIcon

Data Block

Иконка фильтрации

Иконка поиска

Изображение для иконки поиска.

Имя переменной:

searchIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

searchIcon

Data Block

Иконка поиска

Включить управление видимостью колонок

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

Имя переменной:

enableColumnVisibility

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableColumnVisibility

Boolean

Включает/выключает меню управления видимостью столбцов.

Настроить ширину столбца вручную

Когда включено, таблица будет использовать ширину, определенную в свойстве Настройки столбцов для каждого столбца. Это может значительно повысить производительность, особенно для больших таблиц, за счет сокращения времени, необходимого для автоматического расчета и настройки ширины столбцов.

При включении этого свойства необходимо задать ширину для каждого столбца в таблице в свойстве Настройки столбцов.

Имя переменной:

manualConfigureColumnWidth

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

manualConfigureColumnWidth

Boolean

Позволяет вручную настраивать ширину столбцов, используя значения ширины, указанные в таблице Настройки столбцов.

Настройки вложенных записей

Свойства позволяют отображать данные из свойства таблица данных в виде вложенных строк, аналогично компоненту Настраиваемое дерево. Для корректного отображения вложенных данных данные таблицы должны содержать столбец идентификатора с уникальным идентификатором для каждой записи и столбец родителя идентификатора, указывающий идентификатор родительской записи. Для записей верхнего уровня в столбце идентификатора родительской записи указывается NULL.

Имя переменной:

treeRecordSettings

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

idColumnName

String

Идентификатор записи Имя столбца

parentIdColumnName

String

Идентификатор родительской записи Имя столбца

indentSize

Integer

Размер отступа

visibleChildren

Integer

Видимые дети

Глубина раскрытия записей

Позволяет автоматически разворачивать вложенные записи на указанную глубину. При установке значения Record Expansion Depth в 1 автоматически открываются все дочерние узлы записей верхнего уровня, при установке значения 2 - все дочерние узлы дочерних записей и так далее.

Имя переменной:

expansionDepth

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

expansionDepth

Integer

Record Expansion Depth

Изображение переключателя(открыт)

Применяется, если в настройках "Вложенные записи" настроено отображение данных вложенных строк. Указанное изображение заменяет стандартное изображение открытого переключателя.

Имя переменной:

openedSwitcherImage

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

imageType

Integer

Тип

  • 0 чтобы указать данные

  • 1 чтобы указать URL

imageData

Data Block

Данные изображения

imageUrl

String

Ссылка на изображение

Изображение переключателя(закрыт)

Применяется, если в настройках "Вложенные записи" настроено отображение данных вложенных строк. Указанное изображение заменяет стандартное изображение закрытого переключателя.

Имя переменной:

closedSwitcherImage

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

imageType

Integer

Тип

  • 0 чтобы указать данные

  • 1 чтобы указать URL

imageData

Data Block

Данные изображения

imageUrl

String

Ссылка на изображение

Включить

Если включено, добавляет к таблице дополнительный столбец с настраиваемыми кнопками.

Имя переменной:

additionalActionEnable

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionEnable

Boolean


Показать в ряд

Имя переменной:

additionalActionShowInRow

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionShowInRow

Boolean


Иконка

Имя переменной:

additionalActionIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionIcon

Data Block

Этот флаг показывает, будет ли компонент "слушать" события Нажатие мыши.

Ширина дополнительной иконки

Имя переменной:

additionalActionWidth

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionWidth

Integer

Ширина в пикселях, которая будет добавлена к контейнеру иконки.

Настройки

Данное свойство позволяет задать настройки элемента Дополнительное действие.

Имя переменной:

additionalActionSettings

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

uid

String

Уникальный ID кнопки дополнительного действия.

desc

String

Описание кнопки.

icon

Data Block

Изображение для кнопки в обычном состоянии.

iconHover

Data Block

Изображение для кнопки в состоянии Наведение курсора мыши.

iconActive

Data Block

Изображение для кнопки в состоянии Активна.

buttonAction

String

Определяет, какое действие будет выполняться для соответствующего ряда путем нажатия на кнопку. Свойство имеет несколько допустимых значений:

  • Edit

  • Delete

  • Cancel

  • Apply

confirm

Boolean

Если включено, действие по кнопке потребует подтверждения.

confirmTitle

String

Текст сообщения подтверждения.

Стиль

Имя переменной:

additionalActionStyle

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

additionalActionStyle

String

Стиль CSS, который будет применен к элементу Дополнительное действие.

Was this page helpful?