Changelog
Translation in progress
This page hasn't been translated into English yet, so the content below is in Chinese. The code examples work the same way.
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
- 初始化项目基础设施