آکاردئون انحصاری

یک آکاردئون انحصاری با چندین عنصر <details> که name یکسانی دارند ایجاد کنید.

آکاردئون

یک الگوی رابط کاربری رایج در وب، یک جزء آکاردئونی است. این مؤلفه ای است که از چندین ویجت افشا تشکیل شده است که به صورت جداگانه می توان آنها را گسترش داد (یا جمع کرد) تا محتوای آنها آشکار شود (یا پنهان شود).

برای پیاده‌سازی این الگو در وب، چند عنصر <details> را ترکیب می‌کنید و معمولاً آنها را به صورت بصری گروه‌بندی می‌کنید تا نشان دهید که به یکدیگر تعلق دارند.

نسخه ی نمایشی: آکاردئون با HTML و CSS.

آکاردئون انحصاری

پشتیبانی مرورگر

  • کروم: 120.
  • لبه: 120.
  • فایرفاکس: 130.
  • سافاری: 17.2.

یکی از انواع الگوی آکاردئون، آکاردئون انحصاری است که در آن تنها یکی از ویجت‌های افشا را می‌توان همزمان باز کرد.

برای ایجاد یک آکاردئون انحصاری در وب، یک ویژگی name به عناصر <details> اضافه می‌کنید. هنگامی که از این ویژگی استفاده می شود، چندین عنصر <details> که دارای مقدار name یکسانی هستند، یک گروه معنایی را تشکیل می دهند و به عنوان یک آکاردئون انحصاری رفتار می کنند. هنگامی که یکی از عناصر <details> را از گروه باز می کنید، عنصری که قبلاً باز شده بود به طور خودکار بسته می شود.

<details name="learn-css">
  <summary>Welcome to Learn CSS!</summary>
  <p>…</p>
</details>
<details name="learn-css">
  <summary>Box Model</summary>
  <p>…</p>
</details>
<details name="learn-css">
  <summary>Selectors</summary>
  <p>…</p>
</details>
نسخه ی نمایشی: آکاردئون انحصاری با HTML و CSS.

یک صفحه می تواند چندین آکاردئون منحصر به فرد داشته باشد. هر زمان که از یک مقدار name جدید در عنصر <details> استفاده می کنید، یک گروه منطقی جدید ایجاد می شود.

نسخه ی نمایشی: چندین آکاردئون منحصر به فرد با HTML و CSS.

عناصر <details> که بخشی از یک آکاردئون انحصاری هستند لزوماً لازم نیست خواهر و برادر باشند. آنها می توانند در سراسر سند پراکنده شوند. این ویژگی name است که آنها را گروه بندی می کند، نه ترتیب DOM آنها.

آکاردئون انحصاری را پلی پر کنید

با جاوا اسکریپت زیر می‌توان رفتار آکاردئون انحصاری را چندگانه پر کرد. کد متکی به رویداد toggle عنصر <details> است.

وقتی یک عنصر <details> با name باز می شود، کد سایر عناصر <details> باز را با همان مقدار برای ویژگی name پیدا کرده و آنها را می بندد.

document.querySelectorAll("details[name]").forEach(($details) => {
  $details.addEventListener("toggle", (e) => {
    const name = $details.getAttribute("name");

    if (e.newState == "open") {
      document
        .querySelectorAll(`details[name=${name}][open]`)
        .forEach(($openDetails) => {
          if (!($openDetails === $details)) {
            $openDetails.removeAttribute("open");
          }
        });
    }
  });
});

برخی از نسخه‌های قدیمی مرورگرها این رویداد toggle فعال نمی‌کنند. در آن مرورگرها کد polyfill کاری انجام نمی دهد. از نظر افزایش تدریجی ، این رفتار قابل قبول است.