iter(g111): 面包屑支持超长路径折叠

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T06:03:06.956Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T06:04:26.861Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -372,6 +372,7 @@ accordion({ items: [{ value: 'a', title: '账户设置', content: '内容…' },
 - items（必填）：BreadcrumbItem[] —— 路径条目：{ label, href? }，末项自动视为当前页
 - separator（默认 /）：string —— 分隔符；缺省 '/'
 - onNavigate（回调）：(item, index) => void —— 无 href 条目的点击回调
+- maxItems：number —— 最多展示几项：超出时首项之后折叠成「…」按钮（aria-label 报出折叠条数），点开即完整展开；缺省不折叠
 
 示例：
 
@@ -385,6 +386,7 @@ breadcrumb({ items: [{ label: '首页', href: '/' }, { label: '设置' }, { labe
 2. 需要真实跳转就给条目加 href（渲染 <a>）；单页应用想自行接管时不给 href，改用 onNavigate 回调
 3. 改分隔符传 separator，如 '›'；分隔符对读屏隐藏
 4. 语义结构为 nav + ol + li，可直接放进页头或卡片标题栏
+5. 路径过深时传 maxItems（如 4）：首项 + 「…」+ 末几项，点「…」原地展开全部，末项始终是当前页
 
 现场演示：apps/docs/demo.html#sec-breadcrumb