Google Slides प्रज़ेंटेशन में प्रोग्रेस बार दिखाएं

कोडिंग का लेवल: इंटरमीडिएट
अवधि: 15 मिनट
प्रोजेक्ट का टाइप: Editor ऐड-ऑन

मकसद

समझें कि समाधान क्या करता है.
समझें कि Apps Script की सेवाएं, समाधान में क्या करती हैं.
स्क्रिप्ट सेट अप करें.
स्क्रिप्ट चलाएं.

इस समाधान के बारे में जानकारी

इस समाधान का इस्तेमाल करके, अपने प्रज़ेंटेशन की स्लाइड में सबसे नीचे प्रोग्रेस बार जोड़ें.

Slides Editor ऐड-ऑन में मौजूद प्रोग्रेस बार का स्क्रीनशॉट

यह कैसे काम करता है

यह स्क्रिप्ट, प्रज़ेंटेशन में मौजूद स्लाइड की संख्या का हिसाब लगाती है. साथ ही, हर स्लाइड के सबसे नीचे एक आयताकार शेप जोड़ती है. यह स्क्रिप्ट, हर रेक्टैंगल का साइज़ बढ़ाती है, ताकि स्लाइड में प्रोग्रेस दिख सके.

Apps Script की सेवाएं

इस समाधान में, इस सेवा का इस्तेमाल किया जाता है:

Slides सेवा–यह किसी प्रज़ेंटेशन की स्लाइड को ऐक्सेस करती है और हर स्लाइड में आयताकार शेप जोड़ती है.

ज़रूरी शर्तें

इस सैंपल का इस्तेमाल करने के लिए, आपको इन ज़रूरी शर्तों को पूरा करना होगा:

Google खाता (Google Workspace खातों के लिए, एडमिन की मंज़ूरी ज़रूरी हो सकती है).
इंटरनेट ऐक्सेस करने की सुविधा वाला वेब ब्राउज़र.

स्क्रिप्ट सेट अप करना

प्रोग्रेस बार स्लाइड प्रज़ेंटेशन की कॉपी बनाने के लिए, यहां दिए गए बटन पर क्लिक करें. इस समाधान के लिए Apps Script प्रोजेक्ट, प्रज़ेंटेशन से अटैच है.
कॉपी बनाएं
प्रज़ेंटेशन में, एक्सटेंशन > प्रोग्रेस बार > प्रोग्रेस बार दिखाएं पर क्लिक करें.
जब आपसे कहा जाए, तब स्क्रिप्ट को अनुमति दें. अगर OAuth की सहमति वाली स्क्रीन पर, इस ऐप्लिकेशन की पुष्टि नहीं हुई है चेतावनी दिखती है, तो ऐडवांस > {Project Name} पर जाएं (सुरक्षित नहीं है) को चुनकर आगे बढ़ें.
फिर से, एक्सटेंशन > प्रोग्रेस बार > प्रोग्रेस बार दिखाएं पर क्लिक करें.
प्रोग्रेस बार हटाने के लिए, एक्सटेंशन > प्रोग्रेस बार > प्रोग्रेस बार छिपाएं पर क्लिक करें.

कोड की समीक्षा करना

इस समाधान के लिए, Apps Script कोड की समीक्षा करने के लिए, यहां दिया गया सोर्स कोड देखें पर क्लिक करें:

सोर्स कोड देखें

slides/progress/progress.gs

GitHub पर देखें

/**
 * @OnlyCurrentDoc Adds progress bars to a presentation.
 */
const BAR_ID = "PROGRESS_BAR_ID";
const BAR_HEIGHT = 10; // px

/**
 * Runs when the add-on is installed.
 * @param {object} e The event parameter for a simple onInstall trigger. To
 *     determine which authorization mode (ScriptApp.AuthMode) the trigger is
 *     running in, inspect e.authMode. (In practice, onInstall triggers always
 *     run in AuthMode.FULL, but onOpen triggers may be AuthMode.LIMITED or
 *     AuthMode.NONE.)
 */
function onInstall(e) {
  onOpen();
}

/**
 * Trigger for opening a presentation.
 * @param {object} e The onOpen event.
 */
function onOpen(e) {
  SlidesApp.getUi()
    .createAddonMenu()
    .addItem("Show progress bar", "createBars")
    .addItem("Hide progress bar", "deleteBars")
    .addToUi();
}

/**
 * Create a rectangle on every slide with different bar widths.
 */
function createBars() {
  deleteBars(); // Delete any existing progress bars
  const presentation = SlidesApp.getActivePresentation();
  const slides = presentation.getSlides();
  for (let i = 0; i < slides.length; ++i) {
    const ratioComplete = i / (slides.length - 1);
    const x = 0;
    const y = presentation.getPageHeight() - BAR_HEIGHT;
    const barWidth = presentation.getPageWidth() * ratioComplete;
    if (barWidth > 0) {
      const bar = slides[i].insertShape(
        SlidesApp.ShapeType.RECTANGLE,
        x,
        y,
        barWidth,
        BAR_HEIGHT,
      );
      bar.getBorder().setTransparent();
      bar.setLinkUrl(BAR_ID);
    }
  }
}

/**
 * Deletes all progress bar rectangles.
 */
function deleteBars() {
  const presentation = SlidesApp.getActivePresentation();
  const slides = presentation.getSlides();
  for (let i = 0; i < slides.length; ++i) {
    const elements = slides[i].getPageElements();
    for (const el of elements) {
      if (
        el.getPageElementType() === SlidesApp.PageElementType.SHAPE &&
        el.asShape().getLink() &&
        el.asShape().getLink().getUrl() === BAR_ID
      ) {
        el.remove();
      }
    }
  }
}

योगदानकर्ता

इस सैंपल को Google, Google Developer के विशेषज्ञ की मदद से मैनेज करता है.