कोडलैब: स्टोरीज़ से जुड़ा कॉम्पोनेंट बनाना

इस कोडलैब में, वेब पर Instagram स्टोरीज़ जैसा अनुभव देने वाला ऐप्लिकेशन बनाने का तरीका बताया गया है. हम कॉम्पोनेंट को धीरे-धीरे बनाएंगे. पहले एचटीएमएल, फिर सीएसएस, और फिर JavaScript.

इस कॉम्पोनेंट को बनाते समय की गई परतदार वृद्धि के बारे में जानने के लिए, मेरी ब्लॉग पोस्ट स्टोरी कॉम्पोनेंट बनाना देखें.

सेटअप

  1. प्रोजेक्ट में बदलाव करने के लिए, बदलाव करने के लिए रीमिक्स करें पर क्लिक करें.
  2. app/index.html खोलें.

एचटीएमएल

मैं हमेशा सिमैंटिक एचटीएमएल का इस्तेमाल करने की कोशिश करता हूं. हर दोस्त की कितनी भी स्टोरी हो सकती हैं. इसलिए, मुझे लगा कि हर दोस्त के लिए <section> एलिमेंट और हर स्टोरी के लिए <article> एलिमेंट का इस्तेमाल करना सही रहेगा. चलिए, शुरुआत से शुरू करते हैं. सबसे पहले, हमें स्टोरी कॉम्पोनेंट के लिए एक कंटेनर की ज़रूरत होगी.

अपने <body> में <div> एलिमेंट जोड़ें:

<div class="stories">

</div>

दोस्तों को दिखाने के लिए, कुछ <section> एलिमेंट जोड़ें:

<div class="stories">
  <section class="user"></section>
  <section class="user"></section>
  <section class="user"></section>
  <section class="user"></section>
</div>

स्टोरी दिखाने के लिए, कुछ <article> एलिमेंट जोड़ें:

<div class="stories">
  <section class="user">
    <article class="story" style="--bg: url(https://picsum.photos/480/840);"></article>
    <article class="story" style="--bg: url(https://picsum.photos/480/841);"></article>
  </section>
  <section class="user">
    <article class="story" style="--bg: url(https://picsum.photos/481/840);"></article>
  </section>
  <section class="user">
    <article class="story" style="--bg: url(https://picsum.photos/481/841);"></article>
  </section>
  <section class="user">
    <article class="story" style="--bg: url(https://picsum.photos/482/840);"></article>
    <article class="story" style="--bg: url(https://picsum.photos/482/843);"></article>
    <article class="story" style="--bg: url(https://picsum.photos/482/844);"></article>
  </section>
</div>
  • हम स्टोरी के प्रोटोटाइप बनाने के लिए, इमेज सेवा (picsum.com) का इस्तेमाल कर रहे हैं.
  • हर <article> पर style एट्रिब्यूट, प्लेसहोल्डर लोड करने की तकनीक का हिस्सा होता है. इसके बारे में आपको अगले सेक्शन में ज़्यादा जानकारी मिलेगी.

सीएसएस

हमारा कॉन्टेंट स्टाइल के लिए तैयार है. चलिए, इस ढांचे को कुछ ऐसा बनाते हैं जिससे लोग इंटरैक्ट करना चाहें. आज हम मोबाइल-फ़र्स्ट पर काम करेंगे.

.stories

हमें अपने <div class="stories"> कंटेनर के लिए, हॉरिज़ॉन्टल स्क्रोलिंग कंटेनर चाहिए. इसके लिए, हम ये काम कर सकते हैं:

  • कंटेनर को ग्रिड बनाना
  • हर चाइल्ड व्यू को पंक्ति ट्रैक भरने के लिए सेट करना
  • हर चाइल्ड की चौड़ाई को मोबाइल डिवाइस के व्यूपोर्ट की चौड़ाई के बराबर करना

ग्रिड, पिछले कॉलम की दाईं ओर 100vw-वाइड कॉलम तब तक जोड़ता रहेगा, जब तक कि आपके मार्कअप में सभी एचटीएमएल एलिमेंट नहीं जुड़ जाते.

Chrome और DevTools खुले हैं. इनमें ग्रिड विज़ुअल दिख रहा है, जिसमें पूरी चौड़ाई वाला लेआउट दिखाया गया है
Chrome DevTools में ग्रिड कॉलम ओवरफ़्लो दिख रहा है, जिससे हॉरिज़ॉन्टल स्क्रोलर बन रहा है.

app/css/index.css के सबसे नीचे, यह सीएसएस जोड़ें:

.stories {
  display: grid;
  grid: 1fr / auto-flow 100%;
  gap: 1ch;
}

अब हमारे पास व्यूपोर्ट से बाहर जाने वाला कॉन्टेंट है, तो अब कंटेनर को यह बताने का समय आ गया है कि इसे कैसे मैनेज किया जाए. अपने .stories नियमों के सेट में, हाइलाइट की गई कोड की लाइनें जोड़ें:

.stories {
  display: grid;
  grid: 1fr / auto-flow 100%;
  gap: 1ch;
  overflow-x: auto;
  scroll-snap-type: x mandatory;
  overscroll-behavior: contain;
  touch-action: pan-x;
}

हमें हॉरिज़ॉन्टल स्क्रोलिंग चाहिए. इसलिए, हम overflow-x को auto पर सेट करेंगे. जब उपयोगकर्ता स्क्रोल करे, तो हम चाहते हैं कि कॉम्पोनेंट अगली स्टोरी पर धीरे से रुके. इसलिए, हम scroll-snap-type: x mandatory का इस्तेमाल करेंगे. इस सीएसएस के बारे में ज़्यादा जानने के लिए, मेरी ब्लॉग पोस्ट के सीएसएस स्क्रोल स्नैप पॉइंट और overscroll-behavior सेक्शन देखें.

स्क्रोल स्नैपिंग के लिए, पैरंट कंटेनर और चाइल्ड एलिमेंट, दोनों की सहमति ज़रूरी है. इसलिए, चलिए अब इसे हैंडल करते हैं. app/css/index.css के सबसे नीचे यह कोड जोड़ें:

.user {
  scroll-snap-align: start;
  scroll-snap-stop: always;
}

आपका ऐप्लिकेशन अभी काम नहीं करता है. हालांकि, यहां दिए गए वीडियो में दिखाया गया है कि scroll-snap-type को चालू और बंद करने पर क्या होता है. यह सुविधा चालू होने पर, हर हॉरिज़ॉन्टल स्क्रोल, अगली स्टोरी पर स्नैप हो जाता है. इस नीति के बंद होने पर, ब्राउज़र स्क्रोल करने के लिए अपने डिफ़ॉल्ट तरीके का इस्तेमाल करता है.

इससे आपको अपने दोस्तों की स्टोरी स्क्रोल करने का विकल्प मिलेगा. हालांकि, हमें स्टोरी से जुड़ी एक समस्या को अब भी हल करना है.

.user

चलिए, .user सेक्शन में एक लेआउट बनाते हैं, जो चाइल्ड स्टोरी के एलिमेंट को सही जगह पर सेट करता है. इस समस्या को हल करने के लिए, हम स्टैकिंग की एक आसान ट्रिक का इस्तेमाल करेंगे. हम एक 1x1 ग्रिड बना रहे हैं, जिसमें पंक्ति और कॉलम का ग्रिड उपनाम [story] है. साथ ही, हर स्टोरी ग्रिड आइटम उस स्पेस पर दावा करने की कोशिश करेगा. इससे एक स्टैक बन जाएगा.

हाइलाइट किए गए कोड को अपने .user के नियमों के सेट में जोड़ें:

.user {
  scroll-snap-align: start;
  scroll-snap-stop: always;
  display: grid;
  grid: [story] 1fr / [story] 1fr;
}

app/css/index.css के सबसे नीचे, यह नियम सेट जोड़ें:

.story {
  grid-area: story;
}

अब, ऐब्सलूट पोज़िशनिंग, फ़्लोट या अन्य लेआउट डायरेक्टिव के बिना, जो किसी एलिमेंट को फ़्लो से बाहर ले जाते हैं, हम अब भी फ़्लो में हैं. इसके अलावा, इसमें कोड भी बहुत कम है, इसे देखें! इस बारे में ज़्यादा जानकारी, वीडियो और ब्लॉग पोस्ट में दी गई है.

.story

अब हमें सिर्फ़ स्टोरी आइटम को स्टाइल करना है.

हमने पहले बताया था कि हर <article> एलिमेंट पर मौजूद style एट्रिब्यूट, प्लेसहोल्डर लोड करने की तकनीक का हिस्सा है:

<article class="story" style="--bg: url(https://picsum.photos/480/840);"></article>

हम सीएसएस की background-image प्रॉपर्टी का इस्तेमाल करेंगे. इससे हमें एक से ज़्यादा बैकग्राउंड इमेज तय करने की सुविधा मिलती है. हम उन्हें इस तरह से क्रम में लगा सकते हैं कि उपयोगकर्ता की तस्वीर सबसे ऊपर हो और लोड होने के बाद अपने-आप दिखे. इसे चालू करने के लिए, हम इमेज के यूआरएल को कस्टम प्रॉपर्टी (--bg) में डालेंगे. साथ ही, सीएसएस में इसका इस्तेमाल करके, लोड होने वाले प्लेसहोल्डर के साथ लेयर करेंगे.

सबसे पहले, .story के नियमों के सेट को अपडेट करें, ताकि ग्रेडिएंट को बैकग्राउंड इमेज से बदला जा सके. ऐसा तब करें, जब इमेज लोड हो जाए. हाइलाइट किए गए कोड को अपने .story के नियमों के सेट में जोड़ें:

.story {
  grid-area: story;

  background-size: cover;
  background-image:
    var(--bg),
    linear-gradient(to top, lch(98 0 0), lch(90 0 0));
}

background-size को cover पर सेट करने से यह पक्का होता है कि व्यूपोर्ट में कोई खाली जगह न हो, क्योंकि हमारी इमेज उसे भर देगी. दो बैकग्राउंड इमेज तय करने से, हमें सीएसएस वेब की एक शानदार ट्रिक का इस्तेमाल करने की सुविधा मिलती है. इसे लोडिंग टॉम्बस्टोन कहा जाता है:

  • बैकग्राउंड इमेज 1 (var(--bg)) वह यूआरएल है जिसे हमने एचटीएमएल में इनलाइन पास किया है
  • बैकग्राउंड इमेज 2 (linear-gradient(to top, lch(98 0 0), lch(90 0 0)) एक ग्रेडिएंट है, जो यूआरएल लोड होने के दौरान दिखता है

इमेज डाउनलोड होने के बाद, सीएसएस अपने-आप ग्रेडिएंट को इमेज से बदल देगी.

इसके बाद, हम कुछ सीएसएस जोड़ेंगे, ताकि कुछ व्यवहार को हटाया जा सके. इससे ब्राउज़र को तेज़ी से काम करने में मदद मिलेगी. हाइलाइट किए गए कोड को अपने .story के नियमों के सेट में जोड़ें:

.story {
  grid-area: story;

  background-size: cover;
  background-image:
    var(--bg),
    linear-gradient(to top, lch(98 0 0), lch(90 0 0));

  user-select: none;
  touch-action: manipulation;
}
  • user-select: none, उपयोगकर्ताओं को गलती से टेक्स्ट चुनने से रोकता है
  • touch-action: manipulation ब्राउज़र को निर्देश देता है कि इन इंटरैक्शन को टच इवेंट के तौर पर माना जाना चाहिए. इससे ब्राउज़र को यह तय करने की ज़रूरत नहीं पड़ती कि आपने किसी यूआरएल पर क्लिक किया है या नहीं

आखिर में, स्टोरी के बीच ट्रांज़िशन को ऐनिमेट करने के लिए, थोड़ा सीएसएस जोड़ें. हाइलाइट किए गए कोड को अपने .story नियम सेट में जोड़ें:

.story {
  grid-area: story;

  background-size: cover;
  background-image:
    var(--bg),
    linear-gradient(to top, lch(98 0 0), lch(90 0 0));

  user-select: none;
  touch-action: manipulation;

  transition: opacity .3s cubic-bezier(0.4, 0.0, 1, 1);

  &.seen {
    opacity: 0;
    pointer-events: none;
  }
}

.seen क्लास को ऐसी स्टोरी में जोड़ा जाएगा जिससे बाहर निकलने की ज़रूरत है. मुझे मटीरियल डिज़ाइन की ईज़िंग गाइड से, कस्टम ईज़िंग फ़ंक्शन (cubic-bezier(0.4, 0.0, 1,1)) मिला. इसके लिए, ऐक्सेलरेटेड ईज़िंग सेक्शन पर स्क्रोल करें.

अगर आपने ध्यान दिया हो, तो आपको pointer-events: none का एलान दिखा होगा और आप सोच में पड़ गए होंगे. मुझे लगता है कि अब तक इस समाधान की यही एक कमी है. हमें इसकी ज़रूरत इसलिए है, क्योंकि .seen.story एलिमेंट सबसे ऊपर होगा और उस पर टैप किए जा सकेंगे. भले ही, वह न दिखे. pointer-events को none पर सेट करके, हम ग्लास स्टोरी को विंडो में बदल देते हैं. साथ ही, उपयोगकर्ता के इंटरैक्शन को चुराते नहीं हैं. यह कोई बुरा सौदा नहीं है. फ़िलहाल, हमारी सीएसएस में इसे मैनेज करना ज़्यादा मुश्किल नहीं है. हम z-index को नहीं बदल रहे हैं. मुझे अब भी इस बारे में अच्छा महसूस हो रहा है.

JavaScript

स्टोरी कॉम्पोनेंट के साथ इंटरैक्ट करना, उपयोगकर्ता के लिए काफ़ी आसान है: आगे जाने के लिए दाईं ओर टैप करें और पीछे जाने के लिए बाईं ओर टैप करें. उपयोगकर्ताओं के लिए जो चीज़ें आसान होती हैं, डेवलपर के लिए उन्हें बनाना मुश्किल होता है. हालांकि, हम इनमें से ज़्यादातर चीज़ों का ध्यान रखेंगे.

सेटअप

शुरुआत में, ज़्यादा से ज़्यादा जानकारी इकट्ठा करके सेव करें. app/js/index.js में यह कोड जोड़ें:

const stories = document.querySelector('.stories')
const median = stories.offsetLeft + (stories.clientWidth / 2)

JavaScript की हमारी पहली लाइन, हमारे मुख्य एचटीएमएल एलिमेंट रूट का रेफ़रंस लेती है और उसे सेव करती है. अगली लाइन से यह पता चलता है कि हमारे एलिमेंट का बीच का हिस्सा कहां है, ताकि हम यह तय कर सकें कि टैप करने पर आगे जाना है या पीछे.

राज्य

इसके बाद, हम अपने लॉजिक के हिसाब से कुछ स्टेट के साथ एक छोटा ऑब्जेक्ट बनाते हैं. इस मामले में, हमें सिर्फ़ मौजूदा स्टोरी में दिलचस्पी है. अपने एचटीएमएल मार्कअप में, हम इसे पहले दोस्त और उसकी सबसे हाल ही की स्टोरी को चुनकर ऐक्सेस कर सकते हैं. हाइलाइट किए गए कोड को अपने app/js/index.js में जोड़ें:

const stories = document.querySelector('.stories')
const median = stories.offsetLeft + (stories.clientWidth / 2)

const state = {
  current_story: stories.firstElementChild.lastElementChild
}

लिसनर

अब हमारे पास उपयोगकर्ता के इवेंट को सुनने और उन्हें डायरेक्ट करने के लिए ज़रूरी लॉजिक है.

चूहा

चलिए, सबसे पहले स्टोरी कंटेनर पर 'click' इवेंट को सुनते हैं. app/js/index.js में हाइलाइट किया गया कोड जोड़ें:

const stories = document.querySelector('.stories')
const median = stories.offsetLeft + (stories.clientWidth / 2)

const state = {
  current_story: stories.firstElementChild.lastElementChild
}

stories.addEventListener('click', e => {
  if (e.target.nodeName !== 'ARTICLE')
    return

  navigateStories(
    e.clientX > median
      ? 'next'
      : 'prev')
})

अगर क्लिक होता है और वह <article> एलिमेंट पर नहीं होता है, तो हम कुछ नहीं करते. अगर यह कोई लेख है, तो हम clientX की मदद से, माउस या उंगली की हॉरिज़ॉन्टल पोज़िशन को कैप्चर करते हैं. हमने अभी तक navigateStories को लागू नहीं किया है, लेकिन इसमें जो आर्ग्युमेंट दिया गया है उससे पता चलता है कि हमें किस दिशा में जाना है. अगर उपयोगकर्ता की पोज़िशन मीडियन से ज़्यादा है, तो हमें पता है कि हमें next पर जाना होगा. अगर ऐसा नहीं है, तो prev (पिछला) पर जाना होगा.

कीबोर्ड

अब, कीबोर्ड पर बटन दबाने की आवाज़ सुनें. डाउन ऐरो दबाने पर, हम next पर पहुंच जाते हैं. अगर अप ऐरो दबाया जाता है, तो हम prev पर जाते हैं.

app/js/index.js में हाइलाइट किया गया कोड जोड़ें:

const stories = document.querySelector('.stories')
const median = stories.offsetLeft + (stories.clientWidth / 2)

const state = {
  current_story: stories.firstElementChild.lastElementChild
}

stories.addEventListener('click', e => {
  if (e.target.nodeName !== 'ARTICLE')
    return

  navigateStories(
    e.clientX > median
      ? 'next'
      : 'prev')
})

document.addEventListener('keydown', ({key}) => {
  if (key !== 'ArrowDown' || key !== 'ArrowUp')
    navigateStories(
      key === 'ArrowDown'
        ? 'next'
        : 'prev')
})

स्टोरीज़ के बीच नेविगेट करना

अब समय आ गया है कि हम स्टोरीज़ के खास कारोबारी नियमों और यूज़र एक्सपीरियंस (UX) पर काम करें. इनकी वजह से ही स्टोरीज़ को इतनी लोकप्रियता मिली है. यह काफ़ी बड़ा और मुश्किल लग सकता है. हालांकि, अगर इसे लाइन दर लाइन पढ़ा जाए, तो इसे समझना काफ़ी आसान हो जाता है.

सबसे पहले, हम कुछ सिलेक्टर सेव करते हैं. इनकी मदद से, हम यह तय करते हैं कि किसी दोस्त की प्रोफ़ाइल पर स्क्रोल करना है या किसी स्टोरी को दिखाना/छिपाना है. हम एचटीएमएल में काम कर रहे हैं. इसलिए, हम दोस्तों (उपयोगकर्ताओं) या स्टोरी (स्टोरी) की मौजूदगी के लिए, इसमें क्वेरी करेंगे.

इन वैरिएबल से हमें इस तरह के सवालों के जवाब देने में मदद मिलेगी, "अगर कोई स्टोरी x है, तो "अगली" का मतलब, इसी दोस्त की दूसरी स्टोरी पर जाना है या किसी दूसरे दोस्त की स्टोरी पर?" मैंने इसके लिए, ट्री स्ट्रक्चर का इस्तेमाल किया. इसमें माता-पिता और उनके बच्चों को शामिल किया गया.

app/js/index.js के सबसे नीचे यह कोड जोड़ें:

const navigateStories = direction => {
  const story = state.current_story
  const lastItemInUserStory = story.parentNode.firstElementChild
  const firstItemInUserStory = story.parentNode.lastElementChild
  const hasNextUserStory = story.parentElement.nextElementSibling
  const hasPrevUserStory = story.parentElement.previousElementSibling
}

यहां हमारे कारोबारी नियम का लक्ष्य दिया गया है. यह नैचुरल लैंग्वेज के काफ़ी करीब है:

  • तय करें कि टैप को कैसे मैनेज करना है
    • अगर कोई अगली/पिछली स्टोरी है, तो वह स्टोरी दिखाएं
    • अगर यह दोस्त की आखिरी/पहली स्टोरी है, तो किसी नए दोस्त की स्टोरी दिखाएं
    • अगर उस दिशा में कोई स्टोरी नहीं है, तो कुछ न करें
  • state में नई मौजूदा स्टोरी सेव करें

हाइलाइट किए गए कोड को अपने navigateStories फ़ंक्शन में जोड़ें:

const navigateStories = direction => {
  const story = state.current_story
  const lastItemInUserStory = story.parentNode.firstElementChild
  const firstItemInUserStory = story.parentNode.lastElementChild
  const hasNextUserStory = story.parentElement.nextElementSibling
  const hasPrevUserStory = story.parentElement.previousElementSibling

  if (direction === 'next') {
    if (lastItemInUserStory === story && !hasNextUserStory)
      return
    else if (lastItemInUserStory === story && hasNextUserStory) {
      state.current_story = story.parentElement.nextElementSibling.lastElementChild
      story.parentElement.nextElementSibling.scrollIntoView({
        behavior: 'smooth'
      })
    }
    else {
      story.classList.add('seen')
      state.current_story = story.previousElementSibling
    }
  }
  else if(direction === 'prev') {
    if (firstItemInUserStory === story && !hasPrevUserStory)
      return
    else if (firstItemInUserStory === story && hasPrevUserStory) {
      state.current_story = story.parentElement.previousElementSibling.firstElementChild
      story.parentElement.previousElementSibling.scrollIntoView({
        behavior: 'smooth'
      })
    }
    else {
      story.nextElementSibling.classList.remove('seen')
      state.current_story = story.nextElementSibling
    }
  }
}

इसे आज़माएं

  • साइट की झलक देखने के लिए, ऐप्लिकेशन देखें को दबाएं. इसके बाद, फ़ुलस्क्रीन फ़ुलस्क्रीन को दबाएं.

नतीजा

इस कॉम्पोनेंट के बारे में मुझे इतनी ही जानकारी चाहिए थी. बेझिझक होकर, इसे बेहतर बनाएं, डेटा की मदद से इसे आगे बढ़ाएं, और इसे अपना बनाएं!