sober/CHANGELOG.md

Sober is a library of UI components designed with reference to Material You.

# 更新日志

# Unpublished changes since 1.1.6

- 修复：关闭下拉菜单动画期间快速点击其他选项会更改选中项的问题。
- 构建：移除 `html-minifier`，改为 `html-minifier-terser`。

#### 1.1.6 (2025-05-29)

- 更新核心：所有组件支持通过HTML属性绑定自定义事件，如：`<s-dialog onshow="console.log('showed')"></s-dialog>`。
- 更新核心：所有组件的属性新增了运行时判断，现在当你赋值一个错误属性时会重置为默认值。

> 由于 Google 更新了设计规范 M3 Expressive，其中废弃了很多设计，故而 Sober 的 v1 版本将不再长期支持，如果你想体验 Sober v2-alpha 版本，请使用 `npm i sober@alpha` 安装 v2 测试版。

#### 1.1.0 (2025-04-15)

- 更新：新增对 Preact 的 JSX 类型支持，完善了 Vue 的模版和 JSX 类型支持，所有组件的动画速度和运动曲线进行了优化，设备在同时支持鼠标和触屏时进行了优化。
- 新增：Alert、Avatar、Date、DatePicker，Pagination 组件。
- 新增：Switch 新增 icon 插槽，默认图标被移除。
- 新增：BottomSheet 组件新增手势滑动，新增属性 `disabledGesture` 属性。
- 新增：Checkbox 新增 **unckecked**、**checked**、**indeterminate** 插槽，用于自定义切换图标。
- 更新：Chip 外观更新，新增属性 `checked`，`disabled`，type 属性值 elevated, filled-tonal 已弃用。
- 新增组件：DatePicier 日期选择器。
- 新增组件：Date 日期选择面板。
- 更新：Dialog 样式更新，对话框宽度改为由插槽 `max-width` 决定。
- 更新：Drawer 组件是否启用折叠模式改为由组件自身宽度来决定，而非窗口宽度。
- 新增组件：Empty 空面板。
- 更新：FAB 组件高度在没有使用插槽时显示较小的高度。
- 更新：Icon 组件加载 svg 图标时，改为使用后缀名判断。
- 修复：Page 组件 `toggle()` 方法找不到样式表错误问题。
- 新增组件：Pagination 分页选择器。
- 更新：Picker 组件弹出层宽度抖动问题，新增 `show()`、`close()`、`toggle()` 方法，参数同 Popup 组件。
- 更新：PopupMenu 组件新增 `show()`、`close()`、`toggle()` 方法，参数同 Popup 组件。
- 新增：RadioButton 新增 **unckecked**、**checked** 插槽，用于自定义切换图标。
- 更新：Search 组件样式更新。
- 更新：SegmentedButton 组件 UI 更新，新增属性 `mode`。
- 修复：Slider 组件设置 `min` 属性时指示器错位问题。
- 更新：Snackbar 组件 `type` 属性新增值 `info`、`warning`、`error`、`success`。
- 更新：Switch 默认图标被移除，新增 **icon** 插槽来添加自定义图标。
- 更新：Tooltip，新增 `show()`、`close()` 方法。

#### 1.0.6 (2025-01-20)

- 添加：对 Solidjs 的 JSX 类型支持。
- 新增：Field 新增 `--field-padding-top`、`--field-padding-bottom`、`--field-padding-left`、`--field-padding-right` 私有CSS变量。
- 新增：TextField 组件新增 `--text-field-padding-top`、`--text-field-padding-bottom`、`--text-field-padding-left`、`--text-field-padding-right` 私有CSS变量。
- 修复: [#33](https://github.com/apprat/sober/issues/33)

#### 1.0.4 (2025-01-07)

- 更新编译方式，体积减少。

#### 1.0.1 (2025-01-01)

- 新增：Page 组件 `toggle()` 方法返回值新增为 `Promise<Animation | void>` 以便于监听变更完成和动画完成。
- 修复：Picker、MenuItem、PopMenuItem 组件 `start`、`end` 插槽始终被设置颜色的问题。

#### 1.0.0 (2024-12-30)

- 这是 v1.0.0 的第一个版本，它的意义是稳定 api 并作为长期支持版本。
- 新增：Tooltip `align` 属性新增 `left` 和 `right` 对齐方式。

#### 0.8.0 (2024-12-25)

- 更新：BottomSheet、Dialog、Picker、Popup、Snackbar、Tooltip 组件支持 **top-layer** 渲染，显示时始终处于顶层，不再受父级和层级影响。
- 新增：BottomSheet、Dialog、组件新增 `showed` 属性，用于控制显隐。
- 新增：Divider 组件新增匿名插槽。
- 新增：FAB 组件新增 `disabled` 属性，用于设置禁用。
- 新增：Tooltip 组件新增 `align` 属性，用于设置默认对齐方式。
- 变更：BottomSheet、Dialog、组件 `dismiss` 和 `dismissed` 事件名称变更为 `close` 和 `closed`。
- 变更：Drawer、Picker、Popup 组件 `dismiss()` 方法名称变更为 `close()`。
- 变更：Field 组件 `view` 插槽变更为匿名插槽，`labelFixed` 属性变更为 `fixed`。
- 变更：Icon 组件 `type` 属性变更为 `name`。
- 变更：Popup 组件 `show()`、`toggle()` 方法参数发生了变更。
- 移除：BottomSheet、Dialog、组件移除 `show()`、`dismiss()`、`toggle()` 方法。

#### 0.7.2 (2024-12-02)

- 修复：TextField 在 Edge 浏览器中显示清除按钮和密码显示按钮。
- 新增：Page 组件新增 `change` 事件，在模式改变时触发，新增 `isDark` 只读属性，返回是否为暗色模式。

#### 0.7.1 (2024-11-30)

- 修复：Carousel 高度问题已修复，现在它会根据宽度自适应高度。
- 支持：Icon 的 src 属性支持加载其他类型图像。
- 新增：FAB 新增 `hidden` 属性，用于隐藏 FAB。

#### 0.7.0 (2024-11-28)

- 修改：Snackbar 的静态方法 `show` 变更为 `builder`。
- 修改：BottomSheet 的静态方法 `show` 变更为 `builder`。
- 修改：Dialog 的静态方法 `show` 变更为 `builder`。
- 重写：Carousel 进行了重写，现在它有全新的属性和外观。
- 新增：Icon 新增 `src` 属性和相关事件，用于加载 svg 图标。
- 修复：修复 Table 宽度问题，Table 现在默认支持滚动。