更新日志
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]
按《问题与修改清单.md》做的一轮全库修复。下面的【行为变化】升级时要留意;只是修 bug、结果和文档写的一致的,归在 Fixed 里按组件概括。清单里“待确认”的条目都没有改。
Changed(行为变化)
工程和公共部分
- 最低版本改为 Vue 3.5、Node 20.19。vue-router 改为可选的 peer 依赖,不再打进产物。
- 入口不再导出
defaultType、zIndex,弹层层级起点统一用defaultInitialZIndex。 pnpm lint不再自动修复,改用pnpm lint:fix;提交时由 husky + lint-staged 跑 ESLint 和 Prettier。- Storybook 只扫
packages/components/src下的 story;story 标题按“基础、布局、表单、数据展示、导航、反馈”六类归类,story id 跟着变了(例如基础-button-按钮--basic),外部链接要更新。 - 主题:暗色下的浅底色按功能色计算;cyberpunk、luxury 调了部分颜色;删掉了临时别名变量(如
--ns-color-*-lightest)和 3 个没人用的 mixin。 - 控件尺寸:15 个控件的 large / default / small 高度统一为 40 / 32 / 24px;InputNumber 右侧按钮回到框内;Cascader、TreeSelect 的 large 多选标签改用 default 尺寸。
@ns/utils:throttle会补执行间隔内的最后一次调用;debounce、throttle返回的函数传递this;isEmpty、kebabCase的边界行为有调整。- ConfigProvider 的
size、zIndex开始生效:- 有
size属性的组件(Button、表单控件、Form、FormItem、Avatar、Chip、Descriptions、List、Space、Spin、Table、Tag 等)不写size时跟随它,这些组件的size默认值改为undefined。优先级是“自身 > 组 / FormItem / Form > ConfigProvider >'default'”。 - 模板里直接使用的弹层(下拉面板、Menu 的子菜单浮层、Dropdown、Popover、Popconfirm、Tooltip、Modal、Drawer、
<NsLoading>等)的 z-index 从样式表移到内联样式,读它的zIndex,默认 2000;样式表里覆盖这些弹层 z-index 的写法不再生效。Modal、Drawer 上使用者写的style优先。 - 不读的:Message、Notification(固定 9999)、MessageBox(从 2001 递增)、
v-loading指令和NsLoadingService(固定 2000)。它们都是单独创建的应用,读不到 ConfigProvider。 locale、namespace仍未生效。
- 有
表单
- 20 个表单控件接入 NsForm:跟随表单的禁用和尺寸,表单禁用优先于控件自己的
:disabled="false";14 个控件的size默认值改为undefined(不在表单里时渲染结果不变,但props.size读到的值变了);用程序改 model 也会触发 change 规则。 - Form:
validate()也校验 FormItem 自己的rules;非必填的空值不再走其余规则;数字的 min / max 按数值比较;label 有id、for,错误提示带role="alert";表单禁用时内容区不再半透明;large、small 表单项的行高改为 40、24px,输入类控件顶端对齐,错误提示 12px。 - Input、Textarea、InputNumber、AutoComplete:
inheritAttrs: false,name、id、aria-*、data-*、title和没声明的事件监听从外层 div 改到原生控件上,class、style留在根元素。控件上写的id优先于 FormItem 生成的,FormItem 标签的for跟着它。 - Input:清空时发
change('');输入法组合期间不发事件。 - Textarea:边框移到 textarea 上;autosize 写了
minRows时按它算最小高度,可以比rows矮。 - InputNumber:失焦不再提交;值没变时不发事件;加减时发 change;拒绝
0x10、1e3这类写法。 - AutoComplete:focus、blur 改为真实的焦点事件;
inputRef改为 ref;placement、debounce挂载后再改也生效;清空按钮改成<button>,清空时依次发update:modelValue、input、change('')、clear。 - InputTag:有重复标签时按下标删除;达到
max后输入框只读、不再禁用;expose 去掉inputValue、canAddTag。 - Mentions:expose 只保留
focus、blur、textareaRef;删除内部类型MentionsContext、MENTIONS_INJECTION_KEY(原来就没有导出);下拉层对齐外框;没有匹配项时回车照常换行。 - Upload:只传
:file-list时内部列表也会变化;abort(file)后文件回到 ready;图标和删除按钮改用 NsIcon;拖拽区改成竖排并加上传图标(用 trigger 插槽时不显示),删除按钮改成图标按钮。 - Checkbox:禁用时不再半透明;焦点环只在键盘聚焦时显示;
min、max为 0 表示不限制;对勾和半选横线改用样式画,DOM 里不再有“✓”“-”字符。 - Radio:label 上不再有
role="radio";自动生成的组名改用useId,格式变了。 - Rate:鼠标离开整个组件才恢复显示;点当前分数不发事件。Switch:small 尺寸文字 12px。
- Slider:拖动改用 Pointer Events;End 跳到不超过最大值的最后一个步长点;选中范围内的标记带
ns-slider__mark--active。 - Segmented、Select、Cascader、TreeSelect、Transfer、DatePicker、TimePicker:禁用时不再整体半透明,改用禁用色。
- Select:全选时保留已选项,再按顺序补到
max。Cascader:标签的 key 改用JSON.stringify(path)。Transfer:每个列表只有一个 Tab 停留点。 - DatePicker、TimePicker:面板第一次打开前不渲染(body 下没有下拉层元素);尺寸跟随 Form 和 ConfigProvider;弹层 z-index 改成内联样式(读 ConfigProvider 的
zIndex),在样式表里覆盖下拉层的 z-index 不再生效。 - DatePicker:面板不翻到公元 100 年以前;月格、年格、头部的年月标签、“今天”和快捷选项都改成了
<button>(自己写的样式选择器可能受影响);输入框按 ↓ 打开面板,已打开时把焦点移进面板;在面板最后一个可聚焦元素上按 Tab(或第一个上按 Shift+Tab)关闭面板,焦点回到输入框。 - TimePicker:输入框上按 Tab 改为进入面板(原来是关闭面板),Shift+Tab 关闭面板;在“确定”上按 Tab 关闭面板、不提交;“取消”“确定”上按回车走原生点击(原来在“取消”上按回车也会提交);Esc、确定、取消之后焦点回到输入框。
- ColorPicker:输入框里的值没变时,不再发
update:modelValue、change、activeChange;不透明度百分比只在 large 尺寸显示。 - Cascader:不带 tooltip 时,折叠的“+N”改成标签,和 Select 一致。
基础和布局
- Button:不写
type时size="large"也生效;小号字 12px;popover 默认悬停触发,徽标默认在右上角;自定义颜色输出内联样式;图标在上、下时竖排;读取 ConfigProvider 的size和button配置,优先级“按钮自身 > 按钮组 > button 配置 > size”。 - Button:朴素(
plain)按钮改成浅色底、浅色边框、彩色文字(和 Tag 的浅色效果一样),悬停时变成实心;以前和描边(outline)按钮看不出区别。自定义color时用它混出浅色底和浅色边框。 - ButtonGroup:样式文件开始生效;组的属性改了,组内按钮跟着变;只在没有间距、网格、分割线时合并边框;删掉
.ns-button--in-group的样式。 - ConfigProvider:配置改为响应式,注入的是 ComputedRef;不传
theme时不再改<html>,卸载时恢复原来的主题;context 里没设 theme 时是undefined。 - Typography:Paragraph 的多行截断开始生效,只在溢出时显示“展开”;Text 省略时根元素改为 inline-flex;复制、展开按钮改为
<button>;del、mark 的颜色跟随 type。 - Divider:线条改为 1px 主题边框色;竖线至少 1em 高,左右边距从 16px 改为 8px。
- Link:不带
href时带role="button"、tabindex="0";_blank链接加rel="noopener noreferrer"。 - Space:容器改成 inline-flex。Grid:断点改成 min-width 向上继承,span 为 0 时隐藏。
- Layout:有 Sider 时自动横排;触发条是
<button>,不再盖住内容,trigger插槽带{ collapsed }。 - Splitter:
resize事件参数改成像素数组;自适应面板改为flex: 1 1 0%;PaneInfo结构变了;改用 Pointer Events。
数据展示
- Avatar:头像组的重叠布局生效;组里每个头像自己写的属性优先于组的设置;数字尺寸时文字和图标跟着缩放。
- Badge:右侧徽章的中心对准元素的角;数字动画改用 transition(DOM 里不再有
--old/--new两个类);隐藏时淡出。 - Card:折叠、关闭按钮改成
<button>加图标;点 header-extra 不再折叠;small、large 的标题字号变了。 - Carousel:不传
height时高 300px(原来是 0);卡片模式下两侧卡片可以点击切换;删掉当前项后修正序号并发事件;loop=false时到头的箭头禁用。 - Calendar:日期格子平分整行。Collapse:切成手风琴时发
update:modelValue。 - Chip:中文名改为“碎片标签”(story id 跟着变);移除按钮改成原生按钮;组禁用时子项写
:disabled="false"可以单独启用;三个尺寸固定高度,large 字号 16px。 - Tag:关闭按钮改成原生按钮,回车、空格的 keydown 不再冒泡;三个尺寸固定高度。
- Image:DOM 里只剩一个 img;在 Modal 里按 Esc 只关预览;
close在离场动画结束后发出;预览的关闭按钮改成<button>。 - Pagination:禁用时不再整体半透明。Tree:整棵树只有一个 Tab 停留点;禁用节点不再用 opacity。
- Statistic:设了
precision时一定补零;value支持数字字符串,非法值显示为空;动画从当前值过渡。 - Progress:环形画成整圆,仪表盘底部留缺口,
textInside的文字在已完成段的末端。 - Skeleton:包裹真实内容又没写 template 插槽时显示默认骨架;只有一个容器,
class、id等属性加在容器上。 - VirtualList:
height写在根节点上;DOM 多一层.ns-virtual-list__list;列表项不再自带 padding 和边框。 - InfiniteScroll:
distance改为提前触发的距离;loading为 true 时不触发加载。 - Log:滚离底部后不再自动滚动;
clearLogs()改成发update:logs和clear;虚拟模式每行单行显示、超出省略;普通模式保留空格并自动换行;显示 timestamp。 - Watermark:
width、height改为最小尺寸;offset改为整体平移;默认颜色跟随主题。 - Result:主图标 72px。
导航
- Menu:横向和折叠模式的子菜单改成 Teleport 到 body 的浮层(悬停延时 150ms),浮层模式下点标题只打开;
default-active指向子菜单里的项时自动展开;MenuItem、SubMenu 的index改为必填;内嵌子菜单去掉卡片样式,按层级缩进。 - Breadcrumb:不再 import vue-router,改从
$router取,没有路由时字符串to退化成普通链接;to类型放宽;新增href;按住修饰键点击交给浏览器;删掉ns-breadcrumb__link--active。 - Steps:横向布局重做,新增
ns-step--last;space改为每一步的尺寸。 - Tabs:关闭标签引起的切换不再调用
beforeLeave;禁用的标签不显示关闭按钮;card 风格重做(每个标签自带边框,选中的标签和内容区连在一起),line 风格在靠内容的一侧加一条通栏分隔线,border-card 的标签栏透出头部底色。 - Anchor:点击后锁定高亮并立即发 change;
show-rail=false时没有轨道;affix改成 sticky。 - Affix:DOM 变成外层
.ns-affix加内层.ns-affix__content,is-fixed在内层;监听目标优先级listenTo > target > window。 - Backtop:根元素是
<button>;z-index 从 1000 改为 1030(--ns-z-index-fixed);show区分受控和非受控。 - PageHeader:extra 移到标题右侧;返回按钮改成
<button>。
反馈
- Message:按“上一条底边 + offset”堆叠;关闭后真正移除;
onClose会被调用,而且只调一次。 - MessageBox:关闭后真正卸载;点遮罩能关;Esc 只关最上层;不再给 body 加类;不再改调用方传入的 options;传了
zIndex时用传入值;关闭按钮改用 NsIcon,.ns-message-box__close-icon类名不再存在。 - Notification:完整显示在角落里;按位置分组堆叠;宽度统一 330px;
closeAll也有离开动画。 - Loading:关掉后能再开;
v-loading按目标元素计数,最后一个关闭时还原 position 和类名;默认底色跟随主题;role 改成status。 - Spin:遮罩改成跟随主题的半透明。Alert:
border=false生效;右侧图标回到文字右边;close在点击时立即触发。 - Popconfirm:同时写 default 和 reference 插槽时以 reference 为准。Modal:关闭按钮改用 NsIcon,
.ns-modal__close-icon类名不再存在。Drawer:modal为 false 时没有aria-modal,Tab 也不再困在抽屉里。 - 尺寸统一(和 Button 用同一套):有
size的控件三档都是高 40 / 32 / 24px、字号 16 / 14 / 12px、圆角 8 / 6 / 4px、图标 18 / 16 / 14px。原来 small 用的是--ns-font-size-sm(主题里和 base 一样是 14px),圆角多数三档都是 6px,所以 small 的字会变小,large、small 的圆角会变。涉及 Input、Textarea、InputNumber、AutoComplete、InputTag、Mentions、Select、Cascader、TreeSelect、DatePicker、TimePicker、ColorPicker、Pagination、Tabs、Dropdown。 - 下拉面板跟着控件尺寸变:选项行高 40 / 不变 / 28px,字号 16 / 14 / 12px,左右内边距 16 / 12 / 8px(default 原来是 16px 的会窄 4px,例如 Dropdown 菜单项),展开后选项文字和输入框文字左边齐平。面板按尺寸加类名:
ns-select__dropdown--{size}、ns-cascader__dropdown--{size}、ns-tree-select__dropdown--{size}、ns-auto-complete__suggestions--{size}、ns-mentions__dropdown--{size}、ns-dropdown__menu--{size}。DatePicker、TimePicker、ColorPicker 的面板不随尺寸变。 - Textarea、Mentions:上下内边距按“一行时和同尺寸 Input 一样高”算,default 两行的 Textarea 从约 60px 变成 53px;Mentions 行高 default 22→21px、small 20→18px。
- InputNumber:两侧加减按钮宽 40 / 32 / 24px,图标 18 / 16 / 14px;右侧上下按钮宽 30 / 24 / 18px,箭头 14 / 12 / 10px(原来三档都是 24px 宽、12px 箭头)。
- 单个 Checkbox、Radio 有了尺寸,不写时按 FormItem、Form、ConfigProvider 取:方框、圆圈 18 / 16 / 14px,文字 16 / 14 / 12px。默认样式的 CheckboxGroup、RadioGroup 原来三档一样,现在也跟着变。Cascader、TreeSelect 面板里的复选框跟组件自己的尺寸;Tree 的复选框固定 default,不受外面的 Form、ConfigProvider 影响。
- Slider:
show-input的输入框原来固定是 small(24px 高),现在跟 Slider 的尺寸,default 下是 32px。 - Slider:轨道两端各缩进半个滑块(10 / 8 / 6px,竖向是上下两端),轨道比原来短一个滑块的宽度。原来滑块拖到最小、最大值时有一半露在组件外面,放进表单会贴住左边的标签文字。
show-input的输入框离轨道的间距从 16px 改成 8px,加上缩进,轨道末端到输入框还是 16px 左右。 - Upload:
accept现在对点击选择的文件也检查(原来只查拖拽的)。不符合accept或超过maxSize的文件不加入列表、不上传,触发reject。检查顺序是类型 → 大小 →limit→beforeUpload,被拒收的文件不计入limit。accept里写错的项(不是.开头也不是 MIME)和浏览器一样忽略,*/*当作不限制。 - Upload:照片墙(
list-type="picture-card")的上传入口改成排在卡片后面的 148px 虚线“+”方块,原来是卡片上面的“点击上传”按钮;trigger插槽的内容放进方块里。可以用回车、空格打开文件选择。开了drag时不变。 - Table、Descriptions、List:字号三档改成 14 / 14 / 12px(原来 16 / 14 / 14),三档的差别主要在内边距,同 Element Plus。Table 多选列的复选框跟表格尺寸。
- Pagination:
small不再推荐,改用size="small";small 下“共 N 条”“前往”这些文字也是 12px(原来 14px)。 - Button:只放图标时是正方形 40 / 32 / 24px(根元素加
ns-button--icon-only),插槽里的 NsIcon 跟按钮尺寸走,写在它上面的size不再生效;文字按钮、链接按钮不受影响。 - Typography:Text、Paragraph 的
size="sm"改成 13px(原来和 base 一样是 14px)。 - ColorPicker:箭头改用 chevron-down 图标,大小跟尺寸;触发器内边距按尺寸缩小,三档总宽 76 / 60 / 46px(原来 82 / 68 / 54);large 的透明度百分比改成贴着色块底边的一条。
- Timeline:竖线、节点和文字整体右移 2px,large 节点不再超出容器左边被裁掉。
- Card、Badge:
size改成large / default / small,medium保留为兼容值(等同 default,类型上标了@deprecated),不写时跟随 ConfigProvider(以前固定是 medium,不跟随)。不在 ConfigProvider 里时外观不变。类名改了:Card 的ns-card--size-small / medium / large改成ns-card--small / default / large,Badge 的ns-badge__content--medium改成--default,自己写的样式选中旧类名的要跟着改。 - Card:large 的底部文字 16px(原来 14px),副标题 14 / 12 / 12px(原来三档都是 12px),折叠和关闭图标 18 / 16 / 14px(原来三档都是 16px)。
Added
官网(
site/,VitePress):首页、指南、组件总览和 92 个组件页,中英双语。组件页由docs/components的文档生成,示例(1164 个)直接显示运行效果,可以展开代码、复制代码;侧边栏每个分类内按组件名排序、分类名后面标出组件数量;本地搜索;亮色、暗色和 NsUI 的主题变量同步,顶栏的调色板按钮切换 6 套配色方案(记住上次的选择,窄屏在展开的菜单里选)。英文先翻译了 4 篇指南,组件文档还没翻译的显示中文原文并加提示。pnpm build:site构建官网,Storybook 放在官网的/storybook/下。组件文档的示例:只写了模板、用到没定义的变量的示例(182 个)都补成了能单独运行的完整组件,官网上能直接看到效果;模板根上并排放的按钮、标签、提示等原来粘在一起(194 个示例),改用
NsSpace排开。之后按 Button 文档的样子给所有组件文档补了示例:有几个可选值的属性每个值都有效果可看,布尔属性、事件、插槽、方法都有示例,事件结果显示在页面上;能运行的示例从 743 个增加到 1164 个。补示例时顺带核对了 Props 表,补上漏写的validateEvent等属性、改正几处默认值。官网给大模型和 Agent 读的文档:
/llms.txt(所有页面的索引)、/llms-full.txt(所有页面合成一个文件),英文版在/en/下;每一页把地址里的.html换成.md就是它的 Markdown 原文。指南里的“LLMs”页说明用法,首页有入口。Form、FormItem、SearchForm:
label-position="float"浮动标签。标签放在输入框里当占位文字,获得焦点、有值或下拉面板打开时浮到上边框上,不占标签列,适合查询条件;带边框的输入类控件都支持(Input、Textarea、InputNumber、AutoComplete、InputTag、Mentions、Select、Cascader、TreeSelect、DatePicker、TimePicker、IconPicker),其他控件自动按标签在上方排。FormItem 新增labelPosition,可以单独设置一项。新增组件:
- Highlight 高亮文本:
text里按patterns(字符串或数组)高亮关键字,默认不区分大小写、按字面匹配(autoEscape为 false 时按正则,写错的正则被忽略并警告);重叠或相邻的词合并成一段,长的词优先;highlightTag、highlightClass、highlightStyle自定义高亮元素,默认是警告色浅底的<mark>;文字里的 HTML 原样显示。 - InputOtp 验证码输入:
v-model是字符串;length、mask、placeholder、allowInput、gap、block、inputmode、三档size;输入后跳下一格,退格、Delete、← →、Home、End,粘贴从当前格依次填入并过滤不允许的字符;第一格autocomplete="one-time-code",支持短信验证码自动填充;change、finish事件,focus(index?)、blur()方法;跟随 Form、FormItem、ConfigProvider 的尺寸和禁用,校验出错时每格边框变红。 - FloatButton 悬浮按钮、FloatButtonGroup 悬浮按钮组:圆形 / 方形、default / primary,
icon、description、tooltip、badge、href;menu插槽展开一组子按钮(点击或悬停触发,v-model:show-menu,支持方向键和 Esc);position默认fixed,z-index 跟随 ConfigProvider;按钮组负责定位,方形组连成一整块。 - Heatmap 热力图:按天显示数值的日历热力图,一列是一周。
data是{ date, value }[](date接受'YYYY-MM-DD'、时间戳、Date,按本地时区取日期,同一天的多条相加);默认显示到今天为止的 52 周,也可以用year或start/end指定;颜色分 5 级,type用主题功能色(跟随暗色主题),colors自定义;星期标签、月份标签、“少 … 多”图例可关,footer插槽;悬停、聚焦格子时显示共用的一个提示(unit、tooltip插槽),cell-click事件;first-day-of-week默认周一;role="grid",方向键逐格移动;loading占位;三档size。 - QrCode 二维码:内置编码器(UTF-8,中文可编,版本 1–40 自动选择,L/M/Q/H 纠错,8 种掩码择优),不依赖第三方库;canvas(按 devicePixelRatio 绘制)和 svg 两种渲染、中间图标(有图标时默认 H 级纠错)、颜色和留白、加载中 / 已过期状态(
refresh事件、status插槽),toDataURL()、toSvgString()导出 PNG、JPEG、WebP、SVG。编码器参照 Project Nayuki 的 QR Code generator(MIT),源码文件头保留了它的许可声明。
- Highlight 高亮文本:
新增组件和功能:
- ActionGroup 操作按钮组:按
max显示前几个操作,其余收进“更多”下拉菜单(“更多”也占一个位置);moreDisplay切换“更多”的样式:text(默认,文字加箭头)、text-count(文字后面跟收起的操作数)、count(+N胶囊)、icon(省略号图标);visible、disabled可以按row判断,先过滤再计数;点了操作触发action-click;支持trigger、size,键盘可以打开菜单、选中,收起后焦点回到“更多”。 - IconPicker 图标选择器:
v-model是图标名;面板顶部按名字搜索(不分大小写),内置图标分 5 组;icons限定可选范围(平铺,可以放自定义名字并配合icon插槽渲染);clearable、disabled、size、validateEvent,跟随 Form、FormItem;方向键在网格里移动,回车选中,Esc 关闭并回到触发器;事件change、clear、visible-change。 - SearchForm 查询表单(插槽写法):默认插槽放 NsFormItem,网格按
itemMinWidth自动分列,查询、重置按钮在最后一行最右边;collapseAfter加v-model:expanded折叠多余条件(收起的项值保留,重置时一起清空);输入框里按回车查询(输入法选词、textarea 里的回车不算);loading、showReset、按钮文字可改;actions插槽放额外按钮,跟随尺寸;size三档;暴露validate、resetFields、clearValidate。 - FormSection 表单分组:主色竖条标题加分隔线,
title、tip、extra插槽,collapsible加v-model:expanded折叠(高度动画,aria-expanded/aria-controls);size跟随所在 NsForm,标题 18 / 16 / 14px。 - Tree:
filterable在树上方显示搜索框,配套filterPlaceholder、filterNodeMethod、filterEmptyText;默认按节点文字过滤,不分大小写;命中的文字高亮(ns-tree__highlight);清空后恢复原来的展开状态。新增方法filter(keyword),外部输入框可以驱动过滤。 - Upload:
maxSize(单位字节)和reject事件,参数(file, reason: 'size' | 'type'),新增类型UploadRejectReason。
- ActionGroup 操作按钮组:按
主题:新增配色方案
jade翡翠绿(data-palette="jade"),以绿色为主,亮色主色#18a058,暗色主色#63e2b7。Storybook 工具栏和 playground 的配色切换里加了这一项。主题:控件高度变量
--ns-component-size-large / default / small。组件库:
useGlobalConfig();useFormItem(含id参数)及类型UseFormItemOptions、FORM_ITEM_INJECTION_KEY、FormItemInjection、FormValidateTrigger、FormItemValidateResult、FormInputAttrs;@ns/ui/global模板类型声明;20 个表单控件的validateEvent属性;useOverlay的trapFocus选项。图标:新增 phone、location,导出
IconName类型,NsIcon 的name有补全。@ns/utils:debounce、throttle返回的函数带cancel()。Form:validator 支持 callback、boolean、Promise、throw 四种写法;
trigger可以写成数组;prop支持嵌套路径;label-width="auto"。Input:prefix、suffix 插槽,
select()、clear()方法。InputNumber:加减按钮长按。InputTag:focus、blur 事件。AutoComplete:回调写法;
valueKey、selectWhenUnmatched生效;没有结果但写了 empty 插槽时照常打开。Mentions:下拉层跟随滚动、贴边翻转。Upload:
http-request可以返回 Promise;拖拽时按accept、multiple过滤;data里的 Blob 按文件发送。Popconfirm:title 插槽。Loading:
lock选项开始生效。DatePicker:范围选到一半时悬停预览。DatePicker 面板键盘操作:←→ 移一天,↑↓ 移一周,跨月自动翻页;月、年格 ←→ 移 1 格、↑↓ 移 4 格;回车或空格选中,选完焦点回到输入框;键盘聚焦日期时范围预览跟着变。TimePicker 时分秒列表:↑↓ 循环,Home / End 跳到首尾,回车确认。
Slider、ColorPicker、Splitter:支持触屏拖动。Splitter:min / max 约束生效,子元素不是面板时警告。
Carousel:
height。Statistic:groupSeparator。InfiniteScroll:reset()、InfiniteScrollExpose。Log:clear、update:logs事件。Menu:
icon属性、title 插槽。Layout:collapsedWidth=0时悬浮的触发条。Dropdown:方向类名跟着翻转。新导出
ChipGroupContext、AVATAR_GROUP_INJECTION_KEY、StatisticInstance。键盘和读屏:Menu、Steps、Avatar、Card、Chip、Tag、Image、ColorPicker(色板、色相条、透明度条)支持键盘操作;InputNumber(spinbutton)、AutoComplete、Mentions、Select、Cascader、TreeSelect(combobox)、Progress(progressbar)、Tooltip(aria-describedby)、Log(
role="log")补了 ARIA 属性。Storybook:每个组件补齐了缺的场景(v-model 场景显示当前值,事件结果显示在页面上);
docs/components/下的组件文档按统一结构重写,属性、事件、插槽、方法和源码一致。playground:按钮组演示页、“默认”配色;菜单按六类重排。
Switch:
shape属性,round(默认,轨道两端是半圆)、square(圆角长方形)。RadioGroup:
type="button"按钮样式,整排相连的按钮,外观和同尺寸的 Button 一致;size属性,不写时跟随 FormItem、Form、ConfigProvider。新类型RadioGroupType、RadioGroupSize。CheckboxGroup:
type="button"按钮样式和size属性,外观和 RadioGroup 的按钮样式一致。新类型CheckboxGroupType、CheckboxGroupSize。Tabs:
type="button",标签栏显示成一排相连的按钮(外观同 RadioGroup 的按钮样式,三档尺寸跟着size),四个方向、可关闭、可新增、stretch都支持。size属性:Textarea、Checkbox(单个)、Radio(单个)、Slider、Tabs、Dropdown、Pagination 新增,取值large / default / small。表单控件不写时跟随 FormItem、Form、ConfigProvider;Tabs、Dropdown、Pagination 跟随 ConfigProvider。Pagination 原来的small保留,size优先。新类型TextareaSize、CheckboxSize、RadioSize、SliderSize、TabsSize、DropdownSize、RateSize。ButtonGroup:根元素加
ns-button-group--{size},不写 size 时跟随 ConfigProvider。Spin:根元素加
ns-spin--{size},用 indicator 插槽时可以按它写样式。TimeSelect 时间段选择:从固定间隔的时间点里选一个时间(
start/end/step),值是HH:mm。支持minTime/maxTime联动禁用(开始—结束时间)、12 小时制等显示格式、输入过滤、可清空、原生name,接入 NsForm 的尺寸、禁用和校验。DynamicInput 动态录入:一组可增删、可上移下移的输入行,内置单个文本框(
input)和键值对(pair)两种预设,支持用插槽自定义行、on-create给新行初始值、min/max限制行数;跟随表单的尺寸和禁用,配合 NsFormItem 的数组路径逐行校验。OrganizationChart 组织架构图:按树形数据画部门、人员的上下级关系,用 CSS 画连线;支持自定义节点、节点类名、折叠(默认展开层级、指定 key、
v-model:expanded-keys、方法)、单选和多选、竖向和横向、内容过宽时滚动、键盘操作和读屏属性。Tour 漫游引导:用
steps一步步高亮页面元素并显示说明卡片。支持v-model:open/v-model:current、12 个方向、遮罩开关和颜色、高亮区域边距和圆角、主色卡片、步骤指示、按钮文字和插槽自定义;Esc 关闭,左右方向键切换。Scrollbar 滚动条:包住一块内容,用统一外观的细滚动条替换原生滚动条。悬停时显示、离开后淡出,可以拖动滑块、点轨道跳转,内容尺寸变化时自动更新;支持
height、max-height、always、min-size、native等属性和scrollTo、setScrollTop、setScrollLeft、update方法。LoadingBar 顶部加载条:页面顶部的细进度条,用
NsLoadingBar.start()/finish()/error()调用,自动缓慢前进,可以用config或start的参数设置颜色、出错色、高度和层级。Dropdown:分裂按钮
split-button。左边主按钮触发新事件button-click(不展开菜单),右边箭头按钮按trigger展开菜单,菜单项照常触发click、command;type设两个按钮的类型,arrow-label设箭头按钮的读屏名称,按钮跟随size、disabled。Input:
prepend、append插槽,在输入框外侧放文字、NsButton 或 NsSelect,和输入框连成一体(放按钮、选择器时合并边框);type="password"时用show-strength显示密码强度(弱、中、强),支持strength-method自定义规则、strength-texts、strength-label,并导出getPasswordStrength。浮动标签遇到前置内容时一直浮在边框上。Modal:
draggable,按住标题栏拖动对话框,拖不出可视区域,全屏时不能拖,关闭后再打开回到原位置。Select:远程搜索,
remote、remote-method(可以直接返回选项或 Promise,自动显示加载中并丢弃过期结果)、debounce,以及loading、loading-text、empty-text、no-match-text;选项换了一批后,已选项仍显示原来的文字。Select:
virtual虚拟滚动,上万个选项只渲染看得见的部分,键盘移动时自动滚动,可以配合搜索、多选、全选、远程搜索使用。Table:树形数据(
treeProps、indent,可以用load懒加载子行)、展开行(expandable、accordion、expand插槽)、合计行(showSummary、summaryText、summaryMethod)、合并单元格(spanMethod)、多级表头(列配置children)、带边框时拖动调整列宽(列配置resizable、minWidth,column-resize事件)、单元格超长省略并悬停提示(showOverflowTooltip);defaultExpandAll、defaultExpandedKeys、expand-change事件和toggleRowExpansion、expandAll、collapseAll方法。带边框的表格默认可以拖动列宽,列宽改写在<colgroup>里。Tree:懒加载子节点(
lazy、load,节点isLeaf/props.isLeaf,加载失败触发load-error,再次展开可以重试);拖拽移动节点(draggable、allow-drag、allow-drop,事件node-drag-start/enter/leave/over/end和node-drop,放下后直接修改data);虚拟滚动(virtual-scroll、height、item-size,上万个节点只渲染看得见的行,勾选、过滤、懒加载、键盘操作照常可用)。Popconfirm:
placement(12 个方向,默认top)、offset声明成正式的属性,有类型提示(原来只能靠透传给内部的弹出框)。SplitterPane:支持
v-model:size,拖动或用键盘调整后同步出这个面板的大小(单位和原来的写法一样),外面再设回预设值时面板恢复。
Fixed
- Space:竖排(
direction="vertical")时开fill,子元素没有拉伸,仍按内容宽度居中排列。现在每一格占满整行宽度,和文档说的“子元素被拉伸填满格子”一致;横排不变。 - FormItem:没写
label的表单项(如放提交按钮的一行)不留标签列,按钮贴在最左边,和上面的控件对不齐;现在留出标签宽度,标签在上方、浮动标签、行内表单和嵌套的表单项不留,写label-width="0"可以不留。 - Icon:图标样式给所有
<svg>设了fill: currentColor,盖掉了自定义图标写在<svg>上的fill="none",只用描边的图形被填满;现在只给没写fill的<svg>补文字颜色。 - Mentions:只读时把光标点进已有的“@xxx”里会弹出候选列表,选中后还会改掉值;现在只读、禁用时都不弹出。
- Loading:
visible在类型里是必填,只用 ref 的show()、close()控制、不传visible时控制台有缺少必填属性的警告;改成可选,默认false,和文档一致。 - Button:
popover-trigger="manual"时没有任何办法打开气泡提示。新增方法showPopover、hidePopover,任何触发方式都能用代码打开、关闭;没开popover、提示或按钮被禁用时showPopover不打开。 - 按清单修复全库 bug,涉及主题、图标、工具函数、组件库入口、usePopper 和全部 77 个组件。主要的几类:
- 弹层:Message、MessageBox、Notification、Loading 关闭后不卸载或不能再打开;Esc、滚动锁、焦点陷阱在多个弹层之间互相干扰。
- 响应式:provide 给子组件的是一次性的值,挂载后改属性不生效(Menu、Breadcrumb、Steps、Carousel、Avatar 等)。
v-for生成的子项没被识别、顺序错乱(AvatarGroup、ButtonGroup、Space、Steps、Carousel)。- 服务端渲染时访问
window报错(Anchor、Affix、Backtop)。 - 定时器、监听器、IntersectionObserver、ResizeObserver 在卸载时没有清理。
- Tree:节点缺
id、又带defaultExpandAll或checkedKeys挂载时抛ReferenceError(TreeSelect 多选时必现)。TreeSelect:缺 key 的节点每次渲染都警告,改成只警告一次。 - 样式细节(在测试站的 Storybook 里逐个看过):
- Switch:轨道圆角写的是 50%,长方形用 50% 会变成两头尖的椭圆,改成两端半圆。
- Button:small 的圆角是 2px,看着是直角;改成按尺寸 8 / 6 / 4px。图标按尺寸 14 / 16 / 18px,small 的图标和文字间距 6px;只有图标时图标居中(原来偏左 4px);文字按钮悬停不再出现灰边框;描边、朴素、文字按钮有按下态;popover 箭头不再露出完整的菱形;点击波纹跟文字颜色,浅底按钮上也看得见。
- ButtonGroup:同类型实心按钮之间加浅色分隔线。Link:悬停变浅、按下变深(原来悬停变深,暗色下发暗),焦点框带圆角。
- Typography:标题上的“复制”不再是粗体;段落截断后换到下一行的“展开”和正文左对齐;mark、code 换行后每一行都有内边距。Splitter:拖动手柄改成正中的短条,键盘聚焦时手柄也变成主色。
- Radio、Checkbox:文字和 FormItem 的标签对齐基线(原来高约 2px)。Switch:在 FormItem 里不再偏高约 4px;焦点环贴着轨道。Checkbox:暗色下“禁用且选中”不再比可用的亮。
- Input、Textarea:禁用时字数统计变淡,Textarea 右下角不再深一块。AutoComplete:前后缀图标 16px,同 Input。Mentions:下拉层的圆角、边框、阴影同 Select,不会同时亮两行。
- InputTag:输入框接在最后一个标签后面(原来单独换行,把控件撑到约 50px),最后一个标签后面剩两个字宽就不换行;标签圆角 4px,关闭图标 12px,超长标签省略,禁用时看得出标签边界。
- Segmented:尺寸看得出差别:字号 16 / 14 / 12px,外框圆角 8 / 6 / 4px,选中块和外框同心,选中项不再加粗。
- DatePicker:日期格子圆角 6px(同 Calendar),禁用日期垫底色,和上月、下月的日期区分开;range 输入框不再伸出根元素。TimePicker、ColorPicker:展开时鼠标停在输入框上,边框仍是主题色。ColorPicker:禁用时只调淡色块。
- Select:多选“全选”按钮和选项文字对齐。TreeSelect:标签不再被拉伸。Transfer:放进表单项后行高不再被撑大,中间按钮 32px 高。
- Rate:辅助文字跟着尺寸变;放在 FormItem 里时星星和标签文字居中对齐(原来低 2px 多)。Upload:照片墙里的图片铺满卡片(原来预览区只有一半高,贴着上边框)。Slider:没拖到的标记是灰边圆点,拖过的是主色边。
- CheckboxGroup:根元素外有注释,开发环境下组件有两个根节点,写在组件上的 class、style 落不到根元素上。
- Tag、Chip:default、small 的圆角从 2px 改为 4px;带图片的 Chip 图片和左端半圆同心。Avatar:方形头像圆角按尺寸 8 / 6 / 4px;头像组的“+N”在亮色、暗色下都看得出,组和旁边的文字中线对齐。
- Badge:一位数是正圆(原来是横向椭圆),large 的两端是半圆;圆点不受
shape影响;挂在元素上的徽章加一圈页面底色描边。 - Card:small 底部字号 12px;有边框时封面图角上不再露底色;折叠按钮颜色同关闭按钮。Carousel:外置指示器不再贴着轮播底边。
- Calendar:日期格子圆角 6px;禁用日期在暗色下看得见;上月、下月的农历跟着日期变淡。Collapse:禁用面板的箭头变淡。Descriptions:带边框时标签列看得出底色。
- Image:加载中、失败的底色看得出;预览工具栏两端半圆,图标变大,按钮压在浅色图片上也看得清。
- Table:横向滚动时,内容压到固定列下面的那一侧显示阴影(根元素加
ns-table--fixed-left-shadow/ns-table--fixed-right-shadow);带边框的表格滚到最右边时,右固定列左侧不再是 2px 粗线。 - Progress:条形两端一直是半圆;轨道颜色加深一档,白底上看得见;仪表盘缺口两边是圆头;外置文字等宽,几条进度条一样长。
- Pagination:small 的页码按钮圆角 4px。Timeline:
placement="top"的时间戳和节点圆心对齐。Tree:禁用节点的箭头变淡;复选框和文字间距 8px(TreeSelect 同)。 - Result:说明文字到操作按钮从 40px 改为 24px,没有操作区时底部不再多 24px。Statistic、Countdown:数值不再用等宽字体,改用等宽数字。Skeleton:text 圆角 4px,rect、image 6px。
- Menu:子菜单箭头改用 chevron-down 图标;弹出浮层加边框和更深的阴影,暗色下看得出;选中项悬停时不再变灰;设了
background-color时选中项用半透明底,深底上的文字看得清。 - Steps:横向标题不再被推离图标 12px;竖向标题和图标居中;simple 风格的成功、出错图标看得见。
- Tabs:关闭按钮有圆形点击区,悬停时叠底色;按钮样式的标签放不下、可以滚动时,按钮不再多露 4px 到左右箭头底下。Breadcrumb:分隔符颜色比链接浅。Anchor:方块样式圆角 6px。Backtop:只有图标时是圆形。PageHeader:返回图标 20px,标题图标跟着标题字号。Dropdown:面板圆角 6px,阴影加深,上下留 4px。
- Alert:图标和关闭按钮和标题居中对齐(原来偏上 2~3px);
center、align="right"时图标跟着文字。 - Modal、Drawer、MessageBox:关闭图标的右边缘和正文、按钮对齐,头部高度固定 56px(原来有关闭按钮时是 64px)。Drawer:标题加粗,正文 14px。
- MessageBox:信息图标画错(点和竖线叠在一起);标题到正文、正文到按钮的间距从 32px 改为 16、20px。
- Notification:关闭按钮和图标对齐第一行(原来偏上约 4px)。Message、Notification、MessageBox 的关闭按钮有键盘焦点环。
- Popover:标题加粗。Popconfirm:提示文字换行时图标对齐第一行。Tooltip:圆角从 2px 改为 6px;深色提示的箭头不再透出浅色轮廓。
- 按钮样式的多选框组:相邻两项都选中时,中间是一条浅一档的主色分隔线;获得焦点的一项挨着选中项时,焦点环和按钮之间隔一道底色缝,不再有一段看不见。Tabs 的按钮样式同样处理。
- ButtonGroup:分割线长度改成按钮高度的一半(20 / 16 / 12px),原来上下固定各留 8px,small 下比文字还短。Chip:前面的图标 18 / 16 / 14px,移除按钮 16 / 14 / 12px。
- Table:large 下多选列表头的复选框被裁掉、后面多出省略号(内边距 16px × 2 加 18px 的复选框超出 48px 的列宽)。选择列改成左右不留内边距,复选框在列里居中。
- Form:
label-width="auto"时,后来才显示出来的表单项(v-show收起后展开、v-if新加的项)标签被当前宽度挤成两行,标签宽度撑不开。现在自动宽度下标签文字不换行,宽度按最长的标签重新计算。 - 新增单测
styles.spec.ts:把每个组件的样式块,以及组件和主题的.scss文件交给 sass 编译一遍。以前单测不编译样式,SCSS 写坏了只有构建 Storybook 时才报错。.scss从磁盘读取(用?raw导入拿到的是空字符串,等于没检查),每个文件用单独的编译器(共用时先编译主题index.scss再编译mixins.scss,sass-embedded 会卡死)。 - 检查结果:全量单测 127 个文件、5155 条全部通过(基线 2043 条,5 条失败);
vue-tsc0 处报错(基线 150 处);ESLint 0 个 error、0 个 warning(基线 161 个 error、38 个 warning);CSS 变量检查没有缺兜底值的变量。
[0.0.1] - 2026-11-14
第一次发布到 Nexus(https://nexus.nscode.cn/repository/npm-hosted/),4 个包版本相同。
Fixed
- NsButton:模板有两个根(按钮和 popover 的 Teleport),父组件写在 NsButton 上的
class、style、data-*等属性加不到按钮上。现在手动绑到按钮上(MessageBox 的确认、取消按钮因此能正常找到,5 个失败的单元测试恢复)。
Changed
- 各包
publishConfig.registry指向 Nexus,加了.npmrc.example,README 补了安装和发布步骤。
Added
- 初始化项目基础设施