@daoyi/nmtl-ui 2.0.1-beta.122 → 2.0.1-beta.126

package/lib/components/{ForwardLink-e86c1080.js → ForwardLink-fec856b3.js}

@@ -1,9 +1,9 @@
 import { c as _objectWithoutProperties } from './_rollupPluginBabelHelpers-a52356f6.js';
-import React__default, { useMemo } from 'react';
+import React__default, { useMemo, useCallback } from 'react';
 import PropTypes from 'prop-types';
 import { c as classNames } from './index-b76a85f4.js';
 import { q as queryString } from './index-b47819f3.js';
-import { useHistory, Link } from 'react-router-dom';
+import { useHistory } from 'react-router-dom';
 import { Tooltip } from '@material-ui/core';
 import { getIntl } from './globalConfig';
 import { s as styleInject } from './style-inject.es-1f59c1d0.js';
@@ -14,6 +14,21 @@ styleInject(css_248z);
 var _excluded = ["className", "linkClassName", "title", "target", "disabled", "children", "tip", "onClick"];
 var locale = '/zh-tw'; // 20230318 暫時寫死，若套件納入語系控制，可將其置換
 
+/*
+ * ⚠️ 本元件刻意「不輸出 href 屬性」，請勿改回 <a> 或 react-router <Link>。
+ *
+ * 原因（2026-09-04 開發團隊決議，見 nmtl-web/docs/a11y/freego-scan-scope-plan-2026-09-04.md）：
+ * 無障礙檢測工具 Freego 只抽取 DOM 中真實存在的 a[href]/area[href]/iframe[src]/frame[src]，
+ * 且去重是完整網址字串精確比對。本元件產生的是 ?id= 明細頁連結，資料有幾筆就展開幾頁，
+ * 再乘上九個子站前綴，測試站實測達 3297 頁 / 約 24 小時。改為程式導頁後，
+ * 內容明細頁不再進入爬取佇列，只留主選單、麵包屑、網站導覽等結構性連結（仍為真 <a href>）。
+ *
+ * 可及性補償：以 role="link" 保留連結語意（非 role="button"，遵循規範 03-aria-patterns §1
+ * 「導覽連結不可掛 role=button」），並自備 tabIndex 與 Enter 鍵啟動，
+ * 讀屏軟體仍會朗讀為連結、鍵盤仍可操作。焦點框由各站 a11y.scss 的
+ * [tabindex]:focus / [role='link']:focus 規則涵蓋。
+ * 已知取捨：失去中鍵／Ctrl+點擊另開分頁、右鍵複製網址等瀏覽器原生行為。
+ */
 var ForwardLink = function ForwardLink(_ref) {
   var className = _ref.className,
     linkClassName = _ref.linkClassName,
@@ -21,17 +36,17 @@ var ForwardLink = function ForwardLink(_ref) {
     target = _ref.target,
     disabled = _ref.disabled,
     children = _ref.children,
-    tip = _ref.tip;
-    _ref.onClick;
-    var rest = _objectWithoutProperties(_ref, _excluded);
+    tip = _ref.tip,
+    onClick = _ref.onClick,
+    rest = _objectWithoutProperties(_ref, _excluded);
   var history = useHistory();
   var _useMemo = useMemo(function () {
       var _rest$pathname;
       if (disabled) return {};
-      /*
-       * 若將 search 寫在 pathname 中，意即 pathname=/asd?zxc=qwe
-       * 會導致換頁時 React route dom 無法匹配 => 空白畫面
-       * 若真有此情況發生 需把 search 提領出來
+      /*
+       * 若將 search 寫在 pathname 中，意即 pathname=/asd?zxc=qwe
+       * 會導致換頁時 React route dom 無法匹配 => 空白畫面
+       * 若真有此情況發生 需把 search 提領出來
        */
       var foundIndex = (_rest$pathname = rest.pathname) === null || _rest$pathname === void 0 ? void 0 : _rest$pathname.indexOf('?');
       if (foundIndex > -1) return {
@@ -48,36 +63,65 @@ var ForwardLink = function ForwardLink(_ref) {
     _useMemo$search = _useMemo.search,
     search = _useMemo$search === void 0 ? '' : _useMemo$search;
 
+  /* 導頁：target="_blank"（預設值）沿用原本 <a target="_blank"> 的另開分頁行為，
+     其餘 target 走 SPA 換頁。history.createHref 會自動套上 Router 的 basename
+     （各站的 contextRoot），與原本 <Link> 產出的網址一致。 */
+  var go = useCallback(function () {
+    if (onClick && onClick() === false) return;
+    var to = {
+      pathname: "".concat(locale).concat(pathname),
+      search: search
+    };
+    if (target === '_blank') {
+      window.open(history.createHref(to), '_blank', 'noopener,noreferrer');
+      return;
+    }
+    history.push(to);
+  }, [history, onClick, target, pathname, search]);
+
+  /* role="link" 依 ARIA APG 僅以 Enter 啟動（不綁 Space，那是 role="button" 的行為） */
+  var handleKeyDown = useCallback(function (event) {
+    if (event.key === 'Enter') {
+      event.preventDefault();
+      go();
+    }
+  }, [go]);
+
   /* WAVE: Redundant title text — title 與連結內文相同時不輸出，避免輔具重複朗讀 */
   var domTitle = tip || typeof children === 'string' && children === title ? undefined : title;
   /* WCAG 3.2.x 另開新視窗預告：target="_blank" 時以 aria-label 註明 */
   var newWindowLabel = target === '_blank' && (typeof children === 'string' || title) ? "".concat(typeof children === 'string' ? children : title).concat(getIntl().formatMessage({
     id: 'aria.newWindow'
   })) : undefined;
-  /* R24：aria-label 已含 title 全文時不再輸出 title 屬性——NVDA 會把 title 屬性當
+  /* R24：aria-label 已含 title 全文時不再輸出 title 屬性——NVDA 會把 title 屬性當
      description 接在 aria-label 之後再唸一次，造成「書名 ×2」（abo 首頁推薦卡實測） */
   var linkTitle = newWindowLabel ? undefined : domTitle;
+
+  /* 沒有可及名稱的連結對所有使用者都無用，且會被判 Freego HM1240401C
+     （實測 ocean books?id=ART469770：某筆資料人名為空 → 連結內容全空）。
+     children 為空字串／空值且無 title 時，改以非互動元素呈現。 */
+  var namelessChildren = children === undefined || children === null || children === false || typeof children === 'string' && !children.trim();
+  var nameless = namelessChildren && !title;
   var linkComponent = /*#__PURE__*/React__default.createElement("div", {
     className: className
   }, /*#__PURE__*/React__default.createElement("div", {
     className: "forwardLink"
-  }, disabled ? /*#__PURE__*/React__default.createElement("div", {
+  }, disabled || nameless ? /*#__PURE__*/React__default.createElement("div", {
     title: domTitle,
     className: classNames('forwardLink__link--disabled', linkClassName)
   }, children) :
   /*#__PURE__*/
-  /* linkClassName 直接掛在可聚焦的 <a> 上：消費端的 ellipsis/overflow 樣式若掛在
-     外層 className（包裹 div），會裁掉 <a> 的焦點框（WCAG 2.4.7 走查實測）——
+  /* linkClassName 直接掛在可聚焦元素上：消費端的 ellipsis/overflow 樣式若掛在
+     外層 className（包裹 div），會裁掉焦點框（WCAG 2.4.7 走查實測）——
      此類樣式應改傳 linkClassName */
-  React__default.createElement(Link, {
+  React__default.createElement("span", {
+    role: "link",
+    tabIndex: 0,
     className: classNames('forwardLink__link', linkClassName),
-    target: target,
     title: linkTitle,
     "aria-label": newWindowLabel,
-    to: {
-      pathname: "".concat(locale).concat(pathname),
-      search: search
-    }
+    onClick: go,
+    onKeyDown: handleKeyDown
   }, children)));
   if (tip) {
     return /*#__PURE__*/React__default.createElement(Tooltip, {
@@ -105,11 +149,11 @@ ForwardLink.defaultProps = {
 ForwardLink.propTypes = {
   /** Css Name（掛在外層包裹 div；帶 overflow/ellipsis 的樣式請改用 linkClassName，否則會裁掉焦點框） */
   className: PropTypes.string,
-  /** 直接掛在可聚焦 <a> 上的 Css Name */
+  /** 直接掛在可聚焦元素上的 Css Name */
   linkClassName: PropTypes.string,
   /** DOM title */
   title: PropTypes.string,
-  /** DOM title */
+  /** 導頁方式：'_blank' 另開分頁（預設），其餘走 SPA 換頁 */
   target: PropTypes.oneOf(['_self', '_blank', '_parent', '_top']),
   /** 是否取消點擊 */
   disabled: PropTypes.bool,

package/lib/components/ForwardLink.js

@@ -1,4 +1,4 @@
-export { F as default } from './ForwardLink-e86c1080.js';
+export { F as default } from './ForwardLink-fec856b3.js';
 import './_rollupPluginBabelHelpers-a52356f6.js';
 import 'react';
 import 'prop-types';

package/lib/components/KeywordTicker.js

@@ -2,7 +2,7 @@ import { a as _slicedToArray } from './_rollupPluginBabelHelpers-a52356f6.js';
 import React__default, { useState, useRef, useEffect } from 'react';
 import PropTypes from 'prop-types';
 import { c as classNames } from './index-b76a85f4.js';
-import { F as ForwardLink } from './ForwardLink-e86c1080.js';
+import { F as ForwardLink } from './ForwardLink-fec856b3.js';
 import { getIntl } from './globalConfig';
 import { s as styleInject } from './style-inject.es-1f59c1d0.js';
 import './index-b47819f3.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@daoyi/nmtl-ui",
-	"version": "2.0.1-beta.122",
+	"version": "2.0.1-beta.126",
 	"description": "This project is to be used as a starter kit for building React component using Storybook and Rollup",
 	"author": "daoyi",
 	"main": "lib/index.js",