# Представления

- Human documentation: [https://docs.univer.ai/ru-RU/guides/bases/features/core/views](https://docs.univer.ai/ru-RU/guides/bases/features/core/views)

- Agent Markdown: [https://docs.univer.ai/ru-RU/guides/bases/features/core/views.md](https://docs.univer.ai/ru-RU/guides/bases/features/core/views.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.2.0`

- Source: [bases/features/core/views.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/bases/features/core/views.ru-RU.mdx)

---

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



## Создание представлений

```ts
const grid = table.createView('All records', univerAPI.Enum.BaseViewType.Grid)

const kanban = table.createView(
  'By status',
  univerAPI.Enum.BaseViewType.Kanban,
  {
    view: {
      config: { groupFieldId: 'status' },
    },
  },
)
```

## Активация представления в интерфейсе

```ts
const baseUI = univerAPI.getBaseUI()
await baseUI.activateTable(table.getId())
await baseUI.activateView(kanban.getId())
```

## Настройка правил представления

```ts
kanban.setGroup([
  { fieldId: 'status', direction: univerAPI.Enum.BaseSortDirection.ASC },
])

kanban.setFilter({
  conjunction: univerAPI.Enum.BaseFilterConjunction.AND,
  conditions: [
    { fieldId: 'archived', operator: univerAPI.Enum.BaseFilterOperator.IS, operand: false },
  ],
})
```

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

## Даты календаря

Календарю нужна дата начала, а диаграмме Ганта — также дата окончания. Гант поддерживает рабочие дни, прогресс и зависимости. Gallery использует `card` для заголовка и полей. Сводкам и диаграммам Pivot нужен [плагин панелей](https://docs.univer.ai/ru-RU/guides/bases/features/dashboard.md).

```ts
const calendar = table.createView('Schedule', univerAPI.Enum.BaseViewType.Calendar, {
  view: {
    config: { startDateFieldId: 'startDate', endDateFieldId: 'endDate', mode: 'month' },
  },
})
```

## Сортировка и отображение полей

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

```ts
grid.setSort([{ fieldId: 'priority', direction: univerAPI.Enum.BaseSortDirection.DESC }])
grid.setFieldVisible('internalNotes', false)
grid.setFieldWidth('title', 280)
```

## Условная окраска

Выделите записи со значением выше 80:

```ts
const score = table.addField('Score', univerAPI.Enum.BaseFieldType.Number)
grid.setConditionalColorRules([{
  id: 'high-score',
  target: univerAPI.Enum.BaseConditionalColorTarget.ROW,
  fieldId: score.getId(),
  operator: univerAPI.Enum.BaseConditionalColorOperator.GREATER_THAN,
  operand: 80,
  color: '#dcfce7',
}])
```

Приоритет задаётся порядком в массиве. `[]` очищает правила. Поддерживаются ячейки, строки и столбцы; столбцы окрашиваются без условия.