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

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

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

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

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

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

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

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

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

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

enableColumnVisibility

Записи:

1

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

Имя поля

Тип поля

Примечания

enableColumnVisibility

Boolean

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

Показать кнопку Горизонтальная подгонка

Управляет отображением кнопки Горизонтальная подгонка для пользователя.

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

showHorizontalFitButton

Записи:

1

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

Имя поля

Тип поля

Примечания

showHorizontalFitButton

Boolean

Показать кнопку «Горизонтальная подгонка»

Горизонтальная подгонка

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

  • Auto — автоматически определяет, должны ли столбцы быть размещены в доступном контейнере на основе «рекомендательных» ширин столбцов и ширины доступного контейнера. Значения рекомендуемой ширины зависят от типа данных столбца и жестко задаются для каждого типа данных.

  • Enabled — размещает все столбцы в доступной ширине контейнера, чтобы избежать горизонтальной полосы прокрутки.

  • Disabled — ширина каждого столбца зависит от его содержимого. Может появиться горизонтальная полоса прокрутки.

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

horizontalFit

Записи:

1

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

Имя поля

Тип поля

Примечания

horizontalFit

String

Горизонтальная подгонка

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

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

Значение параметра Авто автоматически рассчитает значение «Элементов на странице» на основе доступной высоты области просмотра таблицы, используя следующую формулу: <доступная высота области просмотра таблицы> / 40, где 40 пикселей — высота строки по умолчанию.

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

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

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

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

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

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

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

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

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

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

Имя поля

Тип поля

Примечания

imageType

Integer

Выберите, использовать ли данные из поля imageData или imageURL.

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

  • 1 — URL

imageData

Data Block

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

imageUrl

String

URL изображения.

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

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

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

searchIcon

Записи:

1

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

Имя поля

Тип поля

Примечания

imageType

Integer

Выберите, использовать ли данные из поля imageData или imageURL.

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

  • 1 — URL

imageData

Data Block

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

imageUrl

String

URL изображения.

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

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

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

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

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

Идентификаторы развернутых записей

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

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

expandedRecordsId

Записи:

1

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

Имя поля

Тип поля

Примечания

expandedRecordId

String

ID записи

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

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

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

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

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

Имя поля

Тип поля

Примечания

imageType

Integer

Выберите, какие данные использовать: из поля imageData или из поля imageURL.

  • 0 - Image Data

  • 1 - URL

imageData

Data Block

Image data.

imageUrl

String

Image URL.

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

Ширина иконки кебаб-меню (или элементов, если включена опция Показать в ряд) в пикселях.

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

additionalActionWidth

Записи:

1

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

Имя поля

Тип поля

Примечания

additionalActionWidth

Integer

Ширина иконки кебаб-меню

Элементы кебаб-меню

Данное свойство позволяет указать элементы кебаб-меню.

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

additionalActionSettings

Записи:

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

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

Имя поля

Тип поля

Примечания

uid

String

UID. Уникальный ID элемента.

desc

String

Описание. Описание элемента.

icon

Data Block

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

iconHover

Data Block

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

iconActive

Data Block

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

buttonAction

String

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

  • Edit. Начинает редактирование текущей строки, доступной только для чтения.

  • Delete. Удаляет текущую строку.

  • Cancel. Отменяет редактирование текущей строки и отменяет изменения.

  • Apply. Останавливает редактирование текущей строки и применяет изменения.

confirm

Boolean

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

confirmTitle

String

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

Стиль

CSS-стили, применяемые к элементам кебаб-меню.

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

additionalActionStyle

Записи:

1

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

Имя поля

Тип поля

Примечания

additionalActionStyle

String

Стиль кебаб-меню

Was this page helpful?