agentcss 0.25.5 → 0.26.0

package/03-patterns/pagination/pagination.js

@@ -137,12 +137,39 @@
 
   /* ---------------------------------------------------------------------- */
 
-  function Pagination(node) {
+  /* 读屏文案默认值（F2 / 0.26.0）。值是字符串或函数；
+     不传 `labels` 时输出与之前逐字相同。 */
+  var DEFAULT_LABELS = {
+    nav: '分页',
+    prev: '上一页',
+    next: '下一页',
+    page: function (p, isCurrent) {
+      return '第 ' + p + ' 页' + (isCurrent ? '（当前页）' : '');
+    },
+    status: function (page, pages) { return '第 ' + page + ' 页 / 共 ' + pages + ' 页'; },
+    live: function (page, pages) { return '第 ' + page + ' 页，共 ' + pages + ' 页'; }
+  };
+
+  /* ==== BEHAVIOR INJECT BEGIN: labels ==== */
+  var flLabels = function (defaults, src) {
+    src = src || {};
+    var out = {};
+    var k;
+    for (k in defaults) {
+      if (Object.prototype.hasOwnProperty.call(defaults, k)) {
+        out[k] = (src[k] === undefined || src[k] === null) ? defaults[k] : src[k];
+      }
+    }
+    return out;
+  };
+  /* ==== BEHAVIOR INJECT END: labels ==== */
+  function Pagination(node, opts) {
     this.node = node;
+    this.labels = flLabels(DEFAULT_LABELS, opts && opts.labels);
     this.total = Math.max(1, parseInt(node.getAttribute('data-total') || '1', 10));
     this.size = Math.max(1, parseInt(node.getAttribute('data-page-size') || '20', 10));
     this.page = Math.max(1, parseInt(node.getAttribute('data-page') || '1', 10));
-    this.label = node.getAttribute('aria-label') || '分页';
+    this.label = node.getAttribute('aria-label') || this.labels.nav;
     this.pages = Math.max(1, Math.ceil(this.total / this.size));
     this.onChange = null;
 
@@ -301,7 +328,7 @@
   /** ⭐ 播报（依据第 2 条：改 textContent，不换元素） */
   Pagination.prototype.announce = function () {
     if (!this.liveNode) return;
-    this.liveNode.textContent = '第 ' + this.page + ' 页，共 ' + this.pages + ' 页';
+    this.liveNode.textContent = this.labels.live(this.page, this.pages);
   };
 
   Pagination.prototype.render = function () {
@@ -309,6 +336,7 @@
     var L = this.listNode;
     while (L.firstChild) L.removeChild(L.firstChild);
     var self = this;
+    var T = this.labels;
 
     function addBtn(text, ariaLabel, goto, disabled) {
       var li = el('li', 'pagination__item');
@@ -325,7 +353,7 @@
     }
 
     /* --- 上一页 / 首页 --- */
-    addBtn('‹', '上一页', 'prev', self.page <= 1);
+    addBtn('‹', T.prev, 'prev', self.page <= 1);
     /* --- 页码 --- */
     var win = pageWindow(self.page, self.pages, SLOTS);
     for (var i = 0; i < win.length; i++) {
@@ -347,7 +375,7 @@
       var b2 = el('button', 'pagination__link', String(p));
       b2.type = 'button';
       b2.setAttribute('data-goto', String(p));
-      b2.setAttribute('aria-label', '第 ' + p + ' 页' + (isCur ? '（当前页）' : ''));
+      b2.setAttribute('aria-label', T.page(p, isCur));
       if (isCur) {
         b2.setAttribute('aria-current', 'page');
         b2.setAttribute('aria-disabled', 'true');
@@ -356,22 +384,21 @@
       L.appendChild(li2);
     }
     /* --- 下一页 / 末页 --- */
-    addBtn('›', '下一页', 'next', self.page >= self.pages);
+    addBtn('›', T.next, 'next', self.page >= self.pages);
 
     /* --- 可见状态（"第 2 页 / 共 12 页"） --- */
     if (this.statusNode) {
-      this.statusNode.textContent =
-        '第 ' + self.page + ' 页 / 共 ' + self.pages + ' 页';
+      this.statusNode.textContent = T.status(self.page, self.pages);
     }
   };
 
   /* ---------------------------------------------------------------------- */
   var API = {
     /** 创建一个分页实例（返回实例以便绑定 onChange） */
-    create: function (node) {
+    create: function (node, opts) {
       if (!node) return null;
       if (node.__pg) return node.__pg;
-      node.__pg = new Pagination(node);
+      node.__pg = new Pagination(node, opts);
       return node.__pg;
     },
     /** 页面内所有 [data-pagination] */

package/03-patterns/tooltip/tooltip.js

@@ -125,6 +125,21 @@ var flDismissable = function (opts) {
 
   var uid = 0;
 
+  /* 读屏文案默认值（F2 / 0.26.0）。
+     本组件是 `attach(el, text)` 形式、没有逐实例 opts，
+     所以文案用**模块级**设置：`Tooltip.setLabels({ region: 'Tooltip' })`。 */
+  var LABELS = { region: '组件提示' };
+
+  function setLabels(patch) {
+    if (!patch) return;
+    for (var k in LABELS) {
+      if (Object.prototype.hasOwnProperty.call(LABELS, k)
+        && patch[k] !== undefined && patch[k] !== null) {
+        LABELS[k] = patch[k];
+      }
+    }
+  }
+
   function ensureStyle() {
     if (document.getElementById('tooltip-css')) return;
     /* 说明：样式由页面通过 <link> 引入；这里只做"有没有"的提示，
@@ -149,7 +164,7 @@ var flDismissable = function (opts) {
        而在读屏用户"到达"它之前它通常是空的
        ⇒ 光靠内容拿不到名字 ⇒ 必须显式给 aria-label。
        label 用通用措辞，具体内容由 aria-live 负责播报。 */
-    r.setAttribute('aria-label', '组件提示');
+    r.setAttribute('aria-label', LABELS.region);
     r.style.cssText =
       'position:absolute;width:1px;height:1px;padding:0;margin:-1px;' +
       'overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0';
@@ -280,5 +295,5 @@ var flDismissable = function (opts) {
     el.setAttribute('data-tooltip', text);
   }
 
-  global.Tooltip = { attach: attach };
+  global.Tooltip = { attach: attach, setLabels: setLabels };
 })(typeof window !== 'undefined' ? window : globalThis);

package/03-patterns/tree/tree.js

@@ -231,11 +231,31 @@
   var uid = 0;
 
   function create(root, opt) {
+    /* 读屏文案默认值（F2 / 0.26.0）。不传 `labels` 时输出逐字不变。 */
+    var DEFAULT_LABELS = {
+      tree: '树形视图'
+    };
+
+    /* ==== BEHAVIOR INJECT BEGIN: labels ==== */
+    var flLabels = function (defaults, src) {
+      src = src || {};
+      var out = {};
+      var k;
+      for (k in defaults) {
+        if (Object.prototype.hasOwnProperty.call(defaults, k)) {
+          out[k] = (src[k] === undefined || src[k] === null) ? defaults[k] : src[k];
+        }
+      }
+      return out;
+    };
+    /* ==== BEHAVIOR INJECT END: labels ==== */
+  var L = flLabels(DEFAULT_LABELS, opt && opt.labels);
+
     opt = opt || {};
     root.classList.add('tree');
     if (!root.getAttribute('role')) root.setAttribute('role', 'tree');
     if (!root.getAttribute('aria-label') && !root.getAttribute('aria-labelledby')) {
-      root.setAttribute('aria-label', opt.label || '树形视图');
+      root.setAttribute('aria-label', opt.label || L.tree);
     }
 
     /* ---------- 初始化结构 ---------- */

package/04-recipes/analysis-report/demo.html

@@ -98,7 +98,7 @@
           每组成 2 个平行样，取算术平均。
         </p>
 
-        <pre class="report__code">电解液     1 M LiPF6 in EC:EMC:DMC = 3:5:2 (v/v) + 2 wt% VC
+        <pre class="report__code" tabindex="0">电解液     1 M LiPF6 in EC:EMC:DMC = 3:5:2 (v/v) + 2 wt% VC
 截止电压   3.0 – 4.4 V (vs. Li/Li+)
 倍率       0.5C 充电 / 1.0C 放电
 温度       25 ± 1 °C

package/04-recipes/data-showcase/demo.html

@@ -112,7 +112,7 @@
   多级表头用 <code>scope</code> 标明层级。
 </p>
 
-<div class="table table--academic">
+<div class="table table--academic" tabindex="0" role="region" aria-label="三种干燥工艺的成品性能对比（可横向滚动）">
   <table>
     <caption class="table__cap">表 1 · 三种干燥工艺的成品性能对比（示例数据）</caption>
     <thead>
@@ -157,7 +157,7 @@
   不能用同一个数字格式化函数打发。<strong>本表不推断显著性，也不计算统计量。</strong>
 </p>
 
-<div class="table table--stats">
+<div class="table table--stats" tabindex="0" role="region" aria-label="干燥工艺对含水率的影响（可横向滚动）">
   <table>
     <caption class="table__cap">表 2 · 干燥工艺对含水率的影响（OLS 估计，示例数据，n = 60）</caption>
     <thead>