يوضّح لك هذا الدرس التطبيقي حول الترميز كيفية إنشاء مكوّن تخطيط للتنقّل الجانبي المنزلق سريع الاستجابة على الويب. سننشئ المكوّن أثناء تقدّمنا، بدءًا من HTML، ثم CSS، ثم JavaScript.
يمكنك الاطّلاع على منشور المدوّنة إنشاء مكوّن Sidenav للتعرّف على ميزات منصة الويب CSS التي تم اختيارها لإنشاء هذا المكوّن.
الإعداد
- انقر على إنشاء ريمكس للتعديل لجعل المشروع قابلاً للتعديل.
- فتح "
app/index.html"
HTML
أولاً، عليك التعرّف على أساسيات إعداد HTML ليكون لديك محتوى وبعض المربّعات للعمل عليها.
أضِف رمز HTML التالي إلى علامة <body>.
<aside></aside>
<main></main>
يحتوي العنصر <aside> على قائمة التنقّل كعنصر تكميلي للعنصر <main> الذي يحتوي على محتوى الصفحة الأساسي.
بعد ذلك، سنملأ هذه العناصر الدلالية ببقية محتوى الصفحة.
أضِف عنصر تنقّل وبعض روابط التنقّل ورابط إغلاق داخل العنصر <aside>.
<aside>
<nav>
<h4>My</h4>
<a href="#">Dashboard</a>
<a href="#">Profile</a>
<a href="#">Preferences</a>
<a href="#">Archive</a>
<h4>Settings</h4>
<a href="#">Accessibility</a>
<a href="#">Theme</a>
<a href="#">Admin</a>
</nav>
<a href="#"></a>
</aside>
تتناسب الروابط بشكل رائع داخل عناصر <nav>، وتتناسب عناصر <nav> بشكل رائع في الأشرطة الجانبية لـ <aside>.
ومع ذلك، هناك المزيد الذي يمكننا القيام به للتحسين.
في عنصر المحتوى الرئيسي، أضِف عنوانًا ومقالة للاحتفاظ بمحتوى التنسيق دلاليًا.
<main>
<header>
<a href="#sidenav-open" class="hamburger">
<svg viewBox="0 0 50 40">
<line x1="0" x2="100%" y1="10%" y2="10%" />
<line x1="0" x2="100%" y1="50%" y2="50%" />
<line x1="0" x2="100%" y1="90%" y2="90%" />
</svg>
</a>
<h1>Site Title</h1>
</header>
<article>
{put some placeholder content here}
</article>
</main>
يحتوي العنوان على رابط فتح القائمة. يحتوي العنصر aside على زر الإغلاق. سنعرض العناصر ونخفيها قريبًا استنادًا إلى حجم إطار العرض.
في العنصر <article>، لصقنا جملة عنصر نائب. استبدِل `` بالمحتوى الخاص بك، أو الصِق النص الوهمي أدناه:
<h2>Totam Header</h2>
<p>Lorem ipsum dolor, sit amet consectetur adipisicing elit. Cum consectetur, necessitatibus velit officia ut impedit veritatis temporibus soluta? Totam odit cupiditate facilis nisi sunt hic necessitatibus voluptatem nihil doloribus! Enim.</p>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
<h3>Subhead Totam Odit</h3>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
<h3>Subhead</h3>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
هذا المحتوى وطوله هما ما سيجعل الصفحة قابلة للتمرير عندما يتجاوز ارتفاع إطار العرض.
حتى الآن، أضفت عنصر aside مع nav وروابط وطريقة لإغلاق شريط التنقّل الجانبي. لقد أضفت أيضًا عنوانًا وطريقة لفتح شريط التنقّل الجانبي ومقالة إلى العنصر الرئيسي. هذا الرمز نظيف ودلالي وخالد بالفعل، ولكن يمكننا جعله أكثر نظافة ووضوحًا للجميع. يمكن تمييز الرابط المفتوح في شريط التنقل الجانبي بشكل أكثر وضوحًا.
أضِف السمتَين title وaria-label إلى عنصر الرابط المفتوح في العنوان:
<a href="#sidenav-open" class="hamburger">
<a href="#sidenav-open" title="Open Menu" aria-label="Open Menu" class="hamburger">
يمكن أيضًا وضع علامة على رمز SVG المفتوح بشكل أكثر وضوحًا. أضِف السمات التالية إلى SVG داخل عنصر الرابط المفتوح:
<svg viewBox="0 0 50 40">
<svg viewBox="0 0 50 40" role="presentation" focusable="false" aria-label="trigram for heaven symbol">
يمكن وضع علامة على رابط الإغلاق في شريط التنقل الجانبي بشكل أكثر وضوحًا.
أضِف السمتَين title وaria-label إلى عنصر رابط إغلاق شريط التنقّل الجانبي:
<a href="#"></a>
<a href="#" title="Close Menu" aria-label="Close Menu"></a>
CSS
حان الوقت لتخطيط العناصر. المحتوى الرئيسي وشريط التنقّل الجانبي هما علامتان ثانويتان مباشرتان للعلامة <body>، لذا من الأفضل البدء من هناك.
أضِف CSS التالي إلى css/sidenav.css لكي يضع العنصر <body> العناصر الفرعية.
body {
display: grid;
grid: [stack] 1fr / min-content [stack] 1fr;
@media (max-width: 540px) {
& > :matches(aside, main) {
grid-area: stack;
}
}
}
يقول هذا التنسيق بشكل أساسي: أنشئ صفًا مسمّى stack يحتوي على كل شيء،
وعمودين في هذا الصف، والعمود الثاني منهما مسمّى stack أيضًا. يجب أن يكون حجم العمود الأول
وفقًا للحد الأدنى من احتياجات المحتوى، ويمكن أن يشغل العمود الثاني الباقي.
بعد ذلك، إذا كان في إطار عرض مقيد يبلغ 540px أو أقل، ضع عناصر شريط التنقل الجانبي والمحتوى الرئيسي
في نفس الصف والعمود، مما يؤدي إلى وضعهما فوق بعضهما البعض في شبكة 1x1.
باستخدام وظيفة التجميع المتجاوبة هذه كقاعدة، يمكننا الآن الاستفادة من حالة شريط عنوان URL لتبديل مستوى الرؤية ونمط الانتقال لشريط التنقل الجانبي.
عدِّل العنصر <aside> في app/index.html:
<aside>
<aside id="sidenav-open">
يتيح ذلك لـ CSS مطابقة عنصر وتجزئة عنوان URL معًا. هذا مهم لاستخدام ":target".
يمكن الآن أن يتطابق معرّف العنصر مع تجزئة عنوان URL التي سنضبطها باستخدام علامات <a>.
بالإضافة إلى ذلك، لتسهيل استهداف JavaScript، أضِف معرّفات للعناصر الرئيسية التي تتحكّم في شريط التنقّل الجانبي. أولاً، أضِف معرّفًا إلى رابط فتح شريط التنقّل الجانبي:
<a href="#sidenav-open" class="hamburger" title="Open Menu" aria-label="Open Menu">
<a href="#sidenav-open" id="sidenav-button" class="hamburger" title="Open Menu" aria-label="Open Menu">
بعد ذلك، أضِف معرّفًا إلى رابط إغلاق شريط التنقّل الجانبي:
<a href="#" title="Close Menu" aria-label="Close Menu"></a>
<a href="#" id="sidenav-close" title="Close Menu" aria-label="Close Menu"></a>
هذا يختتم التخطيط التراكمي المتجاوب لوحدة الماكرو <body>، بالإضافة إلى ربطنا بشريط عناوين URL.
لنواصل التقدم!
يتميز <aside> بتصميم أنيق أيضًا. يحتوي على عنصرَين ثانويَين، وهما <nav>، وهو المكوّن الذي يشبه الورقة وينزلق للخارج، وعنصر رابط الإغلاق <a> الذي يضبط عنوان URL على #.
الرابط غير مرئي على يمين شريط التنقل المنزلق؛ إنه حتى يتمكن الأشخاص من "النقر فوق" المكون
المرئي لإغلاقه.
أضِف CSS التالي إلى css/sidenav.css:
#sidenav-open {
display: grid;
grid-template-columns: [nav] 2fr [escape] 1fr;
}
أعتقد أنّ النسبة والأسماء كانت لمسة لطيفة هنا، حيث يمكن أن تتألق الشبكة وتمنح المصمم الكثير من التحكم.
بعد ذلك، أحتاج إلى تراكب المحتوى الرئيسي بشكل مشروط والحفاظ على موضعي
من خلال أي تمرير للمستند. هذه مهمة رائعة لـ position: sticky وبعض overscroll-behavior.
أضِف الأنماط التالية لشريط التنقّل الجانبي:
#sidenav-open {
display: grid;
grid-template-columns: [nav] 2fr [escape] 1fr;
@media (max-width: 540px) {
position: sticky;
top: 0;
max-height: 100vh;
overflow: hidden auto;
overscroll-behavior: contain;
visibility: hidden; /* not keyboard accessible when closed */
}
}
تضمن هذه الأنماط أن يكون شريط التنقل الجانبي بارتفاع إطار العرض، ويتم التمرير عموديًا
ويحتوي على شريط التمرير. والأهم من ذلك، أنّه يخفي العنصر. بشكل تلقائي،
عندما يكون إطار العرض 540px أو أصغر، يتم إخفاء شريط التنقل الجانبي. إلا إذا!
أضِف أداة الاختيار الزائفة :target إلى العنصر #sidenav-open:
#sidenav-open {
@media (max-width: 540px) {
&:target {
visibility: visible;
}
}
}
عندما يكون معرّف هذا العنصر وشريط عنوان URL متطابقَين،
يتم ضبط visibility على visible. يمكنك فتح القائمة الجانبية بعد الانتقال إلى أسفل الصفحة،
أو يمكنك الانتقال إلى أسفل الصفحة أثناء فتح شريط التنقّل الجانبي. ما رأيكم بذلك؟
أضِف CSS التالي إلى أسفل app/sidenav.css:
#sidenav-button,
#sidenav-close {
-webkit-tap-highlight-color: transparent;
-webkit-touch-callout: none;
user-select: none;
touch-action: manipulation;
@media (min-width: 540px) {
display: none;
}
}
تستهدف هذه الأنماط زرَّي الفتح والإغلاق، وتحدّد أنماط النقر واللمس،
وتخفيهما أيضًا عندما تكون مساحات العرض 540px أو أكبر.
لإضافة بعض اللمسات الجمالية، لنضِف تحويلات CSS مع مراعاة أدوات تسهيل الاستخدام.
أضِف CSS التالي إلى css/sidenav.css:
#sidenav-open {
--easeOutExpo: cubic-bezier(0.16, 1, 0.3, 1);
--duration: .6s;
...
@media (max-width: 540px) {
...
transform: translateX(-110vw);
will-change: transform;
transition:
transform var(--duration) var(--easeOutExpo),
visibility 0s linear var(--duration);
&:target {
visibility: visible;
transform: translateX(0);
transition: transform var(--duration) var(--easeOutExpo);
}
}
@media (prefers-reduced-motion: reduce) {
--duration: 1ms;
}
}
إضافة بعض عناصر JavaScript
يجب أن يؤدي الضغط على مفتاح Escape إلى إغلاق القائمة. أضِف رمز JS هذا إلى js/index.js:
const sidenav = document.querySelector('#sidenav-open');
sidenav.addEventListener('keyup', e => {
if (e.code === 'Escape') {
document.location.hash = '';
}
});
يستمع هذا إلى حدث رئيسي في عنصر sidenav.
إذا كانت القيمة Escape، يتم ضبط تجزئة عنوان URL على فارغة، ما يؤدي إلى إخفاء شريط التنقّل الجانبي.
الجزء التالي من JavaScript لتجربة المستخدم هو إدارة التركيز. أريد أن أجعل الفتح والإغلاق سهلاً، لذلك أنتظر حتى ينتهي شريط التنقل الجانبي من انتقال من نوع ما، ثم أتحقق منه مقابل تجزئة عنوان URL لتحديد ما إذا كان داخلاً أو خارجًا. بعد ذلك، أستخدم JavaScript لضبط التركيز على الزر المكمّل للزر الذي تم الضغط عليه للتو.
أضِف رمز JavaScript التالي إلى js/index.js:
const closenav = document.querySelector('#sidenav-close');
const opennav = document.querySelector('#sidenav-button');
sidenav.addEventListener('transitionend', e => {
if (e.propertyName !== 'transform') {
return;
}
const isOpen = document.location.hash === '#sidenav-open';
isOpen
? closenav.focus()
: opennav.focus();
});
للتجربة:
- لمعاينة الموقع الإلكتروني، انقر على عرض التطبيق، ثم انقر على
ملء الشاشة
.
الخاتمة
هذا ملخّص لاحتياجاتي من المكوّن. يمكنك الاستفادة من هذه الميزة واستخدامها مع حالة JavaScript بدلاً من عنوان URL، وتخصيصها بشكل عام لتناسب احتياجاتك. هناك دائمًا المزيد لإضافته أو المزيد من حالات الاستخدام لتغطيتها.
افتح css/brandnav.css للتحقق من الأنماط غير المتعلقة بالتخطيط التي قمت بتطبيقها على
هذا المكون. لم أشعر أنّها مهمة لمجموعة الخصائص التي كنت أركّز عليها، وكنت آمل أن يؤدي فصل الأنماط عن التنسيق إلى تشجيع النسخ واللصق. قد يكون هناك المزيد من المعلومات لك هناك!
كيف يمكنك إنشاء مكوّنات شريط تنقّل جانبي منزلق ومتجاوب؟ هل سبق أن كان لديك أكثر من واحد، مثل واحد على كلا الجانبين؟ أريد عرض الحلّ الذي توصّلت إليه في فيديو على YouTube، لذا يُرجى إرسال تغريدة إليّ أو إضافة تعليق في YouTube يتضمّن الرمز الذي استخدمته، فذلك سيساعد الجميع.