by app-grid-factory.js with the same column
count as the final grid. Because it uses the same wrapper/table base
classes, the transition to real data is layout-stable (no jump).
- Initial load: skeleton sibling replaces the empty Grid.js container
(container is aria-busy while loading).
- Re-fetch (gridjs-is-updating after first load): a thin top progress
bar + muted tbody signals activity without destroying context.
- prefers-reduced-motion: shimmer disabled, static muted bars only.
------------------------------------------------------------------- */
.app-grid-shell {
position: relative;
}
/* Hide Grid.js' built-in loading bar — we own loading UX now. */
.gridjs-loading-bar {
display: none;
}
/* While the skeleton is active, hide everything in the shell except the
skeleton itself. Grid.js mounts its own ``
INSIDE the user's container element (which has no class of its own), so
targeting `.gridjs-container` directly misses the mount wrapper. Using
`:not(.app-grid-skeleton)` catches whatever DOM structure the caller
provided as the mount point. `display: none` does not prevent Grid.js
from constructing DOM or starting its fetch — only paint. */
.app-grid-shell-loading > :not(.app-grid-skeleton) {
display: none !important;
}
.app-grid-skeleton {
/* Skeleton root mirrors the real grid's outer layout: a bordered card
wraps the table, and the footer (summary + pagination) sits outside
the card — identical to how `.gridjs-wrapper` + `.gridjs-footer` are
arranged. This keeps page-level layout stable across the transition. */
display: block;
}
.app-grid-skeleton-table {
border: var(--app-border-width) solid var(--app-table-border-color);
border-radius: calc(var(--app-border-radius) * 1.4);
background-color: var(--app-background-color);
overflow: hidden;
}
.app-grid-skeleton-sr {
position: absolute;
width: 1px;
height: 1px;
margin: -1px;
padding: 0;
border: 0;
overflow: hidden;
clip: rect(0 0 0 0);
white-space: nowrap;
}
.app-grid-skeleton-table {
width: 100%;
border-collapse: collapse;
table-layout: auto;
}
.app-grid-skeleton-cell {
padding: var(--app-grid-cell-pad-y, 0.6rem) var(--app-grid-cell-pad-x, 0.9rem);
border-bottom: var(--app-border-width) solid var(--app-table-border-color);
vertical-align: middle;
text-align: left;
}
.app-grid-skeleton-cell-head {
background-color: color-mix(
in srgb,
var(--app-background-color) 94%,
var(--app-muted-border-color)
);
}
.app-grid-skeleton-row:last-child .app-grid-skeleton-cell {
border-bottom: 0;
}
.app-grid-skeleton-bar {
display: block;
height: 0.7rem;
border-radius: 999px;
/* Base track + travelling highlight; the highlight is what animates. */
background-color: color-mix(
in srgb,
var(--app-muted-border-color) 55%,
transparent
);
background-image: linear-gradient(
90deg,
transparent 0%,
color-mix(in srgb, var(--app-primary-focus) 55%, transparent) 50%,
transparent 100%
);
background-size: 180px 100%;
background-repeat: no-repeat;
background-position: -180px 0;
animation: app-grid-skeleton-shimmer 1.4s linear infinite;
}
.app-grid-skeleton-cell-head .app-grid-skeleton-bar {
height: 0.55rem;
background-color: color-mix(
in srgb,
var(--app-muted-border-color) 70%,
transparent
);
}
/* Footer skeleton — visually matches the real `.gridjs-pagination`:
summary (results count) left-aligned, pager buttons right-aligned. */
.app-grid-skeleton-footer {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 0.65rem;
padding: 0.85rem 0 0;
}
.app-grid-skeleton-summary {
flex: 0 0 auto;
width: clamp(120px, 18%, 200px);
}
.app-grid-skeleton-summary .app-grid-skeleton-bar {
height: 0.55rem;
}
.app-grid-skeleton-pager {
margin-inline-start: auto;
display: inline-flex;
align-items: center;
gap: 0.35rem;
}
.app-grid-skeleton-pager-button {
display: inline-block;
min-width: 2rem;
height: 1.75rem;
border-radius: calc(var(--app-border-radius) * 0.9);
background-color: color-mix(
in srgb,
var(--app-muted-border-color) 55%,
transparent
);
background-image: linear-gradient(
90deg,
transparent 0%,
color-mix(in srgb, var(--app-primary-focus) 55%, transparent) 50%,
transparent 100%
);
background-size: 120px 100%;
background-repeat: no-repeat;
background-position: -120px 0;
animation: app-grid-skeleton-shimmer 1.4s linear infinite;
}
@media (max-width: 768px) {
.app-grid-skeleton-footer {
align-items: stretch;
}
.app-grid-skeleton-pager {
margin-inline-start: 0;
flex-wrap: wrap;
}
}
@media (prefers-reduced-motion: reduce) {
.app-grid-skeleton-pager-button {
animation: none;
background-image: none;
}
}
/* Re-fetch feedback: thin top progress bar + faded tbody so users see
activity without losing the current data context (GitHub pattern). */
.gridjs-container.gridjs-is-updating.gridjs-has-loaded .gridjs-wrapper {
position: relative;
}
.gridjs-container.gridjs-is-updating.gridjs-has-loaded .gridjs-wrapper::before {
content: "";
position: absolute;
inset: 0 0 auto 0;
height: 2px;
background: linear-gradient(
90deg,
transparent,
var(--app-primary),
transparent
);
background-size: 40% 100%;
background-repeat: no-repeat;
animation: app-grid-progress-slide 1.1s ease-in-out infinite;
z-index: 4;
}
.gridjs-container.gridjs-is-updating.gridjs-has-loaded .gridjs-tbody {
opacity: 0.55;
transition: opacity 0.15s ease;
}
@media (prefers-reduced-motion: reduce) {
.app-grid-skeleton-bar,
.gridjs-container.gridjs-is-updating.gridjs-has-loaded .gridjs-wrapper::before {
animation: none;
}
.app-grid-skeleton-bar {
background-image: none;
}
}
.gridjs-message {
padding: 1rem;
color: var(--app-muted-color);
}
.gridjs-message.gridjs-error {
color: var(--app-color);
border: var(--app-border-width) solid color-mix(in srgb, var(--app-danger, #b44545) 25%, transparent);
border-radius: calc(var(--app-border-radius) * 1.1);
background: color-mix(in srgb, var(--app-danger, #b44545) 8%, var(--app-background-color));
}
.gridjs-message.gridjs-error .app-grid-error-actions {
margin-top: 0.6rem;
}
.gridjs-message.gridjs-error .app-grid-retry {
padding: 4px 10px;
font-size: 12px;
line-height: 1.2;
}
.gridjs-message.gridjs-notfound {
color: var(--app-muted-color);
background: color-mix(in srgb, var(--app-muted-border-color) 18%, transparent);
border-radius: calc(var(--app-border-radius) * 1.1);
}
.gridjs-container.gridjs-is-updating .gridjs-message.gridjs-notfound {
display: none;
}
.grid-avatar {
--grid-avatar-width: 36px;
--grid-avatar-height: 36px;
--grid-avatar-radius: 999px;
--grid-avatar-fit: cover;
--grid-avatar-padding: 0;
width: var(--grid-avatar-width);
height: var(--grid-avatar-height);
border-radius: var(--grid-avatar-radius);
border: 1px solid var(--app-muted-border-color);
background: var(--app-card-background-color);
object-fit: var(--grid-avatar-fit);
padding: var(--grid-avatar-padding);
display: inline-flex;
flex-shrink: 0;
box-sizing: border-box;
}
.grid-avatar-tenant {
--grid-avatar-width: 48px;
--grid-avatar-height: 28px;
--grid-avatar-radius: var(--app-border-radius);
--grid-avatar-fit: contain;
--grid-avatar-padding: 2px;
}
.grid-avatar-placeholder {
align-items: center;
justify-content: center;
font-weight: 600;
color: var(--app-muted-color);
font-size: 11px;
background: var(--app-background-color);
}
.grid-avatar-tenant.grid-avatar-placeholder {
font-size: 10px;
}
.grid-name-cell {
display: inline-flex;
align-items: center;
gap: 0.5rem;
min-width: 0;
}
.grid-name-cell > a:first-child,
.grid-name-cell > span:first-child {
display: inline-flex;
flex-shrink: 0;
}
.grid-name-cell > :last-child {
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
}
.grid-tenant-profile {
display: inline-flex;
align-items: center;
gap: 0.75rem;
min-width: 0;
}
.grid-tenant-profile-name-text {
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
font-weight: 500;
}
/* Compound user cell: avatar + name (strong) + email subtitle (small, muted). */
.grid-user-profile {
display: inline-flex;
align-items: center;
gap: 0.75rem;
min-width: 0;
}
.grid-user-profile-text {
display: inline-flex;
flex-direction: column;
min-width: 0;
line-height: var(--leading-tight);
}
.grid-user-profile-text strong {
font-weight: var(--font-medium);
color: var(--app-color);
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.grid-user-profile-text small {
font-size: var(--text-xs);
color: var(--app-muted-color);
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
a.grid-user-profile.app-grid-link-cell:hover .grid-user-profile-text strong {
color: var(--app-primary);
text-decoration: underline;
}
.gridjs-container .grid-actions {
display: inline-flex;
align-items: center;
gap: 0.35rem;
white-space: nowrap;
}
.app-grid-link-cell {
color: inherit;
text-decoration: none;
}
.app-grid-link-cell:hover {
text-decoration: underline;
color: var(--app-primary);
}
.app-grid-link-cell:focus-visible {
outline: 2px solid var(--app-primary-focus);
outline-offset: 2px;
border-radius: 2px;
}
.gridjs-table input[data-grid-select-all] {
margin: 0;
}
.gridjs-td .badge,
.gridjs-td .grid-name-cell,
.gridjs-td .grid-tenant-profile,
.gridjs-td .grid-user-profile,
.gridjs-td .app-inline-actions {
white-space: nowrap;
}
.gridjs-td .badge-list {
align-items: center;
white-space: nowrap;
}
/* Reset button margin inside grid cells (Pico/framework default adds margin-bottom) */
td.gridjs-td button,
td.gridjs-td [role="button"] {
margin: 0;
}
/* Inline action buttons side by side in a cell */
td.gridjs-td .app-inline-actions {
display: inline-flex;
gap: 0.35rem;
align-items: center;
}
html[data-theme="dark"] button.gridjs-sort,
html[data-theme="dark"] button.gridjs-sort-neutral {
filter: invert(1);
}
button.gridjs-sort {
background-color: transparent;
background-position-x: center;
background-repeat: no-repeat;
background-size: contain;
border: none;
cursor: pointer;
float: right;
height: 24px;
margin: 0;
outline: none;
padding: 0;
width: 13px;
}
@media (max-width: 768px) {
.gridjs-wrapper {
border-radius: var(--app-border-radius);
}
.gridjs-pagination {
align-items: stretch;
}
.gridjs-pagination .gridjs-pages {
max-width: 100%;
flex-wrap: wrap;
margin-inline-start: 0;
}
}
@keyframes app-grid-skeleton-shimmer {
0% {
background-position: -180px 0;
}
100% {
background-position: calc(100% + 180px) 0;
}
}
@keyframes app-grid-progress-slide {
0% {
background-position: -40% 0;
}
100% {
background-position: 140% 0;
}
}
}