แสดงแถบความคืบหน้าในงานนําเสนอใน Google สไลด์

ระดับการเขียนโค้ด: ระดับกลาง
ระยะเวลา: 15 นาที
ประเภทโปรเจ็กต์: ส่วนเสริมเครื่องมือแก้ไข

วัตถุประสงค์

  • ทำความเข้าใจการทำงานของโซลูชัน
  • ทำความเข้าใจการทำงานของบริการ Apps Script ภายในโซลูชัน
  • ตั้งค่าสคริปต์
  • เรียกใช้สคริปต์

เกี่ยวกับโซลูชันนี้

ใช้โซลูชันนี้เพื่อเพิ่มแถบความคืบหน้าที่ด้านล่างของสไลด์ในงานนำเสนอ

ภาพหน้าจอของส่วนเสริมเครื่องมือแก้ไขสไลด์ในแถบความคืบหน้า

ลักษณะการทำงาน

สคริปต์จะคำนวณจำนวนสไลด์ในงานนำเสนอและเพิ่มรูปสี่เหลี่ยมผืนผ้าที่ด้านล่างของแต่ละสไลด์ สคริปต์จะเพิ่มความกว้างของ รูปร่างสี่เหลี่ยมผืนผ้าเพื่อแสดงความคืบหน้าภายในสไลด์

บริการ Apps Script

โซลูชันนี้ใช้บริการต่อไปนี้

  • บริการสไลด์ - รับสไลด์ของงานนำเสนอและเพิ่มรูปสี่เหลี่ยมผืนผ้าให้กับแต่ละสไลด์

ข้อกำหนดเบื้องต้น

หากต้องการใช้ตัวอย่างนี้ คุณต้องมีข้อกำหนดเบื้องต้นต่อไปนี้

  • บัญชี Google (บัญชี Google Workspace อาจต้องได้รับการอนุมัติจากผู้ดูแลระบบ)
  • เว็บเบราว์เซอร์ที่มีการเชื่อมต่ออินเทอร์เน็ต

ตั้งค่าสคริปต์

  1. คลิกปุ่มต่อไปนี้เพื่อทำสำเนางานนำเสนอในสไลด์แถบความคืบหน้า โครงการ Apps Script สำหรับโซลูชันนี้ ถูกแนบมากับงานนำเสนอ
    ทำสำเนา
  2. ในงานนำเสนอ ให้คลิกส่วนขยาย > แถบความคืบหน้า > แสดงแถบความคืบหน้า
  3. เมื่อได้รับข้อความแจ้ง ให้ให้สิทธิ์สคริปต์ หากหน้าจอความยินยอมของ OAuth แสดงคำเตือน แอปนี้ไม่ได้รับการยืนยัน ให้ดำเนินการต่อโดยเลือกขั้นสูง > ไปที่ {Project Name} (ไม่ปลอดภัย)

  4. อีกครั้ง ให้คลิกส่วนขยาย > แถบความคืบหน้า > แสดงแถบความคืบหน้า

  5. หากต้องการนำแถบความคืบหน้าออก ให้คลิกส่วนขยาย > แถบความคืบหน้า > ซ่อนแถบความคืบหน้า

ตรวจสอบโค้ด

หากต้องการตรวจสอบโค้ด Apps Script สำหรับโซลูชันนี้ ให้คลิกดูซอร์สโค้ดด้านล่าง

ดูซอร์สโค้ด

สไลด์/progress/progress.gs
/**
 * @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

ขั้นตอนถัดไป