CHANGELOG.en-US.md

Changelog

2.4.0 Fullerene

2018-05-28

New features

• General
  • Dev tool and bundler is switched to native webpack, #11216
  • Now you can globally set the initial z-index of popups, #11257
• Autocomplete
  • Added hide-loading attribute, #11260
• Button
  • Now you can use the size attribute on circle buttons to control their sizes, #11275
• InputNumber
  • Added precision attribute, #11281
• Tabs
  • Added before-leave attribute, #11259
  • Added lazy attribute, #11167（by @Kingwl）
• Table
  • Added sort method to manually sort the table, #11311

Bug fixes

• Input
  • Fixed an issue that causes a re-render when using the Chinese IME to quickly input text, #11235 (by @STLighter)
• Popover
  • Fixed the console error when the triggering element is Radio or Checkbox, #11265
• Breadcrumb
  • Fixed the to attribute not supporting dynamic update, #11286
• Upload
  • Fixed the console error when a File is resolved in the returned Promise of the beforeUpload method, #11297 (by @qusiba)
• Tooltip
  • Fixed arrow not positioned correctly when content is empty, #11335
• Autocomplete
  • Fixed incorrect input suggestions after deleting keyword quickly, #11323
• ColorPicker
  • Fixed active-change event incorrectly triggering when picker dropdown is closed, #11304
• Table
  • Fixed style error of oversized filter panel, #11314
  • Fixed currently selected row not retained when the table is sorted, #11348
• Checkbox
  • Fixed single checkbox not supporting validation, #11271
• Radio
  • Fixed disabled Radio still being selected when pressing space key, #11303
• MessageBox
  • Fixed the el-popup-parent--hidden class not removed when opening MessageBox in succession, #11371

2.3.9

2018-05-18

• Fixed when the source data does not have the field specified by a TableColumn's prop attribute, an error would occur when the mouse moves into that column's cells, #11137
• The lockScroll attribute of pop up components no longer adds an inline style to the parent element, but instead adds a class name, #11114
• Fixed the icon of Progress not displaying when its status is exception, #11172
• Fixed options' disabled attribute not working in filterable Cascader's filter result list, #11185
• Fixed an issue where Table's expanded row cannot be collapsed if the data source is updated after its expansion, #11186
• setCurrentKey of Tree now accepts null as its param to cancel the currently highlighted node, #11205

2.3.8

2018-05-11

• Fixed DatePicker panel jumping to the current month after picking a date in a non-current month when type is dates, #10973
• Fixed clearable Input still displaying the clear icon when readonly, #10912
• Fixed closing the DatePicker panel without changing the value incorrectly triggering the change event, #11017
• Fixed keyboard navigation not working properly when Select has grouped options, #11058
• Added prefix named slot for Select, #11063
• Added 'clearValidate` method for FormItem, #11076
• Added checkOnClickNode attribute for Tree, #11111

2.3.7

2018-04-29

• Fixed Table not updating its header widths when the scroll bar disappears due to filtering, #10834
• Fixed clearable Input still showing the clear icon when its initial value is null, #10912
• Fixed incorrect trigger of the active-change event after changing ColorPicker's binding value programatically, #10903 (by @zhangbobell)
• Fixed filterable Select causing an infinite loop when navigating options using keyboard if all options are disabled, #10945

2.3.6

2018-04-21

• Fixed wrong behavior of Tree's allow-drop callback when type parameter is used, #10821
• Now you can properly enter keywords in filterable single Select in IE11, #10822
• Fixed single Select incorrectly triggering blur event after clicking an option, #10822

2.3.5

2018-04-20

• Fixed incorrect highlights in DatePicker panel when type is week, #10712
• Fixed InputNumber being empty when its initial value is 0, #10714
• Added automatic-dropdown attribute for Select, #10042 (by @Seebiscuit)
• Fixed disabled Rate's value still being updated by navigation keys, #10726 (by @Richard-Choooou)
• Now DatePicker's type attribute can be 'dates', where you can pick multiple dates in one picker, #10650 (by @Mini256)
• Added prev-click and next-click events for Pagination, #10755
• Added pager-count attribute for Pagination, #10493 (by @chongjohn716)
• Added type as the 3rd param of Tree's allow-drop attribute callback, #10792
• Now we use ResizeObserver to detect DOM element resizing, #10779

2.3.4

2018-04-12

• Deleted duplicate showTimeout attribute in SubMenu's TypeScript declaration, #10566 (by @kimond)
• Now you can customize Transfer's data item using scoped slot, #10577
• Fixed clicking disabled prev and next button of Pagination still triggers current-change event, #10628
• Fixed Textarea displaying undefined in SSR when its value is not set, #10630
• Fixed disabled TabItem style when type is border-card, #10640
• Added $index as formatter's fourth param of Table, #10645
• Fixed CheckboxButton not exported in TypeScript declaration, #10666

2.3.3

2018-04-04

• Added shadow attribute for Card, #10418 (by @YunYouJun)
• Fixed Badge being hidden when value is 0, #10470
• Fixed some bugs of draggable Tree, #10474 #10494
• Added placement for Autocomplete, #10475
• Now default-time attribute also works in non-range DateTimePicker, #10321 (by @RickMacTurk)
• Removed the blue outline of TabItem after the browser blurs or is minimized, #10503
• Added popper-append-to-body attribute for SubMenu, #10515
• Removed visual feedback when hovering on non-link BreadcrumbItem, #10551
• Fixed InputNumber's change event to ensure the component's binding value is updated in the event handler, #10553

2.3.2

2018-03-29

• Fixed an Autocomplete regression, #10442

2.3.1

2018-03-29

• Fixed a regression that type of Input is not passed down to the native input element, #10415
• Added blur method for Select, #10416

2.3.0 Diamond

2018-03-28

New features

• Table
  • Now formatter of TableColumn can be dynamically updated, #10184 (by @elfman)
  • Added select-on-indeterminate attribute, #9924 (by @syn-zeta)
• Menu
  • Added collapse-transition attribute, #8809 (by @limichange)
• Input
  • Added select method, #10229
  • Added blur method, #10356
• ColorPicker
  • Added predefine attribute, #10170 (by @elfman)
• Tree
  • Added draggable, allow-drop and allow-drag attributes, and node-drag-start, node-drag-enter, node-drag-leave, node-drag-over, node-drag-end and node-drop events, #9251 #10372 (by @elfman)
• Form
  • validate method now has a second parameter, containing information of form items that failed the validation, #10279
  • Added validate event, #10351
• Progress
  • Added color attribute, #10352 (by @YunYouJun)
• Button
  • Added circle attribute, #10359 (by @YunYouJun)

Bug fixes

• Form
  • Fixed label of FormItem not align with mixed Input, #10189
• Menu
  • Now collapsed Menu will only show the Tooltip when the title slot of MenuItem is set, #10193 (by @PanJiaChen)
• Pagination
  • Fixed current-change event wrongly triggering without user interaction, #10247
• DatePicker
  • Now the date and time value in the dropdown panel are correctly formatted based on the format attribute, #10174（by @remizovvv）
• Upload
  • Fixed accept attribute not working when drag is true, #10278

2.2.2

2018-03-14

• Added clear event for Input, #9988 (by @blackmiaool)
• Now manual input of ColorPicker supports hsl, hsv and rgb modes, #9991
• Fixed DatePicker not triggering change event when its initial value is cleared, #9986
• Now icon class related attributes of Rate support dynamic updates, #10003
• Fixed Table with fixed columns not updating its height correctly if max-height is set, #10034
• Now DatePicker's range mode supports reverse selection (clicking the end date, then clicking the start date), #8156 (by @earlymeme)
• Added disabled attribute for Pagination, #10006
• Added after-enter and after-leave events for Popover, #10047
• Fixed Select not triggering validation when user selects an option after executing resetFields of Form, #10105
• Fixed incorrect widths of fixed columns of Table in some cases, #10130
• Fixed MessageBox inheriting the title attribute of its previous instance when called without title, #10126 (by @Pochodaydayup)
• Added input-size attribute for Slider, #10154
• Added left-check-change and right-check-change events for Transfer, #10156

2.2.1

2018-03-02

• Fixed Aside, Header and Footer shrinking in some layout, #9812
• Fixed Table with a height attribute not rendering in SSR, #9876
• Fixed expandable Table not calculating its height when a row is expanded, #9848
• Fixed change event not trigger when manually typing date in DateTimePicker, #9913
• Fixed Select showing its options when the input box is right-clicked, #9894 (by @openks)
• Added tooltip-class attribute for Slider, #9957
• Now Select will stay focused after selection, #9857 (by @Seebiscuit)
• Added target-order attribute for Transfer, #9960

2.2.0 Graphite

2018-02-12

New features

• Menu
  • Added popper-class and disabled attributes for SubMenu, #9604 #9771
  • Horizontal Menu now supports multi-layered SubMenu, #9741
• Tree
  • Added node-contextmenu event, #9678
  • Now you can customize node template using scoped slot, #9686
  • Added getNode, remove, append, insertBefore, insertAfter, getCheckedKeys, getHalfCheckedNodes, getHalfCheckedKeys methods and check event, #9718 #9730
• Transfer
  • Added clearQuery method, #9753
• Select
  • Added popper-append-to-body attribute, #9782

Bug fixes

• Table
  • Fixed clicking expanding icon of an expandable row triggers row-click event, #9654
  • Fixed layout not update when column width is changed by user dragging, #9668
  • Fixed style issue when summary row co-exists with fixed columns, #9667
• Container
  • Fixed container components not stretching in IE11, #9655
• Loading
  • Fixed Loading not showing when the value of v-loading is changed to true in the mounted hook, #9722
• Switch
  • Fixed two native click events are triggered when Switch is clicked, #9760

2.1.0 Charcoal

2018-01-31

New features

• Cascader
  • Added focus and blur events, #9184 (by @viewweiwu)
• Table
  • The filter-method now has a third param column, #9196 (by @liyanlong)
• DatePicker
  • Added prefix-icon and clear-icon attributes, #9237 (by @AdamSGit)
  • Added default-time attribute, #9094 (by @nighca)
  • value-format now supports timestamp, #9319 (by @wacky6)
• InputNumber
  • Now the binding value can be undefined, #9361
• Select
  • Added auto-complete attribute, #9388
• Form
  • Added disabled attribute, #9529
  • Added validateOnRuleChange attribute, #8141
• Notificaition
  • Added closeAll method, #9514

Bug fixes

• InputNumber
  • Fixed value resetting when typing decimal point, #9116
• Dropdown
  • Fixed dropdown menu incorrect positioning when the page only has a horizontal scrollbar in some browsers, #9138 (by @banzhuanmei)
• Table
  • Fixed an error in calculating number of fixed columns after the column data changes, #9188（by @kolesoffac）
  • Fixed the border of the last column of the grouped header not properly displayed, #9326
  • Fixed incorrect positioning of table header in Safari, #9327
  • Fixed expanded row collapsing when the table data changes, #9462
  • Fixed unnecessary multiple renders in some conditions, #9426
  • Fixed column width calculation error when width of TableColumn changes, #9426
• Loading
  • Fixed Loading not hiding correctly in some conditions, #9313
• DatePicker
  • Fixed focus method not working in range mode, #9437
  • Fixed clicking the "now" button still selecting the current date even if it is disabled, #9470 (by @wacky6)
  • Fixed date clamping when navigating, #9577 (by @wacky6)
• Steps
  • Fixed style error in IE 11, #9454

Breaking changes

• Menu
  • The popup menu in collapse mode now appends directly to body, so that it is visible when nested in Aside, #9263
• Table
  • Now checking the checkboxes in multi-selection Table doesn't trigger row-click event, #9467
• Loading
  • The z-index of non-fullscreen loading mask is changed to 2000. The z-index of fullscreen loading mask will update dynamically with the popup components, #9522
• Dropdown
  • show-timeout and hide-timeout attributes now only works when trigger is hover, #9573

2.0.11

2018-01-08

• Fixed border color issue of Select when in prepend or append slot of Input, #9089
• Fixed remove-tag event's parameter of Select, #9090
• Added show-timeout and hide-timeout attributes for SubMenu, #8934 (by @HugoLew)
• Fixed missing Tooltip style of show-overflow-tooltip when Table is imported on demand, #9130
• Fixed Table column's sorting malfunctioning after clearSort is executed on that column, #9100 (by @zEmily)
• i18n config file for Czech is renamed from cz to cs-CZ, #9164

2.0.10

2017-12-29

• Fixed wrong max height calculation of Table when fixed column and summary row co-exist, #9026
• Fixed uncompiled color style of empty text in Table, #9028
• Now DatePicker only emits change event when value is truly changed, #9029 (by @remizovvv)
• Added tabindex attribute for Input, #9041 (by @dicklwm)

2.0.9🎄

2017-12-24

• Added before-remove hook function for Upload, #8788 (by @firesh)
• Fixed initial value of error not working for FormItem, #8840
• Now Loading directive supports custom class name by assigning element-loading-custom-class attribute, #8826 (by @earlymeme)
• Fixed CarouselItem becoming invisible when data is asynchronously updated, #8921
• Added renderAfterExpand attribute for Tree, #8972

2.0.8

2017-12-12

• Added Spanish documentation
• Fixed show-timeout of Dropdown not working when trigger is click, #8734 (by @presidenten)
• Fixed Form validation timing for rules whose trigger is blur, #8776
• Fixed blur event of ranged DatePicker, #8784
• format of TimePicker now supports AM/PM, #8620 (by @firesh)

2.0.7

2017-11-29

• Fixed disabled text button style, #8570

2.0.6

2017-11-29

• Fixed style bug of Table's sorting icons, #8405
• Fixed trigger mechanism for Popover when its trigger is manual, #8467
• Added prefix-icon and suffix-icon attributes for Autocomplete, #8446 (by @liyanlong)
• Added separator attribute for Cascader, #8501
• Added clearable attribute for Input, #8509 (by @lbogdan)
• Added background attribute for Pagination, #8553

2.0.5

2017-11-17

• Fixed Popover, Tree, Breadcrumb and Cascader regression in 2.0.4, #8188 #8217 #8283
• Fixed memory leak of clickoutside directive, #8168 #8225 (by @badpunman @STLighter)
• Fixed multiple Select height when its value is cleared, #8317 (by @luciy)
• Added collapse-tags attribute for multiple Select to replace tags with one line of text, #8190
• Fixed high CPU consumption caused by hidden Table, #8351
• Now you can use doLayout method of Table to update its layout, #8351

2.0.4

2017-11-10

• Improved accessibility for Cascader, Dropdown, Message, Notification, Popover, Tooltip and Tree
• Fixed Container resize when the width of viewport decreases, #8042
• Fixed Tree's updateKeyChildren incorrectly deleting child nodes, #8100
• Fixed bordered CheckboxButton's height when nested in a Form, #8100
• Fixed Menu's parsing error for custom colors, #8153 (by @zhouyixiang)

2.0.3

2017-11-03

• Fixed editable and readonly attributes for ranged DatePicker, #7922
• Fixed style error of nested Tabs, #7941
• Fixed style error of the last Step of vertical Steps, #7980
• Fixed trigger timing of current-change event for Pagination, #7995
• Fixed unregistered Tooltip in Menu, #7995

2.0.2

2017-10-31

• Now right-clicking the buttons of InputNumber won't change its value, #7817
• validate method of Form can now wait for asynchronous validations before executing its callback, #7774 (by @Allenice)
• Fixed range selection of DatePicker not working in Chromium 53-57 browsers, #7838
• Fixed missing preview and delete icons of Upload when its list-type is picture-card, #7857
• Added sort-by attribute for TableColumn, #7828 (by @wangfengming)
• Fixed DatePicker sometimes displaying wrong year number when selecting the first week in week mode, #7860 (by @hh23485)
• Fixed icon style error of vertical Steps, #7891
• The hot area for node arrows in Tree is expanded, #7891

2.0.1

2017-10-28

• Fixed style error of RadioButton and CheckboxButton, #7793
• Fixed TimePicker not respond to mouse scroll in some conditions, #7811
• Fixed incomplete styles of some components when imported on demand, #7811

2.0.0 Carbon

2017-10-27

New features

• General
  • A new theme: theme-chalk
  • Accessibility of the following components are improved: Alert, AutoComplete, Breadcrumb, Button, Checkbox, Collapse, Input, InputNumber, Menu, Progress, Radio, Rate, Slider, Switch, Upload
  • Added TypeScript typings
  • All existing icons are redesigned. Some new icons are added
  • Added a series of breakpoint-based utility classes that hide elements when the viewport size meets certain conditions
  • Added layout components: Container, Header, Aside, Main, Footer
  • Now you can configure component sizes globally. When importing Element, you can add a global config object with a size prop to configure default sizes for all components.
• Button
  • Added round attribute. It's used for round-cornered Buttons #6643
• TimeSelect
  • Now can be navigated by Up and Down, and hitting Enter selects the time #6023
• TimePicker
  • Now can be navigated by arrow keys, and hitting Enter selects the time #6050
  • Added start-placeholder and end-placeholder. They're placeholders for the two input boxes in range mode #7169
  • Added arrow-control attribute to spin the time with arrows #7438
• Tree
  • Now child nodes don't render before the first expand #6257
  • Added check-descendants attribute. It determines if child nodes are checked when checking their parent node in lazy mode #6235
• Tag
  • Added size attribute #7203
• Datepicker
  • Now timeFormat can format the TimePicker when type is set to datetimerange #6052
  • Added start-placeholder and end-placeholder. They're placeholders for the two input boxes in range mode #7169
  • Added value-format attribute to customize the format of the binding value, #7367
  • Added unlink-panels attribute to unlink the two date panels when selecting a date range
• MessageBox
  • Added closeOnHashChange attribute #6043
  • Added center attribute so that the content can be centered #7029
  • Added roundButton attribute to display round Buttons #7029
  • Added dangerouslyUseHTMLString attribute. When set to true, message will be parsed as HTML string^* #6043
  • Added inputType attribute to assign type for the inner input box, #7651
• Dialog
  • Added width、fullscreen、append-to-body attributes. Now Dialog can be nested
  • Added center attribute so that the content can be centered #7042
  • Added focus-after-closed、focus-after-open to improve accessibility #6511
• ColorPicker
  • Now you can type colors in the input box #6167
  • Added size and disabled attributes #7026
  • Added popper-class attribute #7351
• Message
  • Now color of the icons can be overridden by CSS #6207
  • Added dangerouslyUseHTMLString attribute. When set to true, message will be parsed as HTML string^* #6207
  • Added center attribute so that the content can be centered #6875
• Notification
  • Added position attribute to configure where Notification pops up #6231
  • Added dangerouslyUseHTMLString attribute. When set to true, message will be parsed as HTML string^* #6231
  • Added showClose attribute to hide the close button #6402
• Rate
  • Added show-score attribute to determine if current score is displayed #6295
• Tabs
  • Added tab-position attribute #6096
• Radio
  • Added border and size attributes #6690
• Checkbox
  • Added border and size attributes #6690
• Alert
  • Added center attribute so that the content can be centered #6876
• Menu
  • Added background-color, text-color and active-text-color attributes #7064
  • Added open and close methods to open and close SubMenu programmatically, #7412
• Form
  • Added inline-message attribute to determine if the validation message is displayed in inline style #7032
  • Added status-icon attribute to display a feedback icon when validated #7032
  • Form and FormItem now have a size attribute. Inner components will inherit this size if not specified on themselves, #7428
  • validate method will now return a promise if the callback is omitted, #7405
  • Added clearValidate method for clearing validating results for all form items, #7623
• Input
  • Added suffix and prefix named slots, suffixIcon and prefixIcon attributes to add contents inside the input box #7032
• Breadcrumb
  • Added separator-class attribute to support icons as item separators #7203
• Steps
  • Added simple attribute to activate simple-styled Steps #7274
• Pagination
  • Added prev-text and next-text attributes to customize texts of previous page and next page #7005
• Loading
  • Now you can customize spinner icon and background color with spinner and background prop, #7390
• Autocomplete
  • Added debounce attribute, #7413
• Upload
  • Added limit and on-exceed attributes to limit the amount of files, #7405
• DateTimePicker
  • Added time-arrow-control attribute to activate arrow-control of the nesting TimePicker, #7438
• Layout
  • Added a new breakpoint xl for viewport wider than 1920px
• Table
  • Added span-method attribute for merging cells
  • Added clearSort method to clear sorting programmatically
  • Added clearFilter method to clear filter programmatically
  • For expandable rows, when a row is expanded, a .expanded class will be added to its class list, so that you can customize its style
  • Added size attribute
  • Added toggleRowExpansion method to expand or collapse expandable rows programmatically
  • Added cell-class-name attribute to assign class name for cells
  • Added cell-style attribute to style cells
  • Added header-row-class-name attribute to assign class name for header rows
  • Added header-row-style attribute to style header rows
  • Added header-cell-class-name attribute to assign class name for header cells
  • Added header-cell-style attribute to style header cells
  • TableColumn's prop attribute now accepts object[key] notations
  • Added index attribute for TableColumn to customize row indices
• Select
  • Added reserve-keyword attribute for reserving current search keyword after selecting an option

Bug fixes

• DatePicker
  • Fixed v-model returning the second day of the selected week in week mode #6038
  • Fixed the first input being cleared in daterange type #6021
• DateTimePicker
  • Fixed DateTimePicker and TimePicker affecting each other when picked #6090
  • Fixed hour and second can be beyond limit when selecting time #6076
• TimePicker
  • Fixed v-model not update correctly when blurred #6023
• Dialog
  • Fixed texts having blurry edges when opening and closing nesting dropdowns #6088
• Select
  • Improved performance. Now Vue dev-tool won't crash when a large number of Selects are destroyed #6151
• Table
  • Fixed a bug that Table remains hiding when its parent element appears from display: none
  • Fixed Table expanding its width when its parent element has display: flex
  • Fixed a bug that fixed columns of a Table with append slot would disappear when data is dynamically fetched
  • Fixed expand-row-keys attribute not working with initial value
  • Fixed filter failing when data updates
  • Fixed a calculation error of fixed columns layout with grouped headers
  • Fixed a dynamic max-height bug
  • Fixed some style calculation errors

Breaking changes

• General
  • Removed theme-default
  • Compatible with Vue 2.5.2+ and IE 10+
  • change event of form components and current-change event of Pagination now only trigger on user interaction
  • size attribute of Button and form components now accept medium, small and mini
  • To facilitate the use of third-party icons, icon attribute of Button and Steps, prefix-icon and suffix-icon attributes of Input now require a full class name
• Dialog
  • Removed size attribute. Now the size of Dialog can be configured by width and fullscreen
  • Now the visibility of Dialog cannot be controlled by v-model
• Rate
  • text-template is renamed to score-template
• Dropdown
  • menu-align is renamed to placement. Now it supports more positions
• Transfer
  • footer-format is renamed to format
• Switch
  • Attributes starting with on-* will be parsed to events in JSX, making all on-* attributes of Switch not able to work in JSX. So on-* attributes are renamed to active-*, and accordingly off-* attributes are renamed to inactive-*. This change affects the following attributes: on-icon-class, off-icon-class, on-text, off-text, on-color, off-color, on-value, off-value
  • active-text and inactive-text attributes now don't have default values
• Tag
  • type attribute now accepts success, info, warning and danger
• Menu
  • Removed theme attribute. The color of Menu can be configured using background-color, text-color and active-text-color
• Input
  • Removed icon attribute. Now the suffix icon can be configured using suffix-icon attribute or suffix named slot
  • Removed on-icon-click attribute and click event. Now to add click handler on icons, please use named slots
  • change event now behaves like the native input element, which triggers only on blur or pressing enter. If you need to respond to user input in real time, you can use input event.
• Autocomplete
  • Removed custom-item attribute. Now the template of input suggestions can be customized using scoped slot
  • Removed props attribute. Now you can use value-key attribute to designate key name of the input suggestion object for display
• Steps
  • Removed center attribute
  • Now the Steps will fill its parent container by default
• DatePicker
  • The params of DatePicker's change event is now the binding value itself. Its format is controlled by value-format
• Table
  • Removed support for customizing column template using inline-template
  • sort-method now aligns with Array.sort. It should return a number instead of a boolean
  • append slot is moved outside the tbody element to avoid multiple rendering
  • expand event is renamed to expand-change
  • The params of row-class-name and row-style method is now an object

^* Dynamically rendering arbitrary HTML on your website can be very dangerous because it can easily lead to XSS attacks. So when dangerouslyUseHTMLString is on, please make sure the content of message is trusted, and never assign message to user-provided content.