Skip to content

Add table bleed prop - #2790

Merged
calebporzio merged 3 commits into
mainfrom
table-bleed
Sep 1, 2026
Merged

Add table bleed prop#2790
calebporzio merged 3 commits into
mainfrom
table-bleed

Conversation

@calebporzio

@calebporzio calebporzio commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

The scenario

Tables are designed to sit inside surrounding page padding, so their first and last cells intentionally remove their outer padding. Inside a card, some layouts instead need full-width dividers while preserving the card gutter for cell content.

The problem

Achieving that composition currently requires pulling the table container through the parent padding and manually restoring padding on every first and last header and body cell. The required gutter also differs between default cards, small cards, and custom containers.

The solution

This adds a boolean bleed prop to flux:table. Cards expose their size-aware horizontal gutter through an inherited --flux-bleed CSS variable, and bleeding tables use it to extend their container while restoring the same gutter on edge cells. Paginated tables keep pagination aligned to the gutter as well.

The gutter defaults to 1.5rem. Default and size="sm" cards provide their gutter automatically; custom containers can set the same variable to match their padding, for example class="p-4 [--flux-bleed:1rem]".

Related Flux Pro PR: https://github.com/livewire/flux-pro/pull/568
Docs PR: https://github.com/livewire/flux-docs/pull/210

Verification

  • composer validate --no-check-publish
  • Linked Laravel playground: npm run build; 2 tests passed
  • Flux docs: npm run build; 426 tests passed, 8 skipped
  • Browser-verified default card (24px), small card (16px), and custom p-4 container (16px): dividers reach the inner border and edge-cell content remains aligned

@calebporzio
calebporzio merged commit 2daaf94 into main Sep 1, 2026
1 check passed
@calebporzio
calebporzio deleted the table-bleed branch September 1, 2026 11:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant