คอมโพเนนต์วิธีการ – แท็บวิธีการ

<howto-tabs> จำกัดเนื้อหาที่มองเห็นได้โดยแยกออกเป็นหลายแผง โดยจะเห็นแผงได้เพียงแผงเดียวในแต่ละครั้ง แต่แท็บที่เกี่ยวข้องทั้งหมดจะปรากฏอยู่เสมอ หากต้องการเปลี่ยนจากแผงหนึ่งไปยังอีกแผงหนึ่ง คุณต้องเลือกแท็บที่เกี่ยวข้อง

ผู้ใช้สามารถเปลี่ยนการเลือกแท็บที่ใช้งานอยู่ด้วยการคลิกหรือใช้แป้นลูกศร

หากปิดใช้ JavaScript แผงทั้งหมดจะแสดงสลับกับแท็บที่เกี่ยวข้อง ตอนนี้แท็บจะทําหน้าที่เป็นส่วนหัว

ข้อมูลอ้างอิง

สาธิต

ดูการสาธิตการใช้งานแบบสดบน GitHub

ตัวอย่างการใช้

<style>
  howto-tab {
    border: 1px solid black;
    padding: 20px;
  }
  howto-panel {
    padding: 20px;
    background-color: lightgray;
  }
  howto-tab[selected] {
    background-color: bisque;
  }

หาก JavaScript ไม่ทํางาน องค์ประกอบจะไม่ตรงกับ :defined ในกรณีนี้ สไตล์นี้จะเพิ่มระยะห่างระหว่างแท็บกับแผงก่อนหน้า

  howto-tabs:not(:defined), howto-tab:not(:defined), howto-panel:not(:defined) {
    display: block;
  }
</style>

<howto-tabs>
  <howto-tab role="heading" slot="tab">Tab 1</howto-tab>
  <howto-panel role="region" slot="panel">Content 1</howto-panel>
  <howto-tab role="heading" slot="tab">Tab 2</howto-tab>
  <howto-panel role="region" slot="panel">Content 2</howto-panel>
  <howto-tab role="heading" slot="tab">Tab 3</howto-tab>
  <howto-panel role="region" slot="panel">Content 3</howto-panel>
</howto-tabs>

รหัส

(function() {

กําหนดคีย์โค้ดเพื่อช่วยจัดการเหตุการณ์แป้นพิมพ์

  const KEYCODE = {
    DOWN: 40,
    LEFT: 37,
    RIGHT: 39,
    UP: 38,
    HOME: 36,
    END: 35,
  };

อินสแตนซ์ <howto-tabs> ทั้งหมดจะแชร์เทมเพลตสำหรับเนื้อหาของ Shadow DOM เพื่อหลีกเลี่ยงการเรียกใช้โปรแกรมแยกวิเคราะห์ด้วย .innerHTML สำหรับอินสแตนซ์ใหม่ทุกรายการ

  const template = document.createElement('template');
  template.innerHTML = `
    <style>
      :host {
        display: flex;
        flex-wrap: wrap;
      }
      ::slotted(howto-panel) {
        flex-basis: 100%;
      }
    </style>
    <slot name="tab"></slot>
    <slot name="panel"></slot>
  `;

HowtoTabs เป็นองค์ประกอบคอนเทนเนอร์สำหรับแท็บและแผง

รายการย่อยทั้งหมดของ <howto-tabs> ควรเป็น <howto-tab> หรือ <howto-tabpanel> องค์ประกอบนี้จะไม่เก็บสถานะ ซึ่งหมายความว่าจะไม่มีการแคชค่าใดๆ ไว้ ทำให้มีการเปลี่ยนแปลงในระหว่างรันไทม์

  class HowtoTabs extends HTMLElement {
    constructor() {
      super();

ตัวแฮนเดิลเหตุการณ์ที่ไม่ได้แนบกับองค์ประกอบนี้จำเป็นต้องเชื่อมโยงหากจำเป็นต้องเข้าถึง this

      this._onSlotChange = this._onSlotChange.bind(this);

สำหรับการเพิ่มประสิทธิภาพแบบต่อเนื่อง มาร์กอัปควรสลับระหว่างแท็บและแผง องค์ประกอบที่เรียงลําดับองค์ประกอบย่อยใหม่มักจะทํางานร่วมกับเฟรมเวิร์กได้ไม่ดี แต่มีการใช้ Shadow DOM แทนเพื่อเรียงลำดับองค์ประกอบใหม่โดยใช้สล็อต

      this.attachShadow({ mode: 'open' });

นำเข้าเทมเพลตที่แชร์เพื่อสร้างช่องสำหรับแท็บและแผง

      this.shadowRoot.appendChild(template.content.cloneNode(true));

      this._tabSlot = this.shadowRoot.querySelector('slot[name=tab]');
      this._panelSlot = this.shadowRoot.querySelector('slot[name=panel]');

องค์ประกอบนี้ต้องตอบสนองต่อองค์ประกอบย่อยใหม่เนื่องจากลิงก์แท็บและแผงโดยใช้ aria-labelledby และ aria-controls ระบบจะจัดสรรช่องใหม่โดยอัตโนมัติและทริกเกอร์ slotchange จึงไม่จำเป็นต้องใช้ MutationObserver

      this._tabSlot.addEventListener('slotchange', this._onSlotChange);
      this._panelSlot.addEventListener('slotchange', this._onSlotChange);
    }

connectedCallback() จัดกลุ่มแท็บและแผงโดยจัดเรียงใหม่และตรวจสอบว่ามีแท็บที่ใช้งานอยู่เพียงแท็บเดียว

    connectedCallback() {

เอลิเมนต์ต้องจัดการเหตุการณ์อินพุตด้วยตนเองเพื่อให้สลับด้วยแป้นลูกศรและ Home / End ได้

      this.addEventListener('keydown', this._onKeyDown);
      this.addEventListener('click', this._onClick);

      if (!this.hasAttribute('role'))
        this.setAttribute('role', 'tablist');

ก่อนหน้านี้ เหตุการณ์ slotchange จะไม่ทริกเกอร์เมื่อองค์ประกอบได้รับการอัปเกรดโดยโปรแกรมแยกวิเคราะห์ ด้วยเหตุนี้ องค์ประกอบจึงเรียกใช้ตัวแฮนเดิลด้วยตนเอง เมื่อลักษณะการทำงานแบบใหม่เข้าสู่ทุกเบราว์เซอร์แล้ว คุณจะนำโค้ดด้านล่างออกได้

      Promise.all([
        customElements.whenDefined('howto-tab'),
        customElements.whenDefined('howto-panel'),
      ])
        .then(() => this._linkPanels());
    }

disconnectedCallback() จะนำ Listener เหตุการณ์ที่ connectedCallback() เพิ่มออก

    disconnectedCallback() {
      this.removeEventListener('keydown', this._onKeyDown);
      this.removeEventListener('click', this._onClick);
    }

_onSlotChange() จะเรียกใช้ทุกครั้งที่มีการเพิ่มหรือนําองค์ประกอบออกจากช่อง Shadow DOM รายการใดรายการหนึ่ง

    _onSlotChange() {
      this._linkPanels();
    }

_linkPanels() ลิงก์แท็บกับแผงที่อยู่ติดกันโดยใช้ aria-control และ aria-labelledby นอกจากนี้ วิธีการนี้จะตรวจสอบว่ามีเพียงแท็บเดียวที่ใช้งานอยู่

    _linkPanels() {
      const tabs = this._allTabs();

ระบุแอตทริบิวต์ aria-labelledby ให้กับแต่ละแผงซึ่งอ้างอิงถึงแท็บที่ควบคุมแผงนั้น

      tabs.forEach((tab) => {
        const panel = tab.nextElementSibling;
        if (panel.tagName.toLowerCase() !== 'howto-panel') {
          console.error(`Tab #${tab.id} is not a` +
            `sibling of a <howto-panel>`);
          return;
        }

        tab.setAttribute('aria-controls', panel.id);
        panel.setAttribute('aria-labelledby', tab.id);
      });

องค์ประกอบจะตรวจสอบว่าแท็บใดมีสถานะเป็นเลือกไว้หรือไม่ หากไม่ แสดงว่ามีการเลือกแท็บแรกแล้ว

      const selectedTab =
        tabs.find((tab) => tab.selected) || tabs[0];

จากนั้นเปลี่ยนไปใช้แท็บที่เลือก _selectTab() มีหน้าที่ทำเครื่องหมายแท็บอื่นๆ ทั้งหมดเป็นยกเลิกการเลือกและซ่อนแผงอื่นๆ ทั้งหมด

      this._selectTab(selectedTab);
    }

_allPanels() แสดงแผงทั้งหมดในแผงแท็บ ฟังก์ชันนี้สามารถจดจำผลลัพธ์ได้หากการค้นหา DOM กลายเป็นปัญหาด้านประสิทธิภาพ ข้อเสียของการจดจําคือระบบจะไม่จัดการแท็บและแผงซึ่งเพิ่มแบบไดนามิก

นี่เป็นเมธอด ไม่ใช่ตัวรับ เนื่องจากตัวรับจะบอกเป็นนัยว่าอ่านได้ง่าย

    _allPanels() {
      return Array.from(this.querySelectorAll('howto-panel'));
    }

_allTabs() แสดงแท็บทั้งหมดในแผงแท็บ

    _allTabs() {
      return Array.from(this.querySelectorAll('howto-tab'));
    }

_panelForTab() แสดงผลแผงที่แท็บที่ระบุควบคุม

    _panelForTab(tab) {
      const panelId = tab.getAttribute('aria-controls');
      return this.querySelector(`#${panelId}`);
    }

_prevTab() จะแสดงผลแท็บที่อยู่ก่อนหน้าแท็บที่เลือกอยู่ในปัจจุบัน โดยระบบจะวนกลับไปที่แท็บแรกเมื่อถึงแท็บสุดท้าย

    _prevTab() {
      const tabs = this._allTabs();

ใช้ findIndex() เพื่อค้นหาดัชนีขององค์ประกอบที่เลือกอยู่ในปัจจุบัน และลบ 1 เพื่อดูดัชนีขององค์ประกอบก่อนหน้า

      let newIdx = tabs.findIndex((tab) => tab.selected) - 1;

เพิ่ม tabs.length เพื่อให้แน่ใจว่าดัชนีเป็นจํานวนบวกและรับค่าเศษทศนิยมเพื่อตัดเศษหากจําเป็น

      return tabs[(newIdx + tabs.length) % tabs.length];
    }

_firstTab() แสดงแท็บแรก

    _firstTab() {
      const tabs = this._allTabs();
      return tabs[0];
    }

_lastTab() แสดงแท็บล่าสุด

    _lastTab() {
      const tabs = this._allTabs();
      return tabs[tabs.length - 1];
    }

_nextTab() รับแท็บที่อยู่หลังแท็บที่เลือกอยู่ในปัจจุบัน โดยระบบจะวนกลับไปที่แท็บแรกเมื่อถึงแท็บสุดท้าย

    _nextTab() {
      const tabs = this._allTabs();
      let newIdx = tabs.findIndex((tab) => tab.selected) + 1;
      return tabs[newIdx % tabs.length];
    }

reset() จะยกเลิกการเลือกแท็บทั้งหมดและซ่อนแผงทั้งหมด

    reset() {
      const tabs = this._allTabs();
      const panels = this._allPanels();

      tabs.forEach((tab) => tab.selected = false);
      panels.forEach((panel) => panel.hidden = true);
    }

_selectTab() ทำเครื่องหมายแท็บที่ระบุว่า "เลือกแล้ว" นอกจากนี้ ยังเลิกซ่อนแผงที่เกี่ยวข้องกับแท็บนั้นด้วย

    _selectTab(newTab) {

ยกเลิกการเลือกแท็บทั้งหมดและซ่อนแผงทั้งหมด

      this.reset();

รับแผงที่ newTab เชื่อมโยงอยู่

      const newPanel = this._panelForTab(newTab);

หากไม่มีแผงดังกล่าว ให้ยกเลิก

      if (!newPanel)
        throw new Error(`No panel with id ${newPanelId}`);
      newTab.selected = true;
      newPanel.hidden = false;
      newTab.focus();
    }

_onKeyDown() จัดการการกดแป้นพิมพ์ภายในแผงแท็บ

    _onKeyDown(event) {

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

      if (event.target.getAttribute('role') !== 'tab')
        return;

อย่าจัดการแป้นพิมพ์ลัดตัวแก้ไขที่มักใช้โดยเทคโนโลยีความช่วยเหลือพิเศษ

      if (event.altKey)
        return;

Switch-case จะกําหนดว่าควรทําเครื่องหมายแท็บใดเป็นแท็บที่ใช้งานอยู่โดยขึ้นอยู่กับแป้นที่กด

      let newTab;
      switch (event.keyCode) {
        case KEYCODE.LEFT:
        case KEYCODE.UP:
          newTab = this._prevTab();
          break;

        case KEYCODE.RIGHT:
        case KEYCODE.DOWN:
          newTab = this._nextTab();
          break;

        case KEYCODE.HOME:
          newTab = this._firstTab();
          break;

        case KEYCODE.END:
          newTab = this._lastTab();
          break;

ระบบจะไม่สนใจการกดแป้นอื่นๆ และระบบจะส่งคืนกลับไปยังเบราว์เซอร์

        default:
          return;
      }

เบราว์เซอร์อาจมีฟังก์ชันการทำงานบางอย่างที่เชื่อมโยงกับแป้นลูกศร แป้น Home หรือ End องค์ประกอบเรียก preventDefault() เพื่อป้องกันไม่ให้เบราว์เซอร์ดำเนินการใดๆ

      event.preventDefault();

เลือกแท็บใหม่ที่กําหนดไว้ในเงื่อนไขเทิร์น

      this._selectTab(newTab);
    }

_onClick() จัดการการคลิกภายในแผงแท็บ

    _onClick(event) {

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

      if (event.target.getAttribute('role') !== 'tab')
        return;

แต่หากอยู่ในองค์ประกอบแท็บ ให้เลือกแท็บนั้น

      this._selectTab(event.target);
    }
  }

  customElements.define('howto-tabs', HowtoTabs);

howtoTabCounter นับจํานวนอินสแตนซ์ <howto-tab> ที่สร้างขึ้น ระบบจะใช้หมายเลขนี้เพื่อสร้างรหัสใหม่ที่ไม่ซ้ำกัน

  let howtoTabCounter = 0;

HowtoTab คือแท็บสำหรับแผงแท็บ <howto-tabs> ควรใช้ <howto-tab> ร่วมกับ role="heading" ในมาร์กอัปเสมอเพื่อให้ความหมายยังคงใช้งานได้เมื่อ JavaScript ไม่ทำงาน

<howto-tab> จะประกาศว่า <howto-panel> นี้เป็นของใดโดยใช้รหัสของแผงเป็นค่าสำหรับแอตทริบิวต์ aria-controls

<howto-tab> จะสร้างรหัสที่ไม่ซ้ำกันโดยอัตโนมัติหากไม่ได้ระบุ

  class HowtoTab extends HTMLElement {

    static get observedAttributes() {
      return ['selected'];
    }

    constructor() {
      super();
    }

    connectedCallback() {

หากดำเนินการดังกล่าว JavaScript จะทำงานและองค์ประกอบจะเปลี่ยนบทบาทเป็น tab

      this.setAttribute('role', 'tab');
      if (!this.id)
        this.id = `howto-tab-generated-${howtoTabCounter++}`;

ตั้งค่าสถานะเริ่มต้นที่กำหนดไว้อย่างชัดเจน

      this.setAttribute('aria-selected', 'false');
      this.setAttribute('tabindex', -1);
      this._upgradeProperty('selected');
    }

ตรวจสอบว่าพร็อพเพอร์ตี้มีค่าอินสแตนซ์หรือไม่ หากใช่ ให้คัดลอกค่าและลบพร็อพเพอร์ตี้อินสแตนซ์ออกเพื่อไม่ให้บดบังตัวตั้งค่าพร็อพเพอร์ตี้คลาส สุดท้าย ส่งค่าไปยังตัวตั้งค่าพร็อพเพอร์ตี้คลาสเพื่อให้ทริกเกอร์ผลข้างเคียงใดๆ ได้ การดำเนินการนี้เป็นการปกป้องในกรณีที่เฟรมเวิร์กอาจเพิ่มองค์ประกอบลงในหน้าเว็บและตั้งค่าในพร็อพเพอร์ตี้รายการใดรายการหนึ่ง แต่โหลดคําจํากัดความแบบ Lazy หากไม่มีการป้องกันนี้ องค์ประกอบที่อัปเกรดจะพลาดพร็อพเพอร์ตี้ดังกล่าวและพร็อพเพอร์ตี้อินสแตนซ์จะป้องกันไม่ให้มีการเรียกใช้ตัวตั้งค่าพร็อพเพอร์ตี้คลาส

    _upgradeProperty(prop) {
      if (this.hasOwnProperty(prop)) {
        let value = this[prop];
        delete this[prop];
        this[prop] = value;
      }
    }

โดยพร็อพเพอร์ตี้และแอตทริบิวต์ที่เกี่ยวข้องควรเหมือนกัน ด้วยเหตุนี้ ตัวตั้งค่าพร็อพเพอร์ตี้สำหรับ selected จึงจัดการค่าที่เป็นจริง/เท็จและแสดงค่าเหล่านั้นในสถานะของแอตทริบิวต์ โปรดทราบว่าไม่มีผลข้างเคียงที่เกิดขึ้นในการตั้งค่าพร็อพเพอร์ตี้ เช่น ตัวตั้งค่าไม่ได้ตั้งค่า aria-selected แต่งานนั้นจะเกิดขึ้นใน attributeChangedCallback แทน โดยทั่วไปแล้ว ให้ตั้งค่าตัวเซ็ตพร็อพเพอร์ตี้ให้ทำงานแบบโง่ๆ และหากการตั้งค่าพร็อพเพอร์ตี้หรือแอตทริบิวต์ควรทำให้เกิดผลข้างเคียง (เช่น การตั้งค่าแอตทริบิวต์ ARIA ที่เกี่ยวข้อง) ให้ทํางานนั้นใน attributeChangedCallback() วิธีนี้จะช่วยหลีกเลี่ยงการจัดการสถานการณ์การกลับมาของแอตทริบิวต์/พร็อพเพอร์ตี้ที่ซับซ้อน

    attributeChangedCallback() {
      const value = this.hasAttribute('selected');
      this.setAttribute('aria-selected', value);
      this.setAttribute('tabindex', value ? 0 : -1);
    }

    set selected(value) {
      value = Boolean(value);
      if (value)
        this.setAttribute('selected', '');
      else
        this.removeAttribute('selected');
    }

    get selected() {
      return this.hasAttribute('selected');
    }
  }

  customElements.define('howto-tab', HowtoTab);

  let howtoPanelCounter = 0;

HowtoPanel คือแผงสำหรับแผงแท็บ <howto-tabs>

  class HowtoPanel extends HTMLElement {

    constructor() {
      super();
    }

    connectedCallback() {
      this.setAttribute('role', 'tabpanel');
      if (!this.id)
        this.id = `howto-panel-generated-${howtoPanelCounter++}`;
    }
  }

  customElements.define('howto-panel', HowtoPanel);
})();