# `Cinder.Table`
[🔗](https://github.com/sevenseacat/cinder/blob/v0.12.1/lib/cinder/table.ex#L1)

Table component for displaying data in a traditional HTML table layout.

**DEPRECATED:** Use `Cinder.collection` instead. This module will be removed in version 1.0.

```heex
<!-- Use this instead -->
<Cinder.collection resource={MyApp.User} actor={@current_user}>
  <:col :let={user} field="name" filter sort>{user.name}</:col>
</Cinder.collection>
```

See the [Upgrading Guide](upgrading.html) for migration instructions.

## Basic Usage

```heex
<Cinder.Table.table resource={MyApp.User} actor={@current_user}>
  <:col :let={user} field="name" filter sort>{user.name}</:col>
  <:col :let={user} field="email" filter>{user.email}</:col>
  <:col :let={user} field="created_at" sort>{user.created_at}</:col>
</Cinder.Table.table>
```

## With Query

```heex
<Cinder.Table.table query={MyApp.User |> Ash.Query.filter(active: true)} actor={@current_user}>
  <:col :let={user} field="name" filter sort>{user.name}</:col>
  <:col :let={user} field="email" filter>{user.email}</:col>
</Cinder.Table.table>
```

## See Also

- `Cinder.collection/1` - Unified collection component supporting table, list, and grid layouts
- `Cinder.Collection` - Full documentation for all collection features

# `build_query_columns`

Builds the list of columns used for query operations (filtering AND searching).
Delegates to `Cinder.Collection.build_query_columns/2`.

# `process_columns`

Process column definitions into the format expected by the underlying component.
Delegates to `Cinder.Collection.process_columns/2`.

# `process_filter_slots`

Process filter-only slot definitions.
Delegates to `Cinder.Collection.process_filter_slots/2`.

# `process_search_config`

Process unified search configuration into individual components.
Delegates to `Cinder.Collection.process_search_config/2`.

# `table`

> This function is deprecated. Use Cinder.collection instead.

Renders a data table.

**DEPRECATED:** Use `Cinder.collection` instead.

This is equivalent to calling `Cinder.collection` with `layout={:table}`.

## Attributes

* `resource` (`:atom`) - The Ash resource to query. Defaults to `nil`.
* `query` (`:any`) - The Ash query to execute. Defaults to `nil`.
* `actor` (`:any`) - Actor for authorization. Defaults to `nil`.
* `tenant` (`:any`) - Tenant for multi-tenant resources. Defaults to `nil`.
* `scope` (`:any`) - Ash scope containing actor and tenant. Defaults to `nil`.
* `id` (`:string`) - Unique identifier for the table. Defaults to `"cinder-table"`.
* `page_size` (`:any`) - Number of items per page. Defaults to `25`.
* `theme` (`:any`) - Theme name or theme map. Defaults to `"default"`.
* `url_state` (`:any`) - URL state object from UrlSync.handle_params. Defaults to `false`.
* `query_opts` (`:list`) - Additional Ash query options. Defaults to `[]`.
* `on_state_change` (`:any`) - Custom state change handler. Defaults to `nil`.
* `show_pagination` (`:boolean`) - Whether to show pagination controls. Defaults to `true`.
* `show_filters` (`:boolean`) - Whether to show filter controls. Defaults to `nil`.
* `loading_message` (`:string`) - Message to show while loading. Defaults to `"Loading..."`.
* `filters_label` (`:string`) - Label for the filters component. Defaults to `"Filters"`.
* `search` (`:any`) - Search configuration. Defaults to `nil`.
* `empty_message` (`:string`) - Message when no results. Defaults to `"No results found"`.
* `error_message` (`:string`) - Message to show on error. Defaults to `nil`.
* `class` (`:string`) - Additional CSS classes. Defaults to `""`.
* `row_click` (`:any`) - Function to call when a row is clicked. Defaults to `nil`.
## Slots

* `col` - Accepts attributes:

  * `field` (`:string`)
  * `filter` (`:any`)
  * `filter_options` (`:list`)
  * `sort` (`:any`)
  * `search` (`:boolean`)
  * `label` (`:string`)
  * `class` (`:string`)
* `filter` - Accepts attributes:

  * `field` (`:string`)
  * `filter` (`:any`)
  * `label` (`:string`)
* `loading` - Custom loading state content.
* `empty` - Custom empty state content.
* `error` - Custom error state content.

---

*Consult [api-reference.md](api-reference.md) for complete listing*