Merge branch 'release/v1.47.0' into fix/image-aspect-ratio

packages/web-components/src/components/table-of-contents/table-of-contents.ts

@@ -187,6 +187,12 @@ class DDSTableOfContents extends HostListenerMixin(
    */
   private _tagNamesToAvoid = [`${ddsPrefix}-video-player`];
 
+  /**
+   * The name of an attribute that will prevent the DOM element and any elements
+   * in its subtree from being added to the ToC.
+   */
+  private _disableTargetAttribute = 'no-toc';
+
   /**
    * Boolean checking if page is RTL
    */
@@ -363,7 +369,10 @@ class DDSTableOfContents extends HostListenerMixin(
    * Sets targets used for generating the table of contents.
    */
   private _setTargets(nodes: Node[]) {
-    const { _tagNamesToAvoid: tagNamesToAvoid } = this;
+    const {
+      _tagNamesToAvoid: tagNamesToAvoid,
+      _disableTargetAttribute: disableTargetAttribute,
+    } = this;
     const { selectorTarget } = this.constructor as typeof DDSTableOfContents;
     this._targets = nodes.reduce((acc, node) => {
       if (node instanceof HTMLElement) {
@@ -376,9 +385,9 @@ class DDSTableOfContents extends HostListenerMixin(
             elem.innerText.match(notWhiteSpace) ||
             elem.dataset.title?.match(notWhiteSpace);
           const hasNameAttr = elem.matches(selectorTarget);
-          const notExcluded = !tagNamesToAvoid.includes(
-            elem.tagName.toLowerCase()
-          );
+          const notExcluded =
+            !tagNamesToAvoid.includes(elem.tagName.toLowerCase()) &&
+            !elem.closest(`[${disableTargetAttribute}]`);
 
           return hasTitle && hasNameAttr && notExcluded;
         });