Таблица
Базовое использование
Компонент Table можно использовать с минимальной конфигурацией для отображения набора данных. В своей основе он
требует свойство data-source для предоставления данных для рендеринга. По умолчанию он автоматически генерирует
столбцы на основе ключей объектов в источнике данных.
1 | John Doe | 30 |
2 | Jane Smith | 25 |
3 | Bob Johnson | 45 |
В этом примере компонент Table рендерит простую таблицу, используя массив tableData. Свойство data-source
принимает массив объектов, где каждый объект представляет строку, а его ключи (id, name, age) используются для
автоматического создания столбцов. Компонент отображает данные в базовом формате без необходимости дополнительной
конфигурации. Этот подход идеально подходит для быстрой визуализации данных без настройки.
Конфигурация столбцов
Свойство columns позволяет определять структуру и поведение каждого столбца в компоненте Table. Оно принимает массив
объектов IColumn, где каждый объект настраивает отдельный столбец.
Поле данных
Свойство dataField указывает ключ в объекте data-source, который соответствует данным этого столбца. Если оно не
указано, столбец может не отображать данные, если они не выведены из ключей источника данных.
Name | Color | WeightGrams |
|---|---|---|
Ананас | Оранжевый | 1617 |
Арбуз | Оранжевый | 1599 |
Апельсин | Желтый | 1573 |
Банан | Оранжевый | 1570 |
Манго | Красный | 641 |
Имя
Свойство name предоставляет внутренний идентификатор для столбца, полезный для ссылок в шаблонах или логике.
Тип
Свойство type определяет тип данных столбца. Это свойство задаёт структуру и поведение столбца, включая то, как он
обрабатывает фильтрацию и редактирование.
Строка или число
Когда свойство type установлено в "string" или "number", столбец настраивается для обработки текстовых или
числовых данных соответственно.
Имя | Звездный рейтинг | Доступные номера |
|---|---|---|
Небесная Линия | 4 | 164 |
Океанский Вид | 4 | 15 |
Океанский Вид | 2 | 84 |
Гранд Палас | 2 | 65 |
Небесная Линия | 5 | 147 |
Выбор
Когда свойство type установлено в "select", столбец настраивается для обработки выпадающих списков.
Имя | Страна | Звездный рейтинг |
|---|---|---|
Гранд Палас | Таиланд | 5 |
Гранд Палас | Германия | 5 |
Небесная Линия | Италия | 4 |
Городской Центр | Таиланд | 5 |
Океанский Вид | Италия | 2 |
Дата
Когда свойство type установлено в "date", столбец настраивается для обработки значений дат.
Имя | Создано | Обновлено | Дата начала | Дата окончания |
|---|---|---|---|---|
Встреча | 21.08.2026 | 16.02.2022 | 07.11.2023 | 05.09.2023 |
Встреча | 28.03.2024 | 04.12.2022 | 08.07.2023 | 20.01.2023 |
Семинар | 19.03.2026 | 05.05.2026 | 10.05.2023 | 21.05.2023 |
Вебинар | 08.06.2026 | 28.04.2023 | 25.02.2023 | 03.04.2023 |
Спортивное событие | 20.05.2023 | 03.07.2026 | 14.01.2023 | 29.12.2023 |
Заголовок
Свойство caption настраивает текст, отображаемый в заголовке столбца, для улучшения читаемости или локализации. Если
не указано, по умолчанию используется dataField с заглавной буквы.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Клубника | Красный | 514 |
Яблоко | Зеленый | 1418 |
Арбуз | Оранжевый | 1184 |
Персик | Оранжевый | 1873 |
Виноград | Розовый | 1329 |
Видимость
Свойство visible управляет отображением столбца, позволяя скрывать или показывать столбец без удаления его из
конфигурации.
Имя | Цвет |
|---|---|
Ананас | Красный |
Персик | Оранжевый |
Клубника | Оранжевый |
Ананас | Красный |
Манго | Желтый |
Фильтрация
Свойство isFilter включает фильтрацию для столбца, позволяя пользователям фильтровать данные в этом столбце.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Банан | Оранжевый | 970 |
Ананас | Фиолетовый | 1567 |
Апельсин | Зеленый | 408 |
Персик | Красный | 660 |
Банан | Зеленый | 1818 |
Сортировка
Свойство isSort включает сортировку для столбца, позволяя пользователям сортировать данные по этому столбцу.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Киви | Зеленый | 1908 |
Виноград | Красный | 1935 |
Виноград | Зеленый | 1826 |
Клубника | Зеленый | 838 |
Апельсин | Оранжевый | 923 |
Изменение размера
Свойство isResized позволяет вручную изменять размер столбца путём перетаскивания, давая пользователям возможность
интерактивно настраивать ширину столбца.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Яблоко | Зеленый | 489 |
Банан | Оранжевый | 1691 |
Арбуз | Розовый | 698 |
Киви | Розовый | 54 |
Банан | Красный | 1241 |
Ширина
Свойство width задаёт начальную ширину столбца в пикселях, определяя фиксированную ширину для согласованного макета.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Манго | Оранжевый | 8.36 |
Арбуз | Фиолетовый | 5.99 |
Яблоко | Зеленый | 0.13 |
Клубника | Желтый | 3.18 |
Киви | Розовый | 7.35 |
Минимальная ширина
Свойство minWidth задаёт минимальную ширину столбца в пикселях, гарантируя, что столбец не станет меньше определённого
размера, что полезно при изменении размера.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Яблоко | Зеленый | 9.49 |
Виноград | Желтый | 3.85 |
Банан | Фиолетовый | 8.34 |
Банан | Желтый | 4.47 |
Ананас | Розовый | 1.82 |
Максимальная ширина
Свойство maxWidth задаёт максимальную ширину столбца в пикселях, ограничивая, насколько широким может стать столбец
при изменении размера.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Персик | Фиолетовый | 8.84 |
Персик | Желтый | 1.38 |
Апельсин | Красный | 9.01 |
Арбуз | Зеленый | 6.89 |
Манго | Фиолетовый | 9.50 |
Фильтр по умолчанию
Свойство defaultFilter задаёт начальное значение фильтра для столбца, предварительно применяя фильтр при загрузке
таблицы.
Модель | Цвет | Цена (USD) |
|---|---|---|
Мустанг | Серебристый | 71828 |
А4 | Белый | 74841 |
Камри | Синий | 48448 |
EV6 | Белый | 23946 |
Королла | Красный | 69796 |
Сортировка по умолчанию
Свойство defaultSort задаёт начальный порядок сортировки для столбца, предварительно сортируя таблицу по этому столбцу
при загрузке.
Модель | Цвет | Цена (USD) |
|---|---|---|
EV6 | Серебристый | 60475 |
Х5 | Красный | 81640 |
Мустанг | Синий | 15390 |
Х5 | Синий | 18894 |
Х5 | Белый | 90436 |
Маска
Свойство mask применяет маску ввода к значениям столбца для отображения или редактирования, форматируя значения (
например, номера телефонов, цены) единообразно.
Модель | Пробег (км) | Цена (USD) |
|---|---|---|
Х5 | 162 698 | 81 571 |
Королла | 141 425 | 52 116 |
Королла | 39 576 | 93 107 |
EV6 | 16 997 | 37 173 |
Королла | 188 072 | 12 746 |
Шаблон ячейки
Свойство cellTemplate указывает имя слота для пользовательского рендеринга содержимого ячейки, позволяя использовать
пользовательский HTML или компоненты для отображения ячейки.
Имя | Страна | Рекомендуется | Звездный рейтинг |
|---|---|---|---|
Гранд Палас | США | yes | |
Небесная Линия | Германия | no | |
Океанский Вид | Япония | no | |
Городской Центр | Канада | no | |
Городской Центр | Германия | yes |
Установка значения ячейки
Свойство setCellValue позволяет определить функцию для настройки форматирования или вычисления значений ячеек,
переопределяя стандартное отображение значений для сложной логики.
Модель | Год | Пробег (км) | Цена (USD) |
|---|---|---|---|
Модель S | 2002 year | 182682 km | $ 34811 |
Модель S | 2016 year | 87457 km | $ 13680 |
Королла | 2012 year | 94741 km | $ 66106 |
А4 | 2008 year | 87626 km | $ 61023 |
Королла | 2008 year | 155269 km | $ 74522 |
Параметры фильтра
Свойство paramsFilter позволяет предоставить частичные опции для фильтрации в зависимости от типа данных, указанного в
свойстве type. В зависимости от type вы можете настроить поведение и внешний вид фильтра, используя соответствующие
свойства.
- Для типов
"string"или"number": Используйте опции, специфичные для полей ввода. - Для типа
"select": Используйте опции, специфичные для полей выбора. - Для типа
"date": Используйте опции, специфичные для полей дат.
Обратитесь к соответствующей документации для получения дополнительной информации:
Для опций фильтрации при использовании полей ввода (типы "string" или "number") изучите свойства поля ввода.
Для опций фильтрации при использовании полей выбора (тип "select") изучите свойства поля выбора.
Для опций фильтрации при использовании полей дат (тип "date") изучите свойства поля даты.
Класс
Свойство class позволяет применять пользовательские CSS-классы к различным частям столбца, включая заголовок, фильтр и
содержимое ячеек.
Изучите различные свойства, доступные для настройки CSS-классов столбцов таблицы, включая ячейки заголовков, поля фильтров и ячейки данных. Погрузитесь в каждое свойство, чтобы узнать, как эффективно стилизовать разные части столбца.
Работа с данными
Настройте функциональность таблицы, такую как toolbar, sorting, filtering, search и grouping, для эффективного
управления данными.
Панель инструментов таблицы
Свойство toolbar настраивает панель инструментов для таблицы. Её можно включить/выключить или настроить с помощью
объекта с конкретными опциями.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Клубника | Зеленый | 1320 |
Клубника | Желтый | 663 |
Киви | Фиолетовый | 1403 |
Яблоко | Фиолетовый | 1849 |
Ананас | Фиолетовый | 1946 |
visible: Определяет, отображается ли панель инструментов.search: Включает поле поиска на панели инструментов.
Установка toolbar в true включает панель инструментов с настройками по умолчанию. Предоставление объекта позволяет
выполнить детальную настройку.
Сортировка
Свойство sort включает и настраивает сортировку для таблицы. Вы можете активировать её с поведением по умолчанию или
настроить внешний вид и функциональность.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Манго | Красный | 1827 |
Апельсин | Желтый | 384 |
Арбуз | Желтый | 609 |
Яблоко | Желтый | 1691 |
Яблоко | Красный | 212 |
visible: Переключает видимость функции сортировки.icon: Указывает стиль иконки сортировки ("Bars"или"Arrow").
Установите sort в true для сортировки по умолчанию или предоставьте объект для большего контроля.
Фильтрация
Свойство filter включает фильтрацию строк в таблице. Её можно включить или настроить с расширенными опциями.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Персик | Красный | 746 |
Арбуз | Фиолетовый | 233 |
Банан | Зеленый | 750 |
Банан | Зеленый | 503 |
Яблоко | Фиолетовый | 869 |
visible: Переключает функцию фильтрации.noFilter: Сообщение, отображаемое, когда фильтры не применены.isClearAllFilter: Включает опцию "Очистить все фильтры".
Установка filter в true активирует базовую фильтрацию, а предоставление объекта позволяет использовать расширенные
конфигурации.
Поиск
Свойство search включает функцию глобального поиска по данным таблицы.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Ананас | Оранжевый | 83 |
Клубника | Фиолетовый | 656 |
Персик | Розовый | 105 |
Банан | Красный | 1478 |
Апельсин | Оранжевый | 972 |
Установите search в true, чтобы позволить пользователям выполнять поиск по всему содержимому таблицы.
Группировка
Свойство grouping включает группировку данных в таблице. Вы можете указать поле группировки или предоставить объект
конфигурации.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Зеленый | ||
Ананас | Зеленый | 1633 |
Клубника | Зеленый | 1663 |
Арбуз | Зеленый | 920 |
Розовый | ||
Апельсин | Розовый | 1004 |
Оранжевый | ||
Киви | Оранжевый | 1627 |
visible: Переключает функцию группировки.groupField: Указывает поле, используемое для группировки.
Установка grouping в имя поля (например, "category") группирует строки по этому полю. Использование объекта
предоставляет дополнительные возможности настройки.
Количество видимых строк
Свойство countVisibleRows определяет количество строк, видимых в таблице. Это полезно для ограничения числа
отображаемых строк одновременно.
Арбуз | Оранжевый | 975 | true | Китай | 9.55 |
Арбуз | Зеленый | 1079 | true | США | 8.44 |
Киви | Оранжевый | 889 | true | США | 7.66 |
Персик | Розовый | 202 | false | Индия | 7.71 |
Киви | Розовый | 1641 | true | США | 9.73 |
Установите countVisibleRows в желаемое число, чтобы контролировать, сколько строк видно одновременно.
Изменение размера столбцов
Свойство resizedColumns включает или отключает изменение размера столбцов в таблице. Когда оно включено, пользователи
могут регулировать ширину столбцов путём перетаскивания.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Виноград | Желтый | 242 |
Виноград | Фиолетовый | 1905 |
Клубника | Желтый | 1921 |
Персик | Зеленый | 1021 |
Клубника | Зеленый | 1044 |
Установите resizedColumns в true, чтобы разрешить изменение размера столбцов.
Количество данных при загрузке
Свойство countDataOnLoading определяет порог, при котором активируется индикатор загрузки данных. Это особенно полезно
для улучшения пользовательского опыта во время операций, таких как поиск или фильтрация, при работе с большими наборами
данных.
Предопределённые значения включают 100, 1000 и 10000.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Персик | Желтый | 712 |
Банан | Оранжевый | 444 |
Апельсин | Розовый | 135 |
Банан | Желтый | 1986 |
Персик | Оранжевый | 868 |
Установите countDataOnLoading, чтобы определить количество строк, при котором должен появляться индикатор загрузки.
Например, во время поиска или фильтрации, если набор данных превышает этот порог, будет показан индикатор загрузки для
улучшения пользовательского опыта.
Итоги
Свойство summary позволяет определять и отображать итоговые строки в таблице. Эта функция позволяет выполнять
вычисления (например, сумму, минимум, максимум) над указанными полями и настраивать, как результаты отображаются.
Поле данных
Свойство dataField указывает поле данных, для которого рассчитывается итог.
Манго | Зеленый | 1800 |
Клубника | Фиолетовый | 221 |
Манго | Желтый | 904 |
Апельсин | Фиолетовый | 633 |
Клубника | Желтый | 829 |
Кол. 5 | Кол. 5 | Кол. 5 |
|---|
Указав dataField, вы определяете столбец, который будет использоваться для итоговых вычислений.
Имя
Свойство name предоставляет пользовательское имя для итога. Это полезно при отображении нескольких итогов.
Установите name, чтобы присвоить итогу значимое название.
Тип данных
Свойство dataType определяет тип данных для итога. Оно гарантирует, что значения итогов форматируются корректно в
зависимости от их типа. Доступные варианты:
"string": Для текстовых данных."number": Для числовых данных."select": Для данных на основе выпадающего списка."date": Для данных на основе дат.
Установите dataType в соответствии с типом данных в указанном dataField. Например, используйте "number" для
числовых значений или "date" для полей дат.
Тип
Свойство type определяет тип вычисления, выполняемого для итога. Доступные варианты:
"sum": Вычисляет сумму всех значений."min": Находит минимальное значение."max": Находит максимальное значение."avg": Вычисляет среднее значение всех значений."count": Подсчитывает количество строк.
Имя | Всего пользователей | Общая выручка | Активные пользователи | Новые пользователи сегодня |
|---|---|---|---|---|
Годовой обзор | 69713 | 991837 | 3245 | 116 |
Ежедневная статистика | 49572 | 264816 | 36465 | 206 |
Месячный отчет | 76474 | 282106 | 34994 | 847 |
Месячный отчет | 65571 | 443066 | 20098 | 761 |
Месячный отчет | 3583 | 472201 | 41712 | 112 |
Count: 5 | Avg: 52983 | Min: 264816 | Max: 41712 | Sum: 2042 |
Используйте type для настройки логики вычислений итога.
Формат отображения
Свойство displayFormat позволяет указать пользовательский формат для отображения результата итога. Вы можете
использовать заполнители, такие как {0}, для представления вычисленного значения.
Предопределённые форматы включают:
"Sum: {0}": Вычисляет сумму всех значений."Min: {0}": Находит минимальное значение."Max: {0}": Находит максимальное значение."Avg: {0}": Вычисляет среднее значение всех значений."Count: {0}": Подсчитывает количество строк.
Имя | Всего пользователей | Общая выручка | Активные пользователи | Новые пользователи сегодня |
|---|---|---|---|---|
Годовой обзор | 26121 | 762281 | 8460 | 385 |
Годовой обзор | 36150 | 882888 | 28536 | 237 |
Недельный отчет | 32771 | 876216 | 3013 | 858 |
Годовой обзор | 45274 | 213075 | 28967 | 421 |
Ежедневная статистика | 15339 | 81987 | 33830 | 380 |
Имя: 5 (count) | Всего пользователей: 31131 (avg) | Общая выручка: 81987 (min) | Активные пользователи: 33830 (max) | Новые пользователи сегодня: 2281 (sum) |
Используйте displayFormat для настройки отображения результата итога в таблице.
Пользовательский текст
Свойство customizeText предоставляет функцию для динамической настройки текста итога. Эта функция принимает
конфигурацию summary и вычисленный result в качестве параметров и возвращает форматированный текст.
Используйте customizeText для продвинутого форматирования текста на основе вычисленного значения итога.
Пагинация
Свойство pagination позволяет настроить, как данные таблицы разделяются на страницы, и как отображаются элементы
управления пагинацией.
Видимость
Свойство visible определяет, отображаются ли элементы управления пагинацией. Свойство pagination можно использовать
двумя способами:
- Булевый ярлык: Если установлено в
true, пагинация включается с настройками по умолчанию. - Детальная конфигурация: Предоставление объекта позволяет настроить поведение пагинации.
Клубника | Желтый | 1995 | false | Китай | 1.21 |
Персик | Красный | 499 | true | Таиланд | 3.42 |
Ананас | Желтый | 1834 | true | Бразилия | 7.25 |
Ананас | Зеленый | 413 | true | Китай | 2.44 |
Банан | Оранжевый | 775 | true | Таиланд | 0.29 |
Это включает пагинацию с конфигурацией по умолчанию.
Виноград | Фиолетовый | 1730 | true | Таиланд | 4.74 |
Клубника | Желтый | 1574 | false | Таиланд | 1.56 |
Виноград | Розовый | 1456 | true | США | 9.23 |
Манго | Фиолетовый | 1284 | true | США | 3.11 |
Банан | Оранжевый | 1277 | true | Индия | 2.83 |
Использование объекта позволяет явно настроить параметры пагинации, такие как видимость, размер страницы и другие.
Установка visible в true гарантирует отображение элементов управления пагинацией, а false скрывает их.
Режим
Свойство mode определяет стиль элементов управления пагинацией. Доступные варианты:
"filled": Стиль с заполнением по умолчанию."outlined": Стиль с обводкой."underlined": Стиль с подчёркиванием.
Киви | Красный | 647 | false | Индия | 0.46 |
Апельсин | Зеленый | 1527 | true | Мексика | 7.03 |
Ананас | Розовый | 359 | false | Мексика | 1.54 |
Арбуз | Зеленый | 719 | false | США | 6.26 |
Арбуз | Фиолетовый | 1938 | false | Бразилия | 4.26 |
Установите mode для настройки внешнего вида элементов управления пагинацией.
Начальная страница
Свойство startPage задаёт начальную страницу для отображения при рендеринге таблицы.
Манго | Красный | 1397 | true | США | 7.79 |
Яблоко | Оранжевый | 644 | true | Китай | 4.77 |
Виноград | Желтый | 1735 | false | США | 7.44 |
Персик | Оранжевый | 364 | true | США | 9.90 |
Арбуз | Розовый | 1305 | true | Испания | 4.10 |
Используйте startPage для установки номера страницы по умолчанию.
Размер страницы
Свойство sizePage определяет количество элементов, отображаемых на одной странице. Предопределённые значения включают
5, 15, 20, 50, 100 и 150.
Ананас | Оранжевый | 322 | true | Китай | 5.06 |
Виноград | Розовый | 1914 | false | Бразилия | 3.89 |
Киви | Красный | 246 | false | Таиланд | 5.08 |
Апельсин | Зеленый | 1731 | true | Мексика | 8.00 |
Апельсин | Розовый | 1869 | true | Китай | 8.28 |
Установите sizePage для контроля количества строк, отображаемых на странице.
Селектор размеров
Свойство sizesSelector определяет доступные варианты размеров страниц, которые пользователи могут выбрать.
Яблоко | Желтый | 1274 | true | Индия | 5.49 |
Яблоко | Красный | 837 | true | США | 5.89 |
Арбуз | Розовый | 441 | false | Индия | 3.57 |
Банан | Оранжевый | 1860 | false | Испания | 6.51 |
Яблоко | Красный | 1940 | true | Мексика | 7.48 |
Установите sizesSelector для предоставления пользовательского списка вариантов размеров страниц.
Количество видимых страниц
Свойство visibleNumberPages определяет, сколько номеров страниц отображается в элементе управления пагинацией.
Допустимые значения: 5, 6, 7, 8, 9, 10 или 11.
Манго | Красный | 675 | false | Китай | 9.48 |
Банан | Зеленый | 560 | true | Мексика | 3.40 |
Клубника | Зеленый | 153 | true | Индия | 1.92 |
Манго | Фиолетовый | 978 | true | Испания | 3.57 |
Манго | Оранжевый | 990 | true | Китай | 0.41 |
Установите visibleNumberPages для контроля количества видимых кнопок страниц.
Информационный текст
Свойство isInfoText включает информационный текст о состоянии пагинации, например, "Страница 1 из 5".
Арбуз | Зеленый | 1539 | true | Мексика | 5.81 |
Виноград | Красный | 1872 | true | Индия | 7.94 |
Яблоко | Желтый | 1218 | true | Таиланд | 3.79 |
Виноград | Зеленый | 1438 | false | Испания | 5.52 |
Киви | Фиолетовый | 965 | true | Индия | 1.92 |
Установите isInfoText в true для отображения информационного текста пагинации.
Селектор размера страницы
Свойство isPageSizeSelector включает выпадающий список для выбора размера страницы.
Арбуз | Розовый | 311 | false | Мексика | 3.17 |
Манго | Красный | 53 | false | Таиланд | 7.74 |
Банан | Фиолетовый | 507 | false | США | 4.89 |
Яблоко | Фиолетовый | 695 | false | Таиланд | 3.63 |
Яблоко | Желтый | 361 | true | Бразилия | 8.34 |
Установите isPageSizeSelector в true, чтобы позволить пользователям выбирать количество строк на странице.
Скрытие кнопок навигации
Свойство isHiddenNavigationButtons скрывает кнопки навигации пагинации (например, "Следующая" и "Предыдущая"), когда
установлено в true.
Апельсин | Зеленый | 1261 | true | Таиланд | 4.06 |
Клубника | Фиолетовый | 81 | true | Китай | 7.86 |
Арбуз | Розовый | 402 | true | Бразилия | 7.51 |
Банан | Розовый | 1691 | false | Индия | 8.21 |
Апельсин | Оранжевый | 1489 | false | Индия | 9.46 |
Установите isHiddenNavigationButtons в true для скрытия кнопок навигации.
Класс
Свойство class позволяет применять пользовательские CSS-классы к элементам управления пагинацией для стилизации.
Яблоко | Красный | 1504 | false | Китай | 4.53 |
Клубника | Зеленый | 1311 | false | Испания | 7.12 |
Клубника | Красный | 1267 | false | США | 0.64 |
Клубника | Желтый | 279 | false | Индия | 6.42 |
Арбуз | Желтый | 855 | true | Бразилия | 4.60 |
Установите class для стилизации элементов управления пагинацией с помощью пользовательских CSS-классов.
Слоты
Слоты — это настраиваемые секции таблицы, которые позволяют внедрять собственное содержимое. Таблица предоставляет
предопределённые слоты, такие как toolbar, header, footer и group. Кроме того, можно создавать динамические
слоты для пользовательского содержимого.
Панель инструментов
Слот #toolbar позволяет настраивать секцию панели инструментов таблицы. Это полезно для добавления пользовательских
кнопок, фильтров или дополнительных элементов управления.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Киви | Красный | 414 |
Ананас | Фиолетовый | 1116 |
Апельсин | Красный | 1221 |
Яблоко | Зеленый | 1051 |
Манго | Красный | 452 |
Примечание: Для отображения панели инструментов свойство
visibleдолжно быть явно установлено вtrueв конфигурацииtoolbar.
Используя слот #toolbar, вы можете внедрить пользовательское содержимое в область панели инструментов, гарантируя её
видимость, установив visible: true.
Заголовок
Слот #header позволяет настраивать заголовок таблицы. Вы можете изменить внешний вид заголовков столбцов или добавить
дополнительные элементы.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Клубника | Оранжевый | 261 |
Манго | Желтый | 203 |
Киви | Фиолетовый | 1325 |
Банан | Зеленый | 1037 |
Яблоко | Желтый | 364 |
Используйте слот #header для замены или улучшения заголовка таблицы по умолчанию.
Группа
Слот #group используется для настройки внешнего вида сгрупгпированных строк. Это особенно полезно, когда вы хотите
добавить пользовательские визуальные элементы или форматирование к сгруппированным данным.
item: Сгруппированный элемент.length: Общее количество сгруппированных элементов.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Желтый | ||
Ананас | Желтый | 1209 |
Арбуз | Желтый | 1039 |
Клубника | Желтый | 365 |
Апельсин | Желтый | 1687 |
Банан | Желтый | 1370 |
Используйте слот #group для определения отображения сгруппированных строк.
Нижний колонтитул
Слот #footer позволяет настраивать секцию нижнего колонтитула таблицы. Это полезно для добавления итогов, элементов
управления пагинацией или других пользовательских элементов.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Ананас | Оранжевый | 1349 |
Киви | Фиолетовый | 265 |
Арбуз | Оранжевый | 1649 |
Киви | Фиолетовый | 77 |
Апельсин | Зеленый | 844 |
Используйте слот #footer для добавления содержимого или функциональности в нижний колонтитул таблицы.
Динамические слоты
Помимо предопределённых слотов, динамические слоты позволяют настраивать содержимое для конкретных ячеек или компонентов таблицы динамически. Динамические слоты используют ключи для таргетинга на определённые столбцы или строки.
Следующие аргументы передаются в динамические слоты:
name: Имя слота.key: Ключ столбца или строки.column: Объект конфигурации столбца.rowData: Данные текущей строки.value: Значение ячейки.valueWithMarker: Значение ячейки с применёнными маркерами.isCloseEditor: Функция для управления закрытием редактора ячейки.editValue: Функция для редактирования значения ячейки.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Киви | Красный | 1257 |
Арбуз | Оранжевый | 394 |
Клубника | Фиолетовый | 1368 |
Виноград | Фиолетовый | 1771 |
Персик | Фиолетовый | 1485 |
Динамические слоты обеспечивают гибкость для настройки отдельных ячеек или строк на основе предоставленных аргументов.
Стили
Этот раздел предоставляет опции для настройки внешнего вида и стилизации таблицы. Вы можете контролировать режимы стилизации, применять пользовательские CSS-классы и настраивать детализированные свойства стилей.
Режим
Свойство mode определяет общий режим стилизации таблицы. Доступные варианты:
"filled": Стиль таблицы с заполнением."outlined": Таблица с контурными границами."underlined": Таблица с подчёркнутыми строками или столбцами.
Киви | Желтый | 649 |
Яблоко | Красный | 874 |
Апельсин | Фиолетовый | 1906 |
Клубника | Фиолетовый | 1464 |
Ананас | Розовый | 1713 |
Установите mode для определения общего внешнего вида таблицы.
Нет данных
Свойство noData определяет сообщение, отображаемое, когда в таблице нет доступных данных.
В этом примере сообщение "Данные временно недоступны." будет показано, когда источник данных пуст.
Нет столбцов
Свойство noColumn определяет сообщение, отображаемое, когда в таблице не определены столбцы.
Здесь сообщение "Столбцы для таблицы не определены." будет отображено, когда конфигурации столбцов не предоставлены.
Класс
Свойство class позволяет применять пользовательские CSS-классы к контейнеру таблицы для дополнительной стилизации.
Клубника | Желтый | 1964 |
Киви | Красный | 303 |
Персик | Желтый | 52 |
Виноград | Желтый | 1169 |
Банан | Розовый | 1556 |
Используйте class для применения пользовательских стилей, таких как отступы, цвета или границы, к контейнеру таблицы.
Стили
Свойство styles предоставляет всесторонний способ настройки внешнего вида таблицы. Ниже приведены примеры,
демонстрирующие различные конфигурации свойства styles.
Пользовательский класс и граница
Вы можете определять пользовательские CSS-классы и стили границ для таблицы.
Фиолетовый | ||
|---|---|---|
Клубника | Фиолетовый | 287 |
Яблоко | Фиолетовый | 1667 |
Киви | Фиолетовый | 595 |
Банан | Фиолетовый | 1620 |
Ананас | Фиолетовый | 1818 |
В этом примере применяется пользовательский CSS-класс, и отображается только нижняя граница.
Пользовательская ширина и высота
Вы можете настроить ширину и высоту таблицы для соответствия вашему макету.
Желтый | ||
|---|---|---|
Манго | Желтый | 460 |
Манго | Желтый | 573 |
Клубника | Желтый | 998 |
Банан | Желтый | 1168 |
Персик | Желтый | 215 |
Этот пример задаёт таблице ширину 100% от ширины контейнера и фиксированную высоту 500 пикселей.
Эффекты наведения и чередующиеся строки
Включите эффекты наведения и чередующиеся строки для лучшей визуализации строк.
Киви | Оранжевый | 1210 |
Апельсин | Желтый | 1875 |
Ананас | Красный | 1264 |
Яблоко | Желтый | 328 |
Виноград | Оранжевый | 350 |
Здесь строки изменяют внешний вид при наведении, и включены чередующиеся полосы строк.
Горизонтальные линии, вертикальные линии и линии фильтров
Управляйте отображением горизонтальных и вертикальных линий, а также включайте или отключайте линии фильтров.
Персик | Розовый | 235 |
Апельсин | Фиолетовый | 214 |
Ананас | Оранжевый | 384 |
Виноград | Зеленый | 657 |
Ананас | Красный | 873 |
Этот пример гарантирует видимость разделителей строк и столбцов, а также отображение линий фильтров.
Радиус границы и высота ячейки
Настройте радиус границы и высоту ячеек таблицы для более индивидуального дизайна.
Киви | Оранжевый | 1233 |
Апельсин | Оранжевый | 360 |
Банан | Розовый | 1522 |
Апельсин | Оранжевый | 889 |
Арбуз | Фиолетовый | 320 |
В этом примере таблица имеет скруглённые углы (радиус 10 пикселей), а каждая строка имеет высоту 50 пикселей.
Обзор стилей
Свойство styles предоставляет гибкий и всесторонний способ настройки внешнего вида вашей таблицы. Вы можете определять
всё, от размеров, эффектов наведения и стилизации строк до анимаций, границ и форматирования текста. Это позволяет
создать высоко индивидуализированный дизайн, соответствующий визуальным требованиям вашего приложения.
class: CSS-классы для различных частей таблицы.width: Ширина таблицы (например,"100%","800px").height: Высота таблицы (например,"500px").hoverRows: Стили, применяемые при наведении на строки (например,"hover:bg-neutral-100/90").isStripedRows: Включение или отключение стилизации чередующихся строк.horizontalLines: Показ или скрытие горизонтальных линий между строками.verticalLines: Показ или скрытие вертикальных линий между столбцами.filterLines: Отображение линий фильтров.borderRadiusPx: Радиус границы таблицы (в пикселях).heightCell: Высота ячеек таблицы (в пикселях).defaultWidthColumn: Ширина столбца по умолчанию (например,"max-width: 600px;min-width:100px;width:auto").maskQuery: Стилизация текста запроса (например,"font-bold text-theme-700 dark:text-theme-300").animation: Стили анимации, такие как"transition-all duration-500"или"transition-none".border: Стили границы таблицы (например,"border-0"или"border-t-0 border-b-0").
Используйте свойство styles для определения детализированного и целостного внешнего вида вашей таблицы, охватывающего
все аспекты от размеров до эффектов наведения.
Стилизация столбцов
Свойство class позволяет применять пользовательские CSS-классы к различным частям столбца, включая заголовок, фильтр и
содержимое ячеек.
Заголовочная ячейка
Примените пользовательский CSS-класс к ячейке заголовка (th). Это позволяет настраивать внешний вид ячеек заголовков
таблицы в соответствии с вашими дизайнерскими потребностями.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Клубника | Розовый | 950 |
Ананас | Розовый | 703 |
Манго | Красный | 64 |
Ананас | Желтый | 1383 |
Ананас | Оранжевый | 342 |
Фильтр столбца
Свойство colFilter позволяет применять пользовательский CSS-класс к полю ввода фильтра столбца, давая возможность
стилизовать элементы ввода фильтра.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Апельсин | Оранжевый | 1987 |
Яблоко | Желтый | 548 |
Банан | Красный | 141 |
Ананас | Розовый | 1415 |
Банан | Оранжевый | 1256 |
Класс контейнера фильтра
Используйте свойство colFilterClass для применения пользовательского CSS-класса к контейнеру фильтра столбца, позволяя
точно стилизовать контейнер фильтра.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Банан | Красный | 549 |
Клубника | Фиолетовый | 1495 |
Киви | Оранжевый | 1818 |
Арбуз | Желтый | 119 |
Банан | Красный | 779 |
Класс тела фильтра
Свойство colFilterClassBody позволяет применять пользовательский CSS-класс к телу фильтра столбца, предоставляя
дополнительный контроль над стилизацией тела фильтра.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Персик | Красный | 1996 |
Манго | Красный | 1821 |
Ананас | Оранжевый | 870 |
Апельсин | Зеленый | 571 |
Яблоко | Розовый | 404 |
Текст столбца
Используйте свойство colText для применения пользовательского CSS-класса к текстовому содержимому в заголовке столбца.
Это свойство помогает настраивать стиль текста в ячейках заголовков.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Банан | Зеленый | 1988 |
Банан | Розовый | 780 |
Ананас | Фиолетовый | 78 |
Клубника | Желтый | 482 |
Ананас | Красный | 1709 |
Ячейка данных
Примените пользовательский CSS-класс к ячейкам данных таблицы (td). Это свойство позволяет настраивать внешний вид
ячеек данных таблицы.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Клубника | Зеленый | 189 |
Яблоко | Розовый | 423 |
Банан | Желтый | 1570 |
Персик | Розовый | 764 |
Арбуз | Красный | 652 |
Текст ячейки
Свойство cellText позволяет применять пользовательский CSS-класс к текстовому содержимому внутри ячеек. Это
предоставляет контроль над стилизацией текста ячеек.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Апельсин | Желтый | 1258 |
Персик | Фиолетовый | 87 |
Клубника | Желтый | 1107 |
Банан | Зеленый | 604 |
Клубника | Розовый | 1690 |
Ячейка нижнего колонтитула
Свойство tf позволяет применять пользовательский CSS-класс к ячейке нижнего колонтитула (tf). Это полезно для
настройки внешнего вида ячеек нижнего колонтитула.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Виноград | Розовый | 1357 |
Апельсин | Фиолетовый | 1556 |
Киви | Фиолетовый | 793 |
Персик | Оранжевый | 1344 |
Клубника | Розовый | 278 |
Текст итога
Используйте свойство sumText для применения пользовательского CSS-класса к тексту итога в нижнем колонтитуле. Это
свойство помогает настраивать стиль текста итога в ячейках нижнего колонтитула.
Имя | Цвет | Вес (граммы) |
|---|---|---|
Виноград | Желтый | 1312 |
Ананас | Желтый | 1811 |
Ананас | Фиолетовый | 1666 |
Клубника | Розовый | 1856 |
Персик | Желтый | 1872 |
Редактирование
Таблица поддерживает функциональность редактирования, которая позволяет добавлять, обновлять и удалять строки данных. Эта функция может быть включена для всей таблицы или настроена на уровне столбцов для большей гибкости.
Включение режима редактирования
Чтобы включить редактирование для всей таблицы, используйте свойство :edit и установите его в true:
Имя | Роль | Создано | Обновлено |
|---|---|---|---|
Зоя | admin | 31.05.2024 | 02.09.2026 |
Дмитрий | guest | 09.08.2022 | 13.10.2023 |
Федор | user | 20.01.2025 | 17.07.2023 |
Федор | guest | 16.02.2024 | 14.02.2022 |
Елена | user | 20.03.2023 | 14.03.2022 |
Это включает редактирование для всех столбцов таблицы.
Редактирование на уровне столбцов
Вы можете включать или отключать редактирование для конкретных столбцов, используя опцию edit в конфигурации столбца.
Это позволяет настраивать, какие столбцы можно редактировать.
Имя | Возраст | Роль |
|---|---|---|
Зоя | admin | |
Дмитрий | guest | |
Федор | user | |
Федор | guest | |
Елена | user |
В этом примере редактирование включено для столбцов id и name, но отключено для столбца age.
Эта комбинация включает редактирование для всей таблицы, но исключает определённые столбцы из возможности редактирования.
Настройка редакторов ячеек
Таблица предоставляет возможность настраивать редактор для каждой ячейки на основе типа данных столбца. Это достигается
с помощью опции edit в конфигурации столбца:
Опции редактора столбца
type: Определяет тип данных в столбце ("string","number","select"или"date").editorOptions: Указывает дополнительную конфигурацию для редактора в зависимости от типа данных.
Обратитесь к соответствующей документации для получения дополнительной информации:
Для опций конфигурации при использовании полей ввода (типы "string" или "number") изучите свойства поля ввода.
Для опций конфигурации при использовании полей выбора (тип "select") изучите свойства поля выбора.
Для опций конфигурации при использовании полей дат (тип "date") изучите свойства поля даты.
Редактирование данных
Таблица предоставляет набор методов для динамического редактирования, управления и взаимодействия с её данными. Эти
методы доступны через refLink таблицы и позволяют реализовать функциональность, такую как добавление, обновление,
удаление строк и многое другое.
Для полного списка доступных методов и их использования обратитесь к документации API таблицы.