Appearance
Единая фильтрация объектов
LibObjectFilter задаёт единый контракт фильтрации объектов. Компонент объединяет текстовый поиск, фильтры по свойствам объекта и структурные группы тегов в один пресет, который можно сохранить и применить в разных представлениях без привязки к конкретному источнику данных или способу отображения.
Пресет фильтрации
ts
/**
* @description Общий пресет фильтрации объектов. Это переносимый контракт для
* сохранения и применения фильтра в разных приложениях и представлениях.
*/
export interface LibObjectFilterPreset
extends
LibObjectFilterSearch,
LibObjectFilterTagGroupFilter,
LibObjectFilterProjectFilter {
propertyFilters: LibObjectFilterPropertyFilters;
}Текстовый поиск search
search — текстовая часть пресета фильтрации (поле ввода). Ввод + кнопка справа (или Enter) превращают набранное в структурный термин searchGroups (BMSBUIL-1426): чипы с И/ИЛИ между ними, как у тегов. Чипов нет — черновик фильтрует на лету по-старому (подстрока, UUID — точно по техническим полям); чипы есть — черновик не фильтрует. «#...» — режим набора тега и в термины не превращается.
ts
/**
* @description Текстовый запрос, который потребитель применяет к своему набору
* полей объекта.
*
* `searchGroups` — структурные термины поиска по тем же правилам, что и
* теговые группы: И внутри группы, ИЛИ между группами. Задан и непуст —
* заменяет строку `search` (та остаётся для потребителей без терминов);
* пустой список ничего не ограничивает.
*/
export interface LibObjectFilterSearch {
search: string;
searchGroups?: string[][];
}Свойства объекта selectedFilters
selectedFilters — часть пресета для фильтрации по свойствам объекта. В текущей доменной модели сюда входят тип объекта, наличие логики, наличие привязанных драйверов и наличие аварий. Набор доступных значений задаётся через filterOptions, поэтому компонент отображает эти свойства как обычное дерево выбора и не привязывает UI к конкретной модели хранения.
ts
/**
* @description Фильтры по свойствам объекта, которые не относятся к текстовому
* поиску и теговым группам. Пустой массив `objectTypes` не ограничивает типы.
*/
export interface LibObjectFilterPropertyFilters {
objectTypes: string[];
hasLogic: boolean;
hasDrivers: boolean;
hasAlarms: boolean;
}Теговые группы tagGroups
tagGroups — структурная часть пресета для теговой фильтрации. Внешний массив групп работает как «или» между альтернативами, внутренний массив тегов работает как «и» внутри одной группы. Такой формат валидируется как обычные данные и не требует дополнительного разбора перед выполнением фильтра.
ts
/**
* @description Структурный контракт тегового фильтра. Внешний массив работает
* как OR между группами, внутренний массив работает как AND между тегами внутри
* одной группы. Такой формат хранится и передаётся без парсинга строкового DSL.
*/
export type LibObjectFilterTagGroups = string[][];Проекты projectIds
ts
/**
* @description Ограничение отбора списком проектов. Не задано или пуст —
* фильтр по проектам не применяется (записи всех проектов).
*/
export interface LibObjectFilterProjectFilter {
projectIds?: string[];
}