Dev Project Grid
Карточки проектов в виде клавиш (чернильный контур и жёсткая тень, которая «нажимается» при наведении): номер, категория, стек, статус и звёзды, плюс фильтры по категориям.
projectsgridfilterportfolio
Использование
Скопируйте и вставьте этот код в ваш React-компонент:
tsx
import { DevProjectGrid } from 'react-component-kit-ui/sections';
<DevProjectGrid projects={[{ title: 'Orbit UI', tagline: 'Accessible React kit', category: 'Frontend', href: '/projects/orbit-ui/', status: 'Live' }]} />Ручная установка
Если вы не используете пакет npm, создайте файл и вставьте следующий код: src/components/sections/DevProjectGrid.tsx + DevProjectGrid.css:
DevProjectGrid.tsx
'use client';
import { useEffect, useRef } from 'react';
import './DevProjectGrid.css';
/** class:list → className */
function cx(...args: unknown[]): string {
const out: string[] = [];
const walk = (v: unknown) => {
if (!v) return;
if (typeof v === 'string' || typeof v === 'number') out.push(String(v));
else if (Array.isArray(v)) v.forEach(walk);
else if (typeof v === 'object') for (const [k, on] of Object.entries(v as Record<string, unknown>)) if (on) out.push(k);
};
args.forEach(walk);
return out.join(' ');
}
interface Project {
title: string;
tagline: string;
category: string;
href: string;
technologies?: string[];
status?: string;
year?: string;
stars?: number;
}
/**
* DevProjectGrid — Project index for developer portfolios ("Keycap" design): keycap-like cards
* (ink outline, hard offset shadow that "presses" on hover) with number, category, title, tagline,
* stack chips, status and stars, plus category filter keys.
*
* @param {Array<{title: string, tagline: string, category: string, href: string, technologies?: string[], status?: string, year?: string, stars?: number}>} projects - Projects.
* @param {boolean} filters - Show category filter keys. Default true.
* @param {string} allLabel - "All" filter label. Default 'All'.
* @param {string} emptyLabel - Shown when a filter has no results. Default 'No projects in this category yet.'
* @param {string} className - Extra class.
*
* Accessibility: filters are toggle buttons (aria-pressed) and the result count is announced in a
* polite live region; each card is one link with the title as its name.
*/
export interface DevProjectGridProps {
projects?: Project[];
filters?: boolean;
allLabel?: string;
emptyLabel?: string;
className?: string;
}
export function DevProjectGrid({ projects = [
{ title: 'Orbit UI', tagline: 'Accessible component kit for React', category: 'Frontend', href: '#', technologies: ['React', 'TypeScript', 'CSS'], status: 'Live', year: '2026', stars: 1240 },
{ title: 'Tidy', tagline: 'Reclaims disk space from dev caches', category: 'Tools', href: '#', technologies: ['Rust', 'CLI'], status: 'Live', year: '2025', stars: 486 },
{ title: 'Relay', tagline: 'Declarative API mocks in minutes', category: 'Backend', href: '#', technologies: ['Node.js', 'OpenAPI'], status: 'In progress', year: '2026', stars: 57 },
], filters = true, allLabel = 'All', emptyLabel = 'No projects in this category yet.', className = '' }: DevProjectGridProps) {
const categories = [...new Set(projects.map((p) => p.category))];
const pad = (n: number) => String(n).padStart(2, '0');
// Client-side behaviour: runs once after mount.
const mounted = useRef(false);
useEffect(() => {
if (mounted.current) return;
mounted.current = true;
document.querySelectorAll<HTMLElement>('[data-dev-grid]:not([data-bound])').forEach((root) => {
root.dataset.bound = '';
const buttons = Array.from(root.querySelectorAll<HTMLButtonElement>('[data-filter]'));
const items = Array.from(root.querySelectorAll<HTMLElement>('li[data-category]'));
const live = root.querySelector<HTMLElement>('[data-live]');
const empty = root.querySelector<HTMLElement>('[data-empty]');
buttons.forEach((btn) =>
btn.addEventListener('click', () => {
const f = btn.dataset.filter ?? '';
buttons.forEach((b) => b.setAttribute('aria-pressed', String(b === btn)));
let shown = 0;
items.forEach((li) => {
const on = !f || li.dataset.category === f;
li.hidden = !on;
if (on) shown++;
});
if (empty) empty.hidden = shown > 0;
if (live) live.textContent = `${shown} ${shown === 1 ? 'project' : 'projects'}`;
}),
);
});
// eslint-disable-next-line react-hooks/exhaustive-deps
}, []);
return (
<>
<section className={cx(['dvpg', className])} data-dev-grid data-rk-31046f="">
<div className="dvpg__wrap" data-rk-31046f="">
{filters && categories.length > 1 && (
<div className="dvpg__filters" role="group" aria-label="Filter projects" data-rk-31046f="">
<button type="button" className="dvpg__filter" aria-pressed="true" data-filter="" data-rk-31046f="">{allLabel} <span data-rk-31046f="">{projects.length}</span></button>
{categories.map((c, __i: number) => (
<button key={__i} type="button" className="dvpg__filter" aria-pressed="false" data-filter={c} data-rk-31046f="">{c} <span data-rk-31046f="">{projects.filter((p) => p.category === c).length}</span></button>
))}
</div>
)}
<p className="dvpg__live" aria-live="polite" data-live data-rk-31046f=""></p>
<ul className="dvpg__grid" data-rk-31046f="">
{projects.map((p, i) => (
<li key={i} data-category={p.category} data-rk-31046f="">
<a className="dvpg__card" href={p.href} data-rk-31046f="">
<span className="dvpg__top" data-rk-31046f="">
<span className="dvpg__num" data-rk-31046f="">{pad(i + 1)}</span>
<span className="dvpg__cat" data-rk-31046f="">{p.category}</span>
{p.year && <span className="dvpg__year" data-rk-31046f="">{p.year}</span>}
</span>
<span className="dvpg__title" data-rk-31046f="">{p.title}</span>
<span className="dvpg__tagline" data-rk-31046f="">{p.tagline}</span>
{p.technologies && p.technologies.length > 0 && (
<span className="dvpg__chips" data-rk-31046f="">{p.technologies.slice(0, 4).map((t, __i: number) => <span key={__i} data-rk-31046f="">{t}</span>)}</span>
)}
<span className="dvpg__foot" data-rk-31046f="">
{p.status && <span className="dvpg__status" data-status={p.status.toLowerCase().replace(/\s+/g, '-')} data-rk-31046f=""><i aria-hidden="true" data-rk-31046f=""></i>{p.status}</span>}
{!!p.stars && <span className="dvpg__stars" data-rk-31046f="">★ {p.stars.toLocaleString('en')}</span>}
<span className="dvpg__arrow" aria-hidden="true" data-rk-31046f="">↗</span>
</span>
</a>
</li>
))}
</ul>
<p className="dvpg__empty" data-empty hidden data-rk-31046f="">{emptyLabel}</p>
</div>
</section>
</>
);
}
export default DevProjectGrid;DevProjectGrid.css
.dvpg:where([data-rk-31046f]) { padding: 0 0 clamp(3rem, 7vw, 5rem); color: var(--c-text-1); }
.dvpg__wrap:where([data-rk-31046f]) { max-width: 1040px; margin: 0 auto; padding: 0 clamp(1rem, 3vw, 1.5rem); }
.dvpg__filters:where([data-rk-31046f]) { display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 1.75rem; }
.dvpg__filter:where([data-rk-31046f]) {
display: inline-flex;
align-items: center;
gap: 0.5rem;
min-height: 40px;
padding: 0 0.9rem;
border: 1.5px solid var(--c-text-1);
border-radius: 3px;
background: var(--c-bg);
color: var(--c-text-1);
font-family: var(--font-mono);
font-size: 0.74rem;
font-weight: 600;
box-shadow: 0 3px 0 var(--c-text-1);
cursor: pointer;
transition: transform 0.18s cubic-bezier(0.22, 1, 0.36, 1), box-shadow 0.18s ease, background 0.2s ease, color 0.2s ease;
}
.dvpg__filter:where([data-rk-31046f]) span:where([data-rk-31046f]) { opacity: 0.5; }
.dvpg__filter:hover:where([data-rk-31046f]) { transform: translateY(1px); box-shadow: 0 2px 0 var(--c-text-1); }
.dvpg__filter[aria-pressed='true']:where([data-rk-31046f]) { background: var(--c-text-1); color: var(--c-bg); transform: translateY(3px); box-shadow: none; }
.dvpg__live:where([data-rk-31046f]) { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); }
.dvpg__grid:where([data-rk-31046f]) { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 1.25rem; margin: 0; padding: 0; list-style: none; }
.dvpg__grid:where([data-rk-31046f]) li[hidden]:where([data-rk-31046f]) { display: none; }
.dvpg__card:where([data-rk-31046f]) {
position: relative;
display: flex;
flex-direction: column;
gap: 0.6rem;
height: 100%;
padding: 1.4rem;
border: 1.5px solid var(--c-text-1);
border-radius: 4px;
background: var(--c-bg);
color: var(--c-text-1);
text-decoration: none;
box-shadow: 4px 4px 0 var(--c-text-1);
transition: transform 0.18s cubic-bezier(0.22, 1, 0.36, 1), box-shadow 0.18s cubic-bezier(0.22, 1, 0.36, 1);
}
.dvpg__card:hover:where([data-rk-31046f]) { transform: translate(2px, 2px); box-shadow: 2px 2px 0 var(--c-text-1); }
.dvpg__card:active:where([data-rk-31046f]) { transform: translate(4px, 4px); box-shadow: 0 0 0 var(--c-text-1); }
.dvpg__card:focus-visible:where([data-rk-31046f]) { outline: 2px solid var(--c-text-1); outline-offset: 4px; }
.dvpg__top:where([data-rk-31046f]) { display: flex; align-items: center; gap: 0.6rem; font-family: var(--font-mono); font-size: 0.7rem; color: var(--c-text-3); text-transform: uppercase; letter-spacing: 0.04em; }
.dvpg__num:where([data-rk-31046f]) { padding: 0.1rem 0.4rem; border-radius: 2px; background: var(--c-text-1); color: var(--c-bg); font-weight: 700; }
.dvpg__year:where([data-rk-31046f]) { margin-left: auto; }
.dvpg__title:where([data-rk-31046f]) { margin-top: 0.4rem; font-size: 1.45rem; font-weight: 800; letter-spacing: -0.02em; line-height: 1.15; }
.dvpg__tagline:where([data-rk-31046f]) { font-size: 0.9rem; line-height: 1.55; color: var(--c-text-2); }
.dvpg__chips:where([data-rk-31046f]) { display: flex; flex-wrap: wrap; gap: 0.35rem; margin-top: 0.2rem; }
.dvpg__chips:where([data-rk-31046f]) span:where([data-rk-31046f]) { padding: 0.2rem 0.5rem; border: 1px solid rgb(var(--ink-rgb, 0 0 0) / 0.2); border-radius: 2px; font-family: var(--font-mono); font-size: 0.66rem; }
.dvpg__foot:where([data-rk-31046f]) { display: flex; align-items: center; gap: 0.75rem; margin-top: auto; padding-top: 0.8rem; border-top: 1px dashed rgb(var(--ink-rgb, 0 0 0) / 0.15); font-family: var(--font-mono); font-size: 0.7rem; color: var(--c-text-2); }
.dvpg__status:where([data-rk-31046f]) { display: inline-flex; align-items: center; gap: 0.4rem; }
.dvpg__status:where([data-rk-31046f]) i:where([data-rk-31046f]) { width: 7px; height: 7px; border-radius: 50%; background: var(--c-text-3); }
.dvpg__status[data-status='live']:where([data-rk-31046f]) i:where([data-rk-31046f]) { background: var(--c-success, #10b981); box-shadow: 0 0 6px var(--c-success, #10b981); }
.dvpg__status[data-status='in-progress']:where([data-rk-31046f]) i:where([data-rk-31046f]) { background: var(--c-warning, #f59e0b); }
.dvpg__arrow:where([data-rk-31046f]) { margin-left: auto; font-size: 1rem; color: var(--c-text-1); transition: transform 0.2s ease; }
.dvpg__card:hover:where([data-rk-31046f]) .dvpg__arrow:where([data-rk-31046f]) { transform: translate(2px, -2px); }
.dvpg__empty:where([data-rk-31046f]) { margin: 2rem 0 0; font-family: var(--font-mono); font-size: 0.85rem; color: var(--c-text-3); }
@media (prefers-reduced-motion: reduce) { .dvpg__card:where([data-rk-31046f]), .dvpg__filter:where([data-rk-31046f]), .dvpg__arrow:where([data-rk-31046f]) { transition: none; } }