web 1.0 版本不合理/待改进的API收集

[uyarn]

TDesign for web 各框架陆续发布 1.0 版本，API在很长时间内不会发布有 Breaking Change 的变动
但是 1.0 版本中存在着一些不合理、待改进的 API，希望通过此 Discussion 收集整理 1.0 版本不合理、待改进的API
在后面的大版本中改进或者完全 Deprecate

[uyarn]

Select: valueDisplay的回调的value在配合collapseNum使用时 目前返回的是全部value 是否应该减去collapsedItems的数量

[chaishi]

不应该。value 的含义应当始终保持为选中的全部值。

[chaishi]

• Radio.variant 对应的 CSS 类名，命名规范保持统一，使用 -- ，当前 variant. outline 单独不一样
• Tag, t-tag--text 类名更为 t-tag__text

[uyarn]

Select: 分组形式下DOM结构目前不是扁平的 开启虚拟滚动等场景会出现异常 需要重构分组形式下的DOM结构

[chaishi]

也许现在就可以新增支持一种虚拟滚动形式下的分组。比如：通过类名区分某一项属于分组标题，还是可选项，无论是分组标题还是可选项，本质上都可以是一个 option。

[chaishi]

Tag 组件，t-tag--text 命名不规范，更为 .t-tag__text

[chaishi]

Tree 组件，

• actived 形容词表述不准确，且存在 typo error，需更名为 activeNodes
• expanded 形容词表述不准确，需更名为 expandedNodes

[uyarn]

这个本来就是个错误的拼写 确实得改掉

[uyarn]

各组件拖拽功能交互、API统一

[Simon-He95]

layout 组件

• layout/_index.less中的class命名拼写错误，需要同步修改到layout.tsx中的class

[uyarn]

--sider -> --side

[honkinglin]

form 组件

背景：form 目前 vue 与 vue3 均使用数据中心管理的模式，实现方式参考 element 的方案，但 react 端使用 antd 的方案，屏蔽了外部直接接触所有数据源

问题：

1. React 与 Vue 实现方案不统一，维护方式十分割裂
2. React 方案并不被多数业务接受，大多数人倾向于自己管理数据，期望 form 组件专注自动校验，状态提醒方面，由于屏蔽了数据源，导致了业务管理数据较为繁琐

方案讨论：
建议还是走外部管理所有数据源的方案，用户也方便随时更改 form 管理数据，将 form 的重心投入到数据校验、UI 展示上，简化用户数据校验流程上
建议 2.0 重构下各个框架下的 form，统一一套实现方案

[uyarn]

tree expandOnClickNode 改为默认开启

[kenzyyang]

表单组件（t-input，t-select，t-date-picker等...）的 API 设计尽可能符合HTML的规范。
Exg1:
现在的 t-input 组件，监听 change 事件，实际上每输入一个字符都会触发 change 事件，但按照规范要求，并不是每次输入都需要触发 change 事件，详情参考 https://developer.mozilla.org/zh-CN/docs/Web/API/HTMLElement/change_event

期望: Event 符合 HTML 规范
为什么这样期望: 1. 其他组件库均参照此规范实现 2. 符合规范的 api 使用时不会有心智负担，不需要想是不是 change 事件和我认知的 change 事件会不会有不同。

Exg2:
并非所有的类 input 组件都实现了 focus 方法。t-input.ref.focus 可以正确聚焦，但 t-tag-input.ref.focus 并不能正确聚焦。
期望： t-tag-input 基于 input 实现，希望能暴露和原生 HTML input 一样的的 API。基于浏览器原生标签的扩展组件起码能够暴露常用 API （focus change input blur click 等）
为什么这样期望： 同上

[LeeJim]

这个确实

[uyarn]

menu router API 应该移动到menu上而不是menu-item上

[liweijie0812]

Tabs 组件
destroyOnHide作为懒加载使用。
当选项卡需要懒加载，且页面隐藏不关闭，仅destroyOnHide不满足，所以增加了lazy来配置懒加载。

由于 1.0 destroyOnHide 默认值true，且大量业务已使用。新增lazy不能变动做为destroyOnHide懒加载逻辑。

期望 2.0 处理逻辑
destroyOnHide 仅在lazy开启生效。且destroyOnHide 改为false。

[RSS1102]

Form 组件：

1. 当前 status 和 successBorder 和 type 字段可能存在冲突(重复)
2. 另外 successBorder 的 class 应在后续移除合并到 t-is-success 样式上，保持统一
3. tips 和 help 功能上似乎有功能上的重复，应该只保留一个(需注意 tips 会被 status 影响样式，而 help 不会)

[uyarn]

React 考虑逐步将列表类型的支持 都逐渐改为 options/data props方式使用，放弃children的支持，可以获得更好的的性能，同时减少jsx处理的各类问题@HaixingOoO

[RSS1102]

Button

下个版本应该将其 API theme 统一为 default/success/warning/error

---

另注意其他组件对于danger 来描述 theme，也应该进行统一为 error

[uyarn]

Empty 组件应叫 Result 组件更合理 see Tencent/tdesign-vue-next#5746