Merge branch '3511296-library-js-block' into '5.x'

Issue 3511296: Adding JS Block library tool

See merge request !192

components/07-utilities/js-block-link/js-block-link.js

+(()=>{function a(t){var a,e=t.target.closest(".js--block-link");e&&"A"!==t.target.tagName&&(a=e.getAttribute("data-href"),e=e.getAttribute("data-target"),t.metaKey&&a||"_blank"===e?window.open(a,"_blank"):a&&(window.location.href=a))}var t,e;t=Drupal,e=once,t.behaviors.blockLink={attach(){e("blockLink","body").forEach(t=>{t.addEventListener("click",a)})}}})();
\ No newline at end of file

components/07-utilities/js-block-link/src/js-block-link.js

+/**
+ * @file
+ * Enhances block elements with the `.js--block-link` class and relevant data attributes
+ * to behave as clickable links.
+ *
+ * This behavior allows users to click anywhere on a block to navigate to a URL
+ * specified in the `data-href` attribute, while ensuring that internal `<a>` links
+ * still function normally. It also respects command/ctrl-click for opening in a new tab.
+ */
+
+((Drupal, once) => {
+  /**
+   * Handles clicks on elements with the `.js--block-link` class.
+   *
+   * If the clicked element (or its closest parent) contains `data-href`,
+   * the browser navigates to that URL. The function respects:
+   * - Internal `<a>` links (which function as normal).
+   * - Command/ctrl-click behavior for opening links in a new tab.
+   * - The `data-target="_blank"` attribute for forcing new tab behavior.
+   *
+   * @param {MouseEvent} event - The click event.
+   */
+  function handleBlockLinkClick(event) {
+    const blockLinkElement = event.target.closest('.js--block-link');
+    if (!blockLinkElement) return;
+
+    // Allow internal <a> links to function as normal.
+    if (event.target.tagName === 'A') return;
+
+    const href = blockLinkElement.getAttribute('data-href');
+    const dataTarget = blockLinkElement.getAttribute('data-target');
+
+    if ((event.metaKey && href) || dataTarget === '_blank') {
+      window.open(href, '_blank');
+    } else if (href) {
+      window.location.href = href;
+    }
+  }
+
+  Drupal.behaviors.blockLink = {
+    attach() {
+      once('blockLink', 'body').forEach((element) => {
+        element.addEventListener('click', handleBlockLinkClick);
+      });
+    },
+  };
+})(Drupal, once);

prototype.libraries.yml

@@ -56,6 +56,7 @@ splide:
     'https://cdn.jsdelivr.net/npm/@splidejs/splide@4.1.4/dist/js/splide.min.js': { type: external, minified: true }
 
 
+
 #
 # Page specific libraries
 #
@@ -63,3 +64,15 @@ page-basic:
   css:
     theme:
       components/05-pages/basic/basic.css: {}
+
+
+#
+# Utility libraries
+#
+
+js-block-link:
+  js:
+    07-utilities/js-block-link/js-block-link.js: {}
+  dependencies:
+    - core/drupal
+    - core/once