КРЕАТИВНЫЕ САЙТЫ И ПРИЛОЖЕНИЯ,
КАЧЕСТВЕННЫЕ WEB-УСЛУГИ
phone

SwTable

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

SwTable

Компонент SwTable — динамическая таблица с вложенными заголовками, объединением ячеек (rowspan / colspan), кастомизацией через слоты, подсветкой строк и столбцов при наведении, изменением ширины колонок и фиксацией крайних колонок при горизонтальном скролле. Колонки описываются дочерним компонентом SwTableColumn.

Свойства SwTable / SwTable Properties

ИмяТипПо умолчаниюЗначения/Описание
dataArrayrequiredДанные таблицы — массив объектов.
resizableBooleantrueРазрешить изменение ширины колонок перетаскиванием края заголовка.
maxWidthString | Number—Максимальная ширина контейнера таблицы. При переполнении — горизонтальный скролл и активация fixed-колонок.

События SwTable / SwTable Events

ИмяПараметрыdОписание
column-resize{ prop, width }Срабатывает после изменения ширины колонки (в px).

Свойства SwTableColumn / SwTableColumn Properties

ИмяТипПо умолчаниюЗначения / Описание
propString—Ключ поля в объекте строки. Поддерживает вложенные пути: speed.midl.
labelString''Заголовок колонки.
widthString | Number'auto'Ширина колонки, например 180 или '180px'.
heightString | Number'auto'Минимальная высота ячейки заголовка.
resizableBoolean—Разрешить ресайз конкретной колонки. По умолчанию наследует resizable таблицы.
minWidthString | Number48Минимальная ширина при ресайзе (px).
fixedString—'left' | 'right' — фиксация колонки при горизонтальном скролле.

SwTableColumn без prop используется как групповой заголовок; внутри него задаются дочерние SwTableColumn.

Подсветка при наведении / Hover highlight

  • Row — при наведении на строку в tbody подсвечиваются все её ячейки (учитывается rowspan).
  • Column — при наведении на ячейку заголовка подсвечивается весь столбец; для группового заголовка с colspan — все вложенные колонки.

Стили подсветки заданы в component-sw.css (классы row-hover, col-hover).

Фиксированные колонки / Fixed columns

Фиксация включается, когда одновременно: 1. задан max-width у SwTable; 2. у колонок указан fixed="left" или fixed="right"; 3. суммарная ширина таблицы превышает контейнер. Групповой заголовок фиксируется, если все его дочерние колонки имеют одинаковое значение fixed.

Слоты / Slots

#<prop> — именованный слот для конкретной колонки (приоритет выше cell). Параметры: { row, $index, value } #cell — универсальный слот для всех колонок (default-слот занят SwTableColumn). Параметры: { row, $index, column, value }

  • row — весь объект строки данных
  • $index — индекс строки (начиная с 0)
  • column — имя колонки (prop)
  • value — значение ячейки

Пример использования / Example Usage

Базовая таблица с ресайзом и слотами:

<script setup>
import { ref } from 'vue'
const users = ref([
  { name: 'Иван Петров', age: 25, status: 'active' },
  { name: 'Мария Сидорова', age: 30, status: 'inactive' },
  { name: 'Петр Иванов', age: 35, status: 'active' }
])
function logRow(row) {
  console.log('row:', row)
}
</script>

<sw-table :data="users" :resizable="true" @column-resize="console.log">
  <sw-table-column prop="name" label="Имя" width="180px" />
  <sw-table-column prop="age" label="Возраст" width="100px" />
  <sw-table-column prop="status" label="Статус" width="120px" />
  <sw-table-column prop="actions" label="Действия" width="150px" :resizable="false" />

  <template #name="{ value }">
    <strong>{{ value }}</strong>
  </template>
  <template #status="{ value }">
    {{ value === 'active' ? 'Активен' : 'Неактивен' }}
  </template>
  <template #actions="{ row }">
    <sw-button type="info" size="small" text @click="logRow(row)">...</sw-button>
  </template>
</sw-table>

Вложенные заголовки:

<script setup>
import { ref } from 'vue'
const nestedData = ref([
  { city: 'Москва', district: 'Центр', speed: 70 },
  { city: 'Санкт-Петербург', district: 'Невский', speed: 60 }
])
</script>

<sw-table :data="nestedData">
  <sw-table-column label="Адрес">
    <sw-table-column prop="city" label="Город" width="140px" />
    <sw-table-column prop="district" label="Район" width="120px" />
  </sw-table-column>
  <sw-table-column prop="speed" label="Скорость" width="100px" />
</sw-table>

Динамические колонки (v-for):

<script setup>
import { ref } from 'vue'
const productColumns = ref([
  { prop: 'name', label: 'Название', width: '200px' },
  { prop: 'price', label: 'Цена', width: '100px' },
  { prop: 'quantity', label: 'Кол-во', width: '90px' }
])
const products = ref([
  { name: 'Товар 1', price: 1000, quantity: 5 },
  { name: 'Товар 2', price: 2500, quantity: 3 }
])
</script>

<sw-table :data="products">
  <sw-table-column
    v-for="column in productColumns"
    :key="column.prop"
    :prop="column.prop"
    :label="column.label"
    :width="column.width"
  />
</sw-table>

Фиксированные крайние колонки:

<script setup>
import { ref } from 'vue'
const wideColumns = ref([
  { prop: 'dept', label: 'Отдел', width: '140px' },
  { prop: 'email', label: 'Email', width: '200px' }
])
const wideRows = ref([
  { id: 1, name: 'Иван Петров', dept: 'Разработка', email: 'ivan@example.com', note: 'В отпуске' },
  { id: 2, name: 'Мария Сидорова', dept: 'Дизайн', email: 'maria@example.com', note: 'Удалённо' }
])
</script>

<sw-table :data="wideRows" max-width="520px">
  <sw-table-column prop="id" label="ID" width="70px" fixed="left" />
  <sw-table-column prop="name" label="Имя" width="160px" fixed="left" />
  <sw-table-column
    v-for="column in wideColumns"
    :key="column.prop"
    :prop="column.prop"
    :label="column.label"
    :width="column.width"
  />
  <sw-table-column prop="note" label="Примечание" width="180px" fixed="right" />
</sw-table>

Объединение ячеек (rowspan / colspan):

<script setup>
import { ref } from 'vue'
const mergedData = ref([
  { city: { label: 'Москва', rowspan: 2 }, district: 'Центр', population: 500000 },
  { city: 'Москва', district: 'Север', population: 300000 },
  { city: { label: 'Итого', colspan: 2 }, population: 800000 }
])
</script>

<sw-table :data="mergedData">
  <sw-table-column prop="city" label="Город" width="120px" />
  <sw-table-column prop="district" label="Район" width="120px" />
  <sw-table-column prop="population" label="Население" width="120px" />
</sw-table>