SwTable
Компонент SwTable — динамическая таблица с вложенными заголовками, объединением ячеек (rowspan / colspan), кастомизацией через слоты, подсветкой строк и столбцов при наведении, изменением ширины колонок и фиксацией крайних колонок при горизонтальном скролле.
Колонки описываются дочерним компонентом SwTableColumn.
Свойства SwTable / SwTable Properties
| Имя | Тип | По умолчанию | Значения/Описание |
|---|---|---|---|
data | Array | required | Данные таблицы — массив объектов. |
resizable | Boolean | true | Разрешить изменение ширины колонок перетаскиванием края заголовка. |
maxWidth | String | Number | — | Максимальная ширина контейнера таблицы. При переполнении — горизонтальный скролл и активация fixed-колонок. |
События SwTable / SwTable Events
| Имя | Параметрыd | Описание |
|---|---|---|
column-resize | { prop, width } | Срабатывает после изменения ширины колонки (в px). |
Свойства SwTableColumn / SwTableColumn Properties
| Имя | Тип | По умолчанию | Значения / Описание |
|---|---|---|---|
prop | String | — | Ключ поля в объекте строки. Поддерживает вложенные пути: speed.midl. |
label | String | '' | Заголовок колонки. |
width | String | Number | 'auto' | Ширина колонки, например 180 или '180px'. |
height | String | Number | 'auto' | Минимальная высота ячейки заголовка. |
resizable | Boolean | — | Разрешить ресайз конкретной колонки. По умолчанию наследует resizable таблицы. |
minWidth | String | Number | 48 | Минимальная ширина при ресайзе (px). |
fixed | String | — | '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>