نصائح للمطورين حول التصميم المتجاوب والأداء

<!-- ❌ سيء: المتصفح لا يعرف الحجم حتى تحميل الصورة -->
<img src="hero.jpg" alt="صورة رئيسية">

<!-- ✅ جيد: المساحة محجوزة فوراً -->
<img src="hero.jpg"
     alt="صورة رئيسية"
     width="1200"
     height="630"
     loading="lazy">

<h1>عنوان الصفحة (واحد لكل صفحة)</h1>
  <h2>القسم الرئيسي</h2>
    <h3>القسم الفرعي</h3>
    <h3>قسم فرعي آخر</h3>
  <h2>قسم رئيسي آخر</h2>

<!-- ❌ غير آمن -->
<a href="https://example.com" target="_blank">زيارة</a>

<!-- ✅ آمن -->
<a href="https://example.com"
   target="_blank"
   rel="noopener noreferrer">زيارة</a>

<input type="text"    autocomplete="given-name">
<input type="email"   autocomplete="email">
<input type="tel"     autocomplete="tel">
<input type="password" autocomplete="current-password">
<input type="text"    autocomplete="postal-code">

<meta property="og:title"       content="عنوان الصفحة">
<meta property="og:description"  content="وصف قصير">
<meta property="og:image"       content="https://yourdomain.com/og.jpg">
<meta property="og:url"         content="https://yourdomain.com/page">
<meta property="og:type"        content="website">
<!-- تويتر/إكس -->
<meta name="twitter:card"      content="summary_large_image">

.center-everything {
  display: grid;
  place-items: center;
}

/* يعمل لتوسيط الصفحة بالكامل أيضاً */
body {
  display: grid;
  place-items: center;
  min-height: 100vh;
}

:root {
  --color-primary: #6366f1;
  --color-bg: #ffffff;
  --radius-md: 12px;
  --spacing-md: 16px;
}

@media (prefers-color-scheme: dark) {
  :root {
    --color-bg: #0d1117;
  }
}

.btn {
  background: var(--color-primary);
  border-radius: var(--radius-md);
  padding: var(--spacing-md);
}

/* clamp(الحد الأدنى, المفضل, الحد الأقصى) */
h1 {
  font-size: clamp(1.8rem, 5vw, 3.5rem);
}

p {
  font-size: clamp(0.9rem, 2vw, 1.1rem);
  line-height: 1.7;
  max-width: 65ch; /* عرض القراءة الأمثل */
}

@media (prefers-reduced-motion: no-preference) {
  html {
    scroll-behavior: smooth;
  }
}

/* تعويض للترويسة الثابتة (مثلاً بارتفاع 70px) */
[id] {
  scroll-margin-top: 90px;
}

.card-grid {
  display: grid;
  grid-template-columns: repeat(
    auto-fill,
    minmax(280px, 1fr)
  );
  gap: 24px;
}
/* عمود واحد على الجوال → 2 → 3 → 4 تلقائياً */

/* ❌ لا تفعل هذا أبداً */
* { outline: none; }

/* ✅ أخفِ للفأرة، أظهر للوحة المفاتيح */
:focus:not(:focus-visible) {
  outline: none;
}
:focus-visible {
  outline: 2px solid #6366f1;
  outline-offset: 3px;
  border-radius: 4px;
}

const observer = new IntersectionObserver(
  (entries) => {
    entries.forEach(entry => {
      if (entry.isIntersecting) {
        entry.target.classList.add('visible');
        observer.unobserve(entry.target); // توقف عن المراقبة
      }
    });
  },
  { rootMargin: '0px 0px -50px 0px' }
);

document.querySelectorAll('.animate-on-scroll')
  .forEach(el => observer.observe(el));

function debounce(fn, delay = 300) {
  let timer;
  return (...args) => {
    clearTimeout(timer);
    timer = setTimeout(() => fn(...args), delay);
  };
}

// الاستخدام
window.addEventListener('resize',
  debounce(() => {
    recalculateLayout();
  }, 200)
);

async function copyToClipboard(text) {
  try {
    await navigator.clipboard.writeText(text);
    showToast('تم النسخ!');
  } catch (err) {
    console.error('فشل النسخ:', err);
  }
}

// الاستخدام
document.querySelector('.copy-btn')
  .addEventListener('click', () =>
    copyToClipboard('النص المراد نسخه')
  );

const storage = {
  get(key, fallback = null) {
    try {
      const item = localStorage.getItem(key);
      return item ? JSON.parse(item) : fallback;
    } catch { return fallback; }
  },
  set(key, value) {
    try {
      localStorage.setItem(key, JSON.stringify(value));
      return true;
    } catch { return false; }
  }
};

storage.set('theme', 'dark');
const theme = storage.get('theme', 'light');

const prefersReduced = window
  .matchMedia('(prefers-reduced-motion: reduce)')
  .matches;

if (!prefersReduced) {
  startAnimations();
} else {
  showStaticFallback();
}

<!-- الخطوة 1: preconnect -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>

<!-- الخطوة 2: أضف &display=swap إلى الرابط -->
<link href="https://fonts.googleapis.com/css2?family=Poppins:wght@400;700&family=Cairo:wght@700;900&display=swap"
      rel="stylesheet">

<picture>
  <source srcset="hero.avif" type="image/avif">
  <source srcset="hero.webp" type="image/webp">
  <img src="hero.jpg"
       alt="صورة رئيسية"
       width="1200" height="630"
       loading="lazy">
</picture>

<!-- يحظر العرض ❌ -->
<script src="app.js"></script>

<!-- يعمل بالترتيب، بعد DOM ✅ (استخدم لمعظم البرامج النصية) -->
<script src="app.js" defer></script>

<!-- يعمل فوراً عندما يكون جاهزاً ✅ (التحليلات، الإعلانات) -->
<script src="analytics.js" async></script>

/* ❌ يثير التخطيط (مكلف) */
.bad { transition: width 0.3s, top 0.3s; }

/* ✅ مركب على GPU (رخيص) */
.good { transition: transform 0.3s, opacity 0.3s; }

/* استخدم باعتدال، فقط قبل التحريكات المعقدة */
.modal-enter { will-change: transform; }
.modal-entered { will-change: auto; } /* أعد التعيين بعد */

<!-- تحميل مسبق للصورة الرئيسية (عنصر LCP) -->
<link rel="preload" as="image"
      href="hero.webp" fetchpriority="high">

<!-- تحميل مسبق للخط الحرج -->
<link rel="preload" as="font"
      href="font.woff2" type="font/woff2"
      crossorigin>

<!-- ❌ قارئ الشاشة يقول "زر" -->
<button><i class="fa-solid fa-times"></i></button>

<!-- ✅ قارئ الشاشة يقول "إغلاق الحوار" -->
<button aria-label="إغلاق الحوار">
  <i class="fa-solid fa-times" aria-hidden="true"></i>
</button>

<!-- الإنجليزية -->
<html lang="en">

<!-- العربية (RTL) -->
<html lang="ar" dir="rtl">

<!-- الفرنسية -->
<html lang="fr">

/* ❌ #6b7280 على #fff = 4.48:1 (يفشل AA للنص الصغير) */
.muted { color: #6b7280; background: #fff; }

/* ✅ #4b5563 على #fff = 7.0:1 (يجتاز AA و AAA) */
.muted { color: #4b5563; background: #fff; }

.sr-only {
  position: absolute;
  width: 1px; height: 1px;
  padding: 0; margin: -1px;
  overflow: hidden;
  clip: rect(0,0,0,0);
  white-space: nowrap;
  border: 0;
}

<!-- مثال رابط التخطي -->
<a href="#main" class="sr-only">تخطي إلى المحتوى</a>

function trapFocus(modal) {
  const focusable = modal.querySelectorAll(
    'a, button, input, select, textarea, [tabindex]:not([tabindex="-1"])'
  );
  const first = focusable[0];
  const last = focusable[focusable.length - 1];

  modal.addEventListener('keydown', e => {
    if (e.key !== 'Tab') return;
    if (e.shiftKey ? document.activeElement === first
                   : document.activeElement === last) {
      e.preventDefault();
      (e.shiftKey ? last : first).focus();
    }
  });
  first.focus();
}

<!-- ❌ يعطل تكبير المستخدم (انتهاك لسهولة الوصول) -->
<meta name="viewport"
      content="width=device-width, initial-scale=1, user-scalable=no">

<!-- ✅ صحيح: يسمح بالتكبير حتى 5× -->
<meta name="viewport"
      content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=5">

/* توسيع منطقة اللمس دون تغيير مرئي */
.icon-btn {
  position: relative;
  width: 24px; height: 24px;
}
.icon-btn::before {
  content: '';
  position: absolute;
  top: 50%; left: 50%;
  transform: translate(-50%, -50%);
  min-width: 44px; min-height: 44px;
}

/* فيزيائي (لا ينعكس لـ RTL) */
.icon { margin-right: 8px; }

/* منطقي (ينعكس تلقائياً في RTL) */
.icon { margin-inline-end: 8px; }

/* المزيد من أمثلة الخصائص المنطقية */
.card {
  padding-inline: 16px;      /* يمين + يسار */
  padding-block: 12px;       /* أعلى + أسفل */
  border-start-start-radius: 12px; /* أعلى اليسار في LTR */
}

/* ❌ يتجاوز على الجوال عند ظهور واجهة المتصفح */
.hero { height: 100vh; }

/* ✅ مع خيار احتياطي للمتصفحات القديمة */
.hero {
  height: 100vh;          /* احتياطي */
  height: 100dvh;         /* ارتفاع إطار العرض الديناميكي */
}