القائمة
Component Architecture and Accessibility
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/tools-only/X-Skills --skill elegant-design-components-and-accessibilityيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | elegant-design-components-and-accessibility |
| description | Component Architecture and Accessibility |
Build from small to large:
interface ButtonProps {
variant?: 'primary' | 'secondary' | 'ghost' | 'destructive';
size?: 'sm' | 'md' | 'lg';
loading?: boolean;
disabled?: boolean;
children: React.ReactNode;
onClick?: () => void;
type?: 'button' | 'submit' | 'reset';
}
export () {
(
);
}
Prefer composable components:
// Good: Composable
<Card>
<CardHeader>
<CardTitle>Title</CardTitle>
</CardHeader>
<CardContent>
Content here
</CardContent>
</Card>
// Avoid: Props hell
<Card
title="Title"
content="Content"
headerActions={[...]}
footer={...}
/>
Use proper HTML elements:
// Good
<button onClick={handleClick}>Click me</button>
<nav>...</nav>
<main>...</main>
<article>...</article>
// Bad
<div onClick={handleClick}>Click me</div>
<div className="nav">...</div>
// Icon-only button
<button aria-label="Close dialog">
<X size={16} />
</button>
// Form field with description
<div>
<label htmlFor="email">Email</label>
<input
id="email"
type="email"
aria-describedby="email-hint"
/>
<p id="email-hint">We'll never share your email</p>
</div>
// Dynamic content
<div aria-live="polite" aria-atomic="true">
{status}
</div>
All interactive elements must be keyboard accessible:
function Dialog({ open, onClose }: DialogProps) {
useEffect(() => {
if (!open) return;
const handleEscape = (e: KeyboardEvent) => {
if (e.key === 'Escape') onClose();
};
document.addEventListener('keydown', handleEscape);
return () => document.removeEventListener('keydown', handleEscape);
}, [open, onClose]);
return (
<div
role="dialog"
aria-modal="true"
tabIndex={-1}
>
{/* Dialog content */}
</div>
);
}
Focus management:
function Modal({ open }: { open: boolean }) {
const modalRef = useRef<HTMLDivElement>(null);
const previousFocus = useRef<HTMLElement | null>(null);
useEffect(() => {
if (open) {
// Save current focus
previousFocus.current = document.activeElement as HTMLElement;
// Focus modal
modalRef.current?.focus();
} else {
// Restore focus
previousFocus.current?.focus();
}
}, [open]);
return (
<div ref={modalRef} tabIndex={-1} role="dialog">
{/* Modal content */}
</div>
);
}
WCAG Requirements:
/* Good contrast */
.good-text {
background: #ffffff;
color: #222222; /* 16.1:1 */
}
/* Poor contrast - fails WCAG */
.poor-text {
background: #ffffff;
color: #999999; /* 2.8:1 */
}
Test with:
// Skip navigation
<a href="#main-content" className="skip-link">
Skip to main content
</a>
// Alternative text for images
<img src="..." alt="Descriptive text" />
// Hidden labels for icon buttons
<button>
<span className="sr-only">Delete item</span>
<Trash size={16} aria-hidden="true" />
</button>
/* Screen reader only content */
.sr-only {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border-width: 0;
}
function FormField({
label,
error,
required,
...inputProps
}: FormFieldProps) {
const id = useId();
const errorId = `${id}-error`;
return (
<div className="form-field">
<label htmlFor={id}>
{label}
{required && <span aria-label="required">*</span>}
</label>
<input
id={id}
aria-invalid={!!error}
aria-describedby={error ? errorId : undefined}
aria-required={required}
{...inputProps}
/>
{error && (
<p id={errorId} className="error" role="alert">
{error}
</p>
)}
</div>
);
}