# Changelog

### [v2.1.8](https://github.com/youzan/vant/tree/v2.1.8)
`2019-08-29`

**Features**

- Picker: add allow-html prop [\#4278](https://github.com/youzan/vant/pull/4278)
- NumberKeyboard: add focused prop [\#4279](https://github.com/youzan/vant/pull/4279)
- GoodsActionButton: add color prop [\#4255](https://github.com/youzan/vant/pull/4255)
- Button: color prop support linear-gradient [\#4252](https://github.com/youzan/vant/pull/4252)

**Bug Fixes**

- fix Circle stroke-width can't be greater than 60 [\#4256](https://github.com/youzan/vant/pull/4256)
- fix Picker should avoid click event when moving [\#4273](https://github.com/youzan/vant/pull/4273)
- fix Picker incorrect position when pause momentum [\#4277](https://github.com/youzan/vant/pull/4277)


### [v2.1.7](https://github.com/youzan/vant/tree/v2.1.7)
`2019-08-26`

**Bug Fixes**

- fix RadioGroup disabled prop not work [\#4242](https://github.com/youzan/vant/pull/4242)
- fix CheckboxGroup disabled prop not work [\#4242](https://github.com/youzan/vant/pull/4242)


### [v2.1.6](https://github.com/youzan/vant/tree/v2.1.6)
`2019-08-26`

**Features**

- Tag: add warning type [\#4232](https://github.com/youzan/vant/pull/4232)
- Image: add radius prop [\#4230](https://github.com/youzan/vant/pull/4230)
- Notify: add type prop [\#4237](https://github.com/youzan/vant/pull/4237)
- CellGroup: add title slot [\#4227](https://github.com/youzan/vant/pull/4227)
- Sku: initialSku can be set dynamically [\#4214](https://github.com/youzan/vant/pull/4214)
- Sku: can preview images of non-first level sku [\#4236](https://github.com/youzan/vant/pull/4236)
- Locale: add Spanish translation [\#4235](https://github.com/youzan/vant/pull/4235)


- fix Tabbar incorrect active style in route mode [\#4229](https://github.com/youzan/vant/pull/4229)
- fix NumberKeyboard incorrect sidebar position when has title [\#4228](https://github.com/youzan/vant/pull/4228)
- fix IndexBar the problem of rolling out parent boundaries when sticky bottom [\#4218](https://github.com/youzan/vant/pull/4218)


### [v2.1.5](https://github.com/youzan/vant/tree/v2.1.5)
`2019-08-23`

**Features**

- Toast: add closeOnClick option [\#4192](https://github.com/youzan/vant/pull/4192)
- Uploader: add image-fit prop [\#4189](https://github.com/youzan/vant/pull/4189)
- Uploader: add click-preview event [\#4206](https://github.com/youzan/vant/pull/4206)
- Uploader: add preview-full-image prop [\#4205](https://github.com/youzan/vant/pull/4205)
- DropdownMenu: add @dropdown-menu-title-active-text-color less var [\#4208](https://github.com/youzan/vant/pull/4208)

**Bug Fixes**

- fix IndexBar sticky bug [\#4184](https://github.com/youzan/vant/pull/4184)
- fix NumberKeyboard border color [\#4183](https://github.com/youzan/vant/pull/4183)
- fix Area can't select some oversea countries [\#4195](https://github.com/youzan/vant/pull/4195)



### [v2.1.4](https://github.com/youzan/vant/tree/v2.1.4)
`2019-08-21`

**Features**

- Col: add click event [\#4169](https://github.com/youzan/vant/pull/4169)
- Row: add click event [\#4170](https://github.com/youzan/vant/pull/4170)
- Area: add is-oversea-code prop [\#4163](https://github.com/youzan/vant/pull/4163)
- Circle: support gradient color [\#4157](https://github.com/youzan/vant/pull/4157)
- Circle: support number type of size prop [\#4160](https://github.com/youzan/vant/pull/4160)
- Tabbar: support match route by to.name [\#4148](https://github.com/youzan/vant/pull/4148)
- Sku: should close image preview when popstate [\#4152](https://github.com/youzan/vant/pull/4152)
- Uploader: should close image preview when popstate [\#4151](https://github.com/youzan/vant/pull/4151)
- Uploader: support more image types [\#4140](https://github.com/youzan/vant/pull/4140)
- TreeSelect: support multiple select [\#4130](https://github.com/youzan/vant/pull/4130)
- TreeSelect: active-id support sync modifier [\#4133](https://github.com/youzan/vant/pull/4133)
- TreeSelect: main-active-index support sync modifier [\#4132](https://github.com/youzan/vant/pull/4132)

**Bug Fixes**

- fix Sku unextracted i18n message [\#4172](https://github.com/youzan/vant/pull/4172)
- fix Tabbar avoid navigation duplicated [\#4147](https://github.com/youzan/vant/pull/4147)
- fix Field button width shrinked in firefox [\#4144](https://github.com/youzan/vant/pull/4144)
- fix Picker prevent style be override by base.css [\#4136](https://github.com/youzan/vant/pull/4136)


### [v2.1.3](https://github.com/youzan/vant/tree/v2.1.3)
`2019-08-15`

**Features**

- Sku: support i18n [\#4123](https://github.com/youzan/vant/pull/4123)
- Button: add color prop [\#4124](https://github.com/youzan/vant/pull/4124)
- Collapse: log tips for incorrect value [\#4122](https://github.com/youzan/vant/pull/4122)
- Uploader: add before-delete prop [\#4118](https://github.com/youzan/vant/pull/4118)
- TreeSelect: add content slot [\#4105](https://github.com/youzan/vant/pull/4105)
- TreeSelect: support string type of height prop [\#4107](https://github.com/youzan/vant/pull/4107)
- NumberKeyboard: improve click experience [\#4116](https://github.com/youzan/vant/pull/4116)

**Bug Fixes**

- fix DropdownMenu incorrect style when inside NavBar [\#4098](https://github.com/youzan/vant/pull/4098)
- fix Tab incorrect title position when insert tab pane [\#4091](https://github.com/youzan/vant/pull/4091)
- fix Icon service-o icon incomplete [\#4088](https://github.com/youzan/vant/pull/4088)
- fix Icon gift-o、refund-o icon incomplete [\#4089](https://github.com/youzan/vant/pull/4089)
- fix Slider should not emit change event when value not changed [\#4087](https://github.com/youzan/vant/pull/4087)


### [v2.1.2](https://github.com/youzan/vant/tree/v2.1.2)
`2019-08-10`

**Features**

- ActionSheet: add color option [\#4073](https://github.com/youzan/vant/pull/4073)
- AddressEdit: add postal-validator prop [\#4067](https://github.com/youzan/vant/pull/4067)
- Stepper: add show-plus、show-minus prop [\#4056](https://github.com/youzan/vant/pull/4056)
- Divider: add separator role to improve accessibility [\#4069](https://github.com/youzan/vant/pull/4069)
- DropdownMenu: add more less vars [\#4071](https://github.com/youzan/vant/pull/4071)
- Uploader: support isImage flag [\#4072](https://github.com/youzan/vant/pull/4072)
- Field: increase clickable area of icon [\#4058](https://github.com/youzan/vant/pull/4058)
- Picker: stop propagation when touchmove in vertical direction [\#4043](https://github.com/youzan/vant/pull/4043)
- Icon: add warning、good-job、good-job-o icon [\#4038](https://github.com/youzan/vant/pull/4038)
- Icon: add smile、music、thumb-circle、phone-circle icon [\#4048](https://github.com/youzan/vant/pull/4048)
- List: unify text font-size [\#4077](https://github.com/youzan/vant/pull/4077)
- Image: img inherit round border [\#4032](https://github.com/youzan/vant/pull/4032)
- adjust globalObject to support module script [\#4080](https://github.com/youzan/vant/pull/4080)

**Bug Fixes**

- fix Sticky incorrect position when inside scroll container [\#4055](https://github.com/youzan/vant/pull/4055)


### [v2.1.1](https://github.com/youzan/vant/tree/v2.1.1)
`2019-08-02`

**Bug Fixes**

- fix DatetimePicker event not work [\#4027](https://github.com/youzan/vant/pull/4027)
- fix Popup ensure z-index setting order [\#4026](https://github.com/youzan/vant/pull/4026)


### [v2.1.0](https://github.com/youzan/vant/tree/v2.1.0) [deprecated]
`2019-08-01`

**Features**

- GoodsAction: update style [\#3967](https://github.com/youzan/vant/pull/3967)
- Sku: update style [\#3875](https://github.com/youzan/vant/pull/3875) [\#3922](https://github.com/youzan/vant/pull/3922)
- Sku: add price-tag prop [\#3875](https://github.com/youzan/vant/pull/3875)
- Sku: add hide-selected-text prop [\#3875](https://github.com/youzan/vant/pull/3875)
- Sku: add sku-header-origin-price slot [\#3958](https://github.com/youzan/vant/pull/3958)
- Dialog: add title slot [\#3985](https://github.com/youzan/vant/pull/3985)
- Dialog: centered in screen [\#3905](https://github.com/youzan/vant/pull/3905)
- Uploader: add less vars [\#3907](https://github.com/youzan/vant/pull/3907)
- ActionSheet: add less vars [\#3908](https://github.com/youzan/vant/pull/3908)
- AddressList: add click-item event [\#3942](https://github.com/youzan/vant/pull/3942)
- CouponList: add empty-image prop [\#3941](https://github.com/youzan/vant/pull/3941)
- SwipeCell: add stop-propagation prop [\#3952](https://github.com/youzan/vant/pull/3952)
- ImagePreview: add swipe-duration prop [\#3963](https://github.com/youzan/vant/pull/3963)

**Bug Fixes**

- fix Tabs incorrect line position in some cases [\#3961](https://github.com/youzan/vant/pull/3961)
- fix ImagePreview should reset onClose & onChange option [\#3960](https://github.com/youzan/vant/pull/3960)
- fix DatetimePicker incorrect confirm param when use formatter [\#3969](https://github.com/youzan/vant/pull/3969)
- fix Tabs fix scroll position deviation when sticky [\#3949](https://github.com/youzan/vant/pull/3949)
- fix IndexBar should update when index-list updated [\#3943](https://github.com/youzan/vant/pull/3943)
- fix AddressList can't select item when click empty area [\#3909](https://github.com/youzan/vant/pull/3909)
- fix ImagePreview Image beyond the screen height cover index [\#4002](https://github.com/youzan/vant/pull/4002)
- fix Radio: can't select when click gap [\#4007](https://github.com/youzan/vant/pull/4007)
- fix SwipeCell should not prevent touchmove when opened [\#3982](https://github.com/youzan/vant/pull/3982)


### [v2.0.9](https://github.com/youzan/vant/tree/v2.0.9)
`2019-07-19`

**Features**

- add Sticky component [\#3888](https://github.com/youzan/vant/pull/3888)
- Grid: optimize word break [\#3897](https://github.com/youzan/vant/pull/3897)
- Image: add round prop [\#3838](https://github.com/youzan/vant/pull/3838)
- Image: add show-error prop [\#3896](https://github.com/youzan/vant/pull/3896)
- Image: add show-loading prop [\#3893](https://github.com/youzan/vant/pull/3893)
- Toast: add iconPrefix option [\#3872](https://github.com/youzan/vant/pull/3872)
- Toast: optimize image icon display [\#3895](https://github.com/youzan/vant/pull/3895)
- TreeSelect: add click-nav、click-item event [\#3892](https://github.com/youzan/vant/pull/3892)
- ActionSheet: add round prop [\#3874](https://github.com/youzan/vant/pull/3874)
- Uploader: support preview network image [\#3899](https://github.com/youzan/vant/pull/3899)

**Bug Fixes**

- fix Dialog closeOnPopstate can't be disabled [\#3868](https://github.com/youzan/vant/pull/3868)
- fix DropdownMenu cann't use toggle to open item [\#3876](https://github.com/youzan/vant/pull/3876)
- fix SwipeCell should stop event propagation [\#3898](https://github.com/youzan/vant/pull/3898)


### [v2.0.8](https://github.com/youzan/vant/tree/v2.0.8)
`2019-07-16`

**Features**

- Sku: support custom placeholder [\#3864](https://github.com/youzan/vant/pull/3864)
- DropdownMenu: add icon option [\#3855](https://github.com/youzan/vant/pull/3855)
- DropdownMenu: optimize title ellipsis [\#3847](https://github.com/youzan/vant/pull/3847)
- ImagePreview: support double click zoom [\#3839](https://github.com/youzan/vant/pull/3839)

**Bug Fixes**

- fix Tab: click event param missing [\#3866](https://github.com/youzan/vant/pull/3866)
- fix List not work when body is the scrolling container [\#3844](https://github.com/youzan/vant/pull/3844)
- fix IndexBar incorrect active anchor in some cases [\#3832](https://github.com/youzan/vant/pull/3832)


### [v2.0.7](https://github.com/youzan/vant/tree/v2.0.7)
`2019-07-11`

**Features**

- add CountDown component [\#3805](https://github.com/youzan/vant/pull/3805)
- Popup: add round prop [\#3781](https://github.com/youzan/vant/pull/3781)
- PullRefresh: add distance of slotProps [\#3829](https://github.com/youzan/vant/pull/3829)
- DropdownMenu: add close-on-click-outside prop [\#3824](https://github.com/youzan/vant/pull/3824)
- Swipe: add immediate option of swipeTo method [\#3821](https://github.com/youzan/vant/pull/3821)
- Slider: support number type of bar-height prop [\#3794](https://github.com/youzan/vant/pull/3794)
- IndexBar: add sticky-offset-top prop [\#3791](https://github.com/youzan/vant/pull/3791)

**Bug Fixes**

- fix Popup overlay may cover popup in some cases [\#3831](https://github.com/youzan/vant/pull/3831)
- fix Stepper add hack for iOS 12 page scroll [\#3804](https://github.com/youzan/vant/pull/3804)
- fix Dialog missing closeOnPopstate in type definition [\#3789](https://github.com/youzan/vant/pull/3789)
- fix DatetimePicker confirm event param incorrect when use filter [\#3816](https://github.com/youzan/vant/pull/3816)


### [v2.0.6](https://github.com/youzan/vant/tree/v2.0.6)
`2019-07-05`

**Features**

- add Divider component [\#3755](https://github.com/youzan/vant/pull/3755)
- Tab: add name prop [\#3762](https://github.com/youzan/vant/pull/3762)
- Sku: add add-cart-text prop [\#3725](https://github.com/youzan/vant/pull/3725)

**Bug Fixes**

- fix Swipe fix blank area when use width prop [\#3751](https://github.com/youzan/vant/pull/3751)
- fix Grid gutter can be string type [\#3741](https://github.com/youzan/vant/pull/3741)
- fix Collapse use double raf to ensure animation can start [\#3723](https://github.com/youzan/vant/pull/3723)
- fix PullRefresh ensure value change can be watched [\#3719](https://github.com/youzan/vant/pull/3719)


### [v2.0.5](https://github.com/youzan/vant/tree/v2.0.5)
`2019-07-02`

**Features**

- Stepper: add button-size prop [\#3714](https://github.com/youzan/vant/pull/3714)
- Stepper: support long press gesture [\#3711](https://github.com/youzan/vant/pull/3711)
- Dialog: add close-on-popstate prop [\#3709](https://github.com/youzan/vant/pull/3709)

**Bug Fixes**

- fix postcss config overwritten issue


### [v2.0.4](https://github.com/youzan/vant/tree/v2.0.4)
`2019-07-01`

**Features**

- add Grid、GridItem component [\#3669](https://github.com/youzan/vant/pull/3669) [\#3682](https://github.com/youzan/vant/pull/3682) [\#3683](https://github.com/youzan/vant/pull/3683)
- Field: add arrow-direction prop [\#3679](https://github.com/youzan/vant/pull/3679)
- Sidebar: add to、replace prop [\#3696](https://github.com/youzan/vant/pull/3696)
- Sidebar: support use v-model to bind active key [\#3698](https://github.com/youzan/vant/pull/3698)
- IndexBar: add class for active index [\#3692](https://github.com/youzan/vant/pull/3692)
- Uploader: support number type of name prop [\#3681](https://github.com/youzan/vant/pull/3681)
- SwipeCell: add name prop [\#3680](https://github.com/youzan/vant/pull/3680)
- AddressEdit: add detail-maxlength prop [\#3707](https://github.com/youzan/vant/pull/3707)
- GoodsActionIcon: add icon slot [\#3705](https://github.com/youzan/vant/pull/3705)

**Bug Fixes**

- fix Collapse flick in safari [\#3686](https://github.com/youzan/vant/pull/3686)
- fix Picker compatibility issues on lower versions of Android [\#3688](https://github.com/youzan/vant/pull/3688)


### [v2.0.3](https://github.com/youzan/vant/tree/v2.0.3)
`2019-06-27`

**Features**

- ActionSheet: add duration prop [\#3608](https://github.com/youzan/vant/pull/3608)
- ActionSheet: add open、opened events [\#3639](https://github.com/youzan/vant/pull/3639)
- ActionSheet: add close、closed events [\#3639](https://github.com/youzan/vant/pull/3639)
- Icon: add fit mode for image content [\#3667](https://github.com/youzan/vant/pull/3667)
- Icon: update checked、comment、comment-o icon [\#3615](https://github.com/youzan/vant/pull/3615)
- ImagePreview: add onChange option [\#3630](https://github.com/youzan/vant/pull/3630)
- Popup: optimize overlay animation duration [\#3610](https://github.com/youzan/vant/pull/3610)
- Uploader: support preview non-image file [\#3604](https://github.com/youzan/vant/pull/3604)
- Uploader: support click to preview image [\#3603](https://github.com/youzan/vant/pull/3603)
- Stepper: add less vars [\#3599](https://github.com/youzan/vant/pull/3599)

**Bug Fixes**

- fix ImagePreview should lock scroll [\#3645](https://github.com/youzan/vant/pull/3645)
- fix Tab may cause error when render title slot [\#3631](https://github.com/youzan/vant/pull/3631)
- fix vetur auto-complete [\#3617](https://github.com/youzan/vant/pull/3617)


### [v2.0.2](https://github.com/youzan/vant/tree/v2.0.2)
`2019-06-21`

**Features**

- Card: add click-thumb event [\#3586](https://github.com/youzan/vant/pull/3586)
- CouponList: add enabled-title、disabled-title props [\#3578](https://github.com/youzan/vant/pull/3578)
- Slider: min/max can set any value [\#3566](https://github.com/youzan/vant/pull/3566)
- Uploader: before-read prop support promise mode [\#3572](https://github.com/youzan/vant/pull/3572)
- Picker: update acceleration rate [\#3556](https://github.com/youzan/vant/pull/3556)
- NumberKeyboard: support v-model [\#3531](https://github.com/youzan/vant/pull/3531)
- NumberKeyboard: add maxlength prop [\#3532](https://github.com/youzan/vant/pull/3532)
- add sideEffects to enable tree shaking [\#3530](https://github.com/youzan/vant/pull/3530)

**Bug Fixes**

- fix Button default margin in safari [\#3577](https://github.com/youzan/vant/pull/3577)
- fix Sku can not preview image when only have goods picture [\#3569](https://github.com/youzan/vant/pull/3569)
- fix Toast missing type definition of clear method [\#3542](https://github.com/youzan/vant/pull/3542)


### [v2.0.1](https://github.com/youzan/vant/tree/v2.0.1)
`2019-06-15`

**Features**

- Tab: support string type of line-width & line-height [\#3514](https://github.com/youzan/vant/pull/3514)
- Icon: use image component to display image [\#3515](https://github.com/youzan/vant/pull/3515)
- Toast: add icon prop [\#3485](https://github.com/youzan/vant/pull/3485)
- DropdownMenu: add direction prop [\#3490](https://github.com/youzan/vant/pull/3490)
- NumberKeyboard: add delete slot [\#3499](https://github.com/youzan/vant/pull/3499)

**Bug Fixes**

- fix Image missing type definition [\#3520](https://github.com/youzan/vant/pull/3520)
- fix SwitchCell incorrect loading position [\#3501](https://github.com/youzan/vant/pull/3501)
- fix Toast missing fade-out transition in multiple mode [\#3504](https://github.com/youzan/vant/pull/3504)
- fix Locale can not modify functional message [\#3498](https://github.com/youzan/vant/pull/3498)


### [v2.0.0](https://github.com/youzan/vant/tree/v2.0.0)
`2019-06-12`

#### Overview

- Add four new components
- Add dozens of APIs
- Improve accessibility
- New card style document, support document search
- All components support custom styles via `less` variables
- Rename several components, deprecate several APIs

#### New Components

- `Image` Component
- `Skeleton` Component
- `IndexBar`、`IndexAnchor` Component
- `DropdownMenu`、`DropdownItem` Component

![](https://img.yzcdn.cn/public_files/2019/06/10/141ac9b67c06be0811c86c4c1c571c9d.png)

#### Breaking Changes

##### Actionsheet

- Rename to `ActionSheet`

##### Button

- Remove `bottom-action` prop，please use `square` and `size` instead

##### Field

- Remove `on-icon-click` prop，please use `click-right-icon` event instead
- Rename `icon` prop to `right-icon`
- Rename `icon` slot to `right-icon`
- Rename `click-icon` event to `click-right-icon`

##### GoodsAction

- Rename `GoodsActionBigBtn` to `GoodsActionButton`
- Rename `GoodsActionMiniBtn` to `GoodsActionIcon`
- Remove `primary` prop of `GoodsActionBigBtn`，please to `type` prop instead

##### Step

- Remove `icon` prop
- Remove `title` prop
- Remove `icon-class` prop
- Remove `description` prop
- Remove `message-extra` slot

##### Badge

- Rename `BadgeGroup` to `Sidebar`
- Rename `Badge` to `SlidebarItem`

##### Loading

- Remove `circle` type
- Remove `gradient-circle` type

##### Checkbox

- Adjusted to `flex` layout, may affect the original layout

##### Radio

- Adjusted to `flex` layout, may affect the original layout

##### Waterfall

- Remove Waterfall component，please use `List` instead，or use [@vant/waterfall](https://github.com/youzan/vant/tree/dev/packages/vant-waterfall)。

---

#### Accessibility

Improve accessibility for those components：

- Accordion
- Checkbox
- Dialog
- DropdownMenu
- GoodsAction
- List
- NoticeBar
- NumberKeyboard
- Radio
- Rate
- Stepper
- Tab
- Slider
- Switch

#### New Feature

##### ActionSheet

- Add `lock-scroll` prop
- Add `click-overlay` event
- Add `close-on-click-action` prop
- Support both use `title` and `actions` prop

##### Area

- `reset` method support `code` param

##### Button

- Add `icon` prop
- Add `loading-type` prop

##### Checkbox

- Add `icon-size` prop

##### DatetimePicker

- Add `filter` prop

##### Field

- Add `input` slot
- Add `click` event
- Add `clickable` prop
- Add `label-class` prop
- No longer update v-model during IME composition

##### GoodsActionButton

- Add `type` prop

##### Icon

- Support `Number` type of `size` prop

##### ImagePreview

- Add `close-on-popstate` prop

##### Loading

- Add `default` slot
- Add `vertical` prop
- Add `text-size` prop
- Support `Number` type of `size` prop

##### Notify

- Add `onClick` option
- Add `onClose` option
- Add `onOpened` option

##### NoticeBar

- Add `left-icon` slot
- Add `right-icon` slot

##### PasswordInput

- Add `gutter` prop

##### Picker

- Support inertial scrolling
- Add `toolbar-position` prop

##### Popup

- Add `click` event
- Add `duration` prop

##### Radio

- Add `icon-size` prop

##### Rate

- Add `gutter` prop
- Support`String` type of `size` prop

##### Search

- Add `clearable` prop
- Add `left-icon` prop
- Add `right-icon` prop
- Add `right-icon` slot
- No longer update v-model during IME composition

##### Slider

- Add `drag-start` event
- Add `drag-end` event

##### Steps

- Add `inactive-icon` prop
- Add `inactive-icon` slot

##### Stepper

- Support`Number` type of `input-width` prop

##### SubmitBar

- Add `tip-icon` prop
- Add `suffix-label` prop

##### SwipeCell

- Auto calc `left-width` and `right-width`

##### Switch

- The loading icon color will now follow the background color change

##### SwitchCell

- Add `border` prop
- Add `cell-size` prop

##### Sku

- Add `preview-open` event
- Add `preview-close` event

##### Tab

- Add `border` prop
- Optimize `animated` animation performance
- Fix incorrect tab pane height when use `animated` prop

##### Tabbar

- Add `route` prop
- Add `border` prop
- Add `inactive-color` prop

##### TabbarItem

- Add `name` prop

##### Toast

- Add `onOpened` option

##### Uploader

- Add default upload style
- Add `delete` event
- Add `upload-text` prop
- Add `max-count` prop
- Add `preview-size` prop
- Add `preview-image` prop
- Support use `v-model` to bind file-list
- `oversize` event add `detail` param