class Controls/list:View

Контрол "Плоский список" позволяет отображать данные из различных источников в виде упорядоченного списка.

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

Примеры

Пример
Исходный код

Примечание

Опции

Выравнивание опций записи, когда они отображаются в режиме swipe.

IItemActions

Позиция заголовка для опций записи, когда они отображаются в режиме swipe.

IItemActions

Ключ текущего активного элемента

IList

При изначальной загрузке списка прижимать верхний триггер загрузки к нулевой позиции.

IList

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

IList

Идентификаторы групп, которые будут свернуты при инициализации списка.

IGroupedList

Визуальное представление меню опций записи и контекстного меню.

IItemActions

Видимость контекстного меню опций записи.

IItemActions

Пользовательский шаблон, который отображается под кнопкой "Продолжить поиск".

IList

Функция, которая вызывается каждый раз непосредственно после загрузки данных из источника контрола.

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

ISource

Функция обратного вызова для определения сбоя загрузки данных из источника.

ISource
IDraggable
IEditableList

Пользовательский шаблон отображения контрола без элементов.

IList

Компонент для обработки ошибки.

Данную опцию следует определять, если нужно изменить способ отображения ошибки (диалог, вместо контента или во всю страницу) или добавить свои обработчики ошибок.

IErrorControllerOptions
IPromisedSelectable

Массив с идентификаторами высвеченных записей.

IList

Конфигурация объекта фильтра. Фильтр отправляется в запрос к источнику для получения данных.

IFilter

Пользовательский шаблон отображения подвала контрола.

IList

Идентификатор, по которому на Сервисе параметров сохраняется текущее состояние развернутости групп.

IGroupedList

Имя свойства, содержащего идентификатор группы элемента списка.

IGroupedList

Устанавливает пользовательский шаблон, с помощью которого настраивается визуальное представление заголовка группы.

IGroupedList
IGroupedList

Стиль подсветки строки при наведении курсора мыши.

IList

Функция обратного вызова для определения видимости опций записи.

IItemActions

Конфигурация опций записи.

IItemActions

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

IItemActions

Позиционирование панели опций записи.

IItemActions

Имя поля записи, в котором хранится конфигурация для панели с опциями записи.

IItemActions

Отображение опций записи с задержкой или без.

IItemActions

Конфигурация отступов внутри элементов списка.

IItemPadding

Пользовательский шаблон отображения элемента.

IItemTemplate

Имя поля элемента, которое содержит имя шаблона отображения элемента. С помощью этой настройки отдельным элементам можно задать собственный шаблон отображения.

IItemTemplate

Определяет, может ли пользователь перемещать элементы в списке с помощью drag'n'drop. Когда опция установлена в значение true, перемещение разрешено.

IDraggable

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

Функция единожды вызывается при построении контрола, а также в следующих случаях:

  • RecordSet, по которому строится список был пересоздан

  • Изменился конструктор модели списка (например, когда переключили вид списка)

  • Изменилось название поля, содержащего ключ записи

IList

Размер отступа между записями списка

IList

Размер пачки записей, которую мы пытаемся загрузить за отведенное время.

IList

Время итеративной загрузки, за которое мы пытаемся загрузить пачку записей.

IList

Определяет шаблон индикатора загрузки данных при порционном поиске.

IList

Сохранять ли позицию скролла после перезагрузки

IList

Имя поля записи, в котором хранится первичный ключ.

ISource

Определяет шаблон индикатора загрузки данных при порционном поиске.

IList

Идентификатор элемента, который выделен маркером.

IMarkerList

Режим отображения маркера.

IMarkerList

Шаблон отображения кнопки подгрузки данных при навигации "по запросу"

IList

Опция управляет стилем цвета текста для кнопки "Ещё".

IList

Параметры диалогового окна выбора целевой записи для перемещения.

IMovableList

Когда опция установлена в значение true, то при изменении страницы с помощью кнопок навигации ("К следующей странице", "К предыдущей странице" и т.д.) маркер будет установлен на первую полностью видимую запись на новой странице.

IListNavigation

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

IList

Позиционирование чекбокса.

IList

Пользовательский шаблон множественного выбора.

IList

Видимость чекбоксов.

IList

Конфигурация навигации в списке.

INavigation

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

isWasabyControl

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

IList

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

IList

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

IList

Определяет, может ли пользователь изменить значение контрола.

(или взаимодействовать с контролом, если его значение не редактируется).

isWasabyControl

Cкругление углов элемента списка.

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

IList
IList

Настройка видимости линий-разделителей строк по краям и внутри списка.

IList

Набор ключей выбранных элементов.

IPromisedSelectable

Конфигурация сортировки.

ISorting

Объект реализующий интерфейс Types/source:ICrud, необходимый для работы с источником данных.

ISource

Экземпляр класса загрузчика данных Controls/dataSource:NewSourceController.

IList

Функция обратного вызова для определения залипания элемента списка.

В зависимости от возвращаемого значения может контролировать залипание элемента списка:

  • top - элемент списка залипает только у верхней границы списка
  • bottom - элемент списка залипает только у нижней границы списка
  • topBottom - элемент списка залипает и у верхней и у нижней границы списка
IList

Закрепляет подвал списка.

IList

При включенной группировке элементов опция задает прилипание заголовков групп при прокрутке списка.

IList

Прилипание шапки таблицы и заголовков групп при прокрутке таблицы или списка.

IList

Позволяет включать/отключать прилипание выбранного элемента.

IList

Прилипание итогов при прокрутке таблицы.

IList

Индентификатор загрузчика данных.

IStoreId

Режим отображения списка.

IList

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

isWasabyControl

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

IList

Конфигурация виртуального скролла.

IVirtualScroll

Поля

подмешивается в совместимости. нужно для совместимости с ws3.

Определяет значения опций для декорирования.

Control

Логический родитель. То есть тот, в шаблоне которого лежит данный экземпляр.

В идеале отказаться, но пока что есть использования.

Control

Название контрола.

Control

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

жизненного цикла _afterRender и _afterUpdate

Control
deprecated

Массив имен нетемизированных стилей, необходимых контролу.

Все стили будут скачаны при создании

Control
deprecated

Массив имен темизированных стилей, необходимых контролу.

Все стили будут скачаны при создании

Control

Нужно для переноса _children родителя из оберток над чистым реактом, чтобы работал вызов методов с инстанса контрола

Control
protected

Набор детей контрола, для которых задан атрибут name.

Control

Контекст с опциями readOnly и theme

Control
protected

Реальные опции контрола. Туда собираются значения из props и context.

ВАЖНО: значения могут не совпадать с props в некоторые моменты времени,

чтобы в хуках были правильные значения.

Control
protected

Шаблон контрола.

Control

Методы

protected

Хук жизненного цикла контрола. Вызывается сразу после установки контрола в DOM-окружение.

Control
protected

Хук жизненного цикла контрола.

Вызывается синхронно после того, как изменения были применены к DOM и до того, как браузер отрисовал кадр.

Control
protected

Асинхронный хук жизненного цикла контрола. Вызывается после обновления контрола.

Control
protected

Хук жизненного цикла контрола. Вызывается непосредственно перед установкой контрола в DOM-окружение.

Control
protected

Хук жизненного цикла контрола. Вызывается перед обновлением контрола.

Control

Хук жизненного цикла контрола. Вызывается до удаления контрола.

Control
protected

Хук жизненного цикла контрола. Вызывается перед обновлением контрола.

Control

Синхронный хук жизненного цикла контрола. Вызывается сразу после установки контрола в DOM-окружение.

Control
protected

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

Control

Активирует контрол.

isWasabyControl

Запускает добавление по месту.

Использование метода в списке с режимом "только чтение" невозможно.

IEditableList

Запускает редактирование по месту.

Использование метода в списке с режимом "только чтение" невозможно.

IEditableList

Завершает редактирование/добавление по месту без сохранения введенных данных.

Использование метода в списке с режимом "только чтение" невозможно.

IEditableList

Завершает редактирование/добавление по месту с сохранением введенных данных.

Использование метода в списке с режимом "только чтение" невозможно.

IEditableList

Создаёт и монтирует контрол на элемент

Control

Старый способ наследоваться

Control

Замораживает hover подсветку строки для указанной записи

Возвращает рекордсет, на основании которого в данный момент строится список.

IList

Загрузка стилей и тем контрола

Control

Для обратной совместимости

Control

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

IMovableList

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

IMovableList

Перемещает указанные записи в указанную позицию position, которая может принимать значения after/before/on. Перемещение происходит только в источнике.

IMovableList

Перемещает указанные элементы при помощи диалога MoveDialog, и возвращает результат moveItems().

IMovableList

Перезагружает данные из источника данных.

IReloadableList

Загружает модель из источника данных, объединяет изменения в текущих данных и отображает элемент.

IList

Удаляет элементы из источника данных по идентификаторам элементов коллекции.

IRemovableList

Удаляет с подтверждением элементы из источника данных по идентификаторам элементов коллекции.

IRemovableList

Для обратной совместимости

Control

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

IList

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

IList

Размораживает все ранее замороженные итемы

События

actionClick Происходит при клике по опции записи.

IItemActions

Происходит при активации контрола.

isWasabyControl

activeElementChanged Происходит при смене активного элемента в процессе скроллирования.

IList

Происходит после запуска редактирования/добавления по месту.

IEditableList

Происходит после завершения редактирования/добавления по месту.

IEditableList

Происходит перед запуском редактирования/добавления по месту.

IEditableList

Происходит перед завершением редактирования/добавления по месту.

IEditableList

Происходит до изменения ключа маркера.

IMarkerList

Происходит до изменения списка выбранных элементов.

IPromisedSelectable

changeDragTarget Происходит перед изменением позиции, в которую будет перемещен элемент.

IDraggable

Происходит при деактивации контрола.

isWasabyControl

disableVirtualNavigation Происходит при использовании виртуального скролла, когда список находится в такой позиции, что сверху или снизу списка нет скрытых (или доступных для загрузки) элементов.

IVirtualScroll

dragEnd Происходит при завершении перемещения элемента в списке.

IDraggable

dragEnter Происходит при перемещении элемента из другого контрола.

IDraggable

dragStart Происходит при начале перемещения элемента.

IDraggable

drawItems Происходит при отрисовке очередного набора данных.

IList

enableVirtualNavigation Происходит при использовании виртуального скролла, когда список находится в такой позиции, что сверху и снизу списка есть скрытые (или доступные для загрузки) элементы.

IVirtualScroll

Происходит при изменении набора исключенных из выбора элементов списка.

IPromisedSelectable

filterChanged Происходит при изменении фильтра.

IFilterChanged

Происходит при сворачивании группы.

IGroupedList

Происходит при развертывании группы.

IGroupedList

hoveredItemChanged Происходит при наведении курсора мыши на элемент списка.

IList

itemActivate Происходит при активации элемента.

IList

itemClick Происходит при клике на элемент списка.

IClickableView

itemLongTap Происходит при долгом тапе на элементе списка на touch устройствах.

IList

itemMouseDown Происходит в момент нажатия на кнопку мыши над элементом списка.

IList

itemMouseEnter Происходит в момент, когда курсор оказывается над элементом списка.

IList

itemMouseLeave Происходит в момент, когда курсор уходит за пределы элемента списка.

IList

itemMouseMove Происходит в момент, когда курсор двигается по элементам списка.

IList

itemSwipe Происходит при свайпе на элементе списка.

IList

Происходит при выделении пользователем элемента списка.

IMarkerList

navigationParamsChanged Происходит при изменении параметров навигации.

IListNavigation

pagingArrowClick Происходит при клике по кнопкам перехода к первой и последней странице.

IList

Происходит при изменении набора выбранных элементов списка.

IPromisedSelectable

selectedLimitChanged Происходит при изменении лимита при выборе записей пачками в ПМО.

IList