UNPKG

65.4 kBMarkdownView Raw
1## Changelog
2
3### 2.13.2
4
5*2020-05-18*
6
7#### Bug fixes
8
9- Autocomplete
10 - Fix change event bug (#19200 by @sxzz)
11- Image
12 - Update error status (#19194 by @lhx6538665)
13
14#### Optimization
15
16- I18n
17 - Update ru-RU popconfirm translation (#19220 by @Opppex)
18 - Update vi translation (#19244 by @quangln2810)
19 - Update Catalan and Spanish translations (#19296 by @Ismaaa)
20 - Update Indonesia translation (#19320) by @therour)
21 - Update Brazilian Portuguese translation (#19374 by @diegomengarda)
22
23### 2.13.1
24
25*2020-04-13*
26
27#### New features
28- Autocomplete
29 - Add change event (#17913 by @sxzz)
30
31#### Bug fixes
32
33- Autocomplete
34 - Fix suggestion error when textarea (#18478 by @Roojay)
35- Carousel
36 - Fix console typo bug (#18264 by @IceFox)
37- Image
38 - Fix preview dose not show when preview list not contain src issue (#18975) (#19130 by @luckyCao)
39 - Fix shortcut key not work at second time issue (#18983) (#19156 by @luckyCao)
40 - Don't show image-viewer when preview is false (#18967 by @inooNgt)
41- Transfer
42 - Fix incorrect line-height of el-transfer's first list item when it was used with el-form-item (#18917 by @Hanx)
43- InputNumber
44 - Correctly compute inputNumberDisabled (#18439 by @ashuser-pendo)
45- Chore
46 - Remove index intro (#19155 by @iamkun)
47- Doc
48 - Popconfirm doc update (#18324 by @iamkun)
49 - Fix step-strictly docs typo (#18705 by @dream2023)
50 - Fix a type error in document of steps component (#17555 by @haoranyu)
51
52### 2.13.0
53
54*2019-11-26*
55
56#### New features
57
58- Popconfirm
59 - Add popconfirm component (#17548 by @iamkun)
60
61#### Bug fixes
62
63- BackTop
64 - Use cubic bezier scrolling (by @lon)
65- DatePicker
66 - Fix bug of only select min date of date range problem (#17191 by @smk0621)
67- Select
68 - Fix select test cases by (@msidolphin)
69- Tree
70 - Add font-size for the style of tree empty-text (#17094 by @spengjie)
71- Table
72 - Column header can be costumed (#17291 by @ziyoung)
73 - Update table header cell style (#17284 by @ziyoung)
74 - Fix table header height after filter (#17348 by @ziyoung)
75 - Fixed row-style with display not work (#17002 by @a631807682)
76 - Fix header table not display (#17341 by @ziyoung)
77- Calendar
78 - Import el-button and el-button-group (#17376 by @masongzhi)
79- MessageBox
80 - Fix icon position error (#17410 by @nullptru)
81- TimePicker
82 - Set the selection range after scrolling up or down (#16868 by @mattheyan)
83- Message
84 - Fix close instace offsetHeight(#17564) (#17852 by @gzwgq222)
85- Form
86 - Callback of validateField should be optional (#17314 by @CarterLi)
87- Cascader
88 - Fix TypeScript 3.7 compatibility (#17881 by @CarterLi)
89- Menu
90 - Fix router NavigationDuplicated error when using vue-router@^3.1.0 (#17269 by @iamkun)
91- Dropdown
92 - Update type file (#17550 by @iamkun)
93- Progress
94 - Add strokeLinecap prop (#17552 by @iamkun)
95- InfiniteScroll
96 - Skip trigger event on invisible element (#17553 by @iamkun)
97- Image
98 - Perfect picture preview behavior (#16985 by @luckyCao)
99 - Fix shield the page when preview big image (#16796 by @luckyCao)
100- Drawer
101 - Bugfix drawer-append-to-body-not-working (#16953 by @JeremyWuuuuu)
102- Select
103 - Fix tag show value or empty issue (17199 by @luckyCao)
104- Scrollbar
105 - Fix FireFox scroll bar width (#18091 by @iamkun)
106
107#### Optimization
108
109- I18n
110 - Update sv-SE.js (#17926 by @FOLLGAD)
111 - Update avatar component fr doc (#17762 by @blombard)
112- Docs
113 - Fix time-select typo (#17250 by @wacky6)
114 - Fix Drawer attribute accepted value typo in es (#17122 by @haoranyu)
115 - Update Spanish changelog 2.12.0 (#17364 by @Gonzalo2310)
116 - Fix Changelog typo (#17874 by @renlixin)
117 - Fix Loading demo (#17862 by @MBearo)
118 - Add input event in input Events Table (#18061 by @zhouxinyong)
119 - Delete Input repeat change event (#18085 by @zhouxinyong)
120
121### 2.12.0
122
123*2019-08-29*
124
125#### New features
126
127- Popover
128 - Add close-delay prop (#16671 by @LachlanStuart)
129- Theme
130 - Add Chrome Extension: Element Theme Extension (#16686 by @iamkun)
131- Icon
132 - Add font-display to @font-face declaration (#16805 by @iamfaizalandyka)
133
134#### Bug fixes
135
136- Carousel
137 - Fix onChange emit value (#16705 by @iamkun)
138- Notification
139 - Fix modifying incoming option object (#16704 by @iamkun)
140- DatePicker
141 - Add className for picker option (#16632 by @iamkun)
142- DateTimePicker
143 - Fix time-spinner not scroll to right position (#16854 by @jesse-li)
144- Table
145 - Prevent click handler after drag (#16850 by @ziyoung)
146 - Fix chrome crash when set thead css display to none (#16956 by @luckyCao)
147 - Fix wrong empty block height (#16861 by @ziyoung)
148 - Not throw error when calling toggleExpansion (#16304 by @yyjjqq94)
149 - Not trigger sort-change event when mounted (#17113 by @a631807682)
150 - Fix setCurrentRow unable to clear highlight row (#16879 by @ziyoung)
151 - Fix expand-row-keys not work when data is loaded asynchronously (#16899 by @ziyoung)
152 - set toggleAllSelection as instance property (#17137 by @ziyoung)
153- Tree
154 - Fix distance between label and checkbox (#16799 by @Hazlank)
155- Tabs
156 - Fix incorrect TabItem's position (#16520 by @victorting)
157 - Fix activated tab is out of visual range bug (#17033 by @nullptru)
158- Calendar
159 - Fix weekdays i18n issue (#16772 by @ubitoffee)
160 - fix locale error (#17208 by @iamkun)
161- Cascader
162 - Fix CascaderPanel display error (#16716 by @zhangHongEn)
163 - Fix disable status and close button issue (#16224 by @yyjjqq94)
164- Input
165 - Fix Korean composition event (#15069 by @MoonHyuk)
166 - Fix click event of clear button not trigger when using v-loading (#16576 by @a631807682)
167- Select
168 - Not toggle dropdown when filtering (#17205 by @luckyCao)
169- Transfer
170 - Fix style error (#17206 by @iamkun)
171- Dialog
172 - update sass var (#16365 by @haoranyu)
173- RadioGroup
174 - Not produce invalid HTML in table if "is" attribute is specify (#17070 by @nullptru)
175- Divider
176 - Support custom classes (#17078 by @island205)
177
178#### Optimization
179
180- Checkbox
181 - Improve screen reader experience (#16575 by @tylertrotter)
182- Docs
183 - Update changelog (#16773 by @SimonaliaChen)
184 - Update contributing guide (#14800 by @sinchang)
185 - Fix typo in Drawer docs (#16848 by @winkay)
186 - Update custom theme (#16983 by @iamkun)
187 - Add Esperanto translation (#16955 by @maxkoryukov)
188 - Update input-number document about change event (#16316 by @luckyCao)
189 - Update spanish doc 2.11.1 (#16961 by @Gonzalo2310)
190- I18n
191 - Remove translation of 'year' in catalan language as in the other languages (#14722 by @oscaralbareda)
192 - Update spanish changelog 2.10.0 and 2.10.1 (#16548 by @Gonzalo2310)
193 - Update ar.js (#16653 by @l3op)
194- Test
195 - Correct spelling error (#16672 by @boomler)
196 - Refactor unit test to use data-uri (#16847 by @a631807682)
197- Types
198 - Fix httprequest type (#16633 by @luckyCao)
199
200### 2.11.1
201
202*2019-07-26*
203
204#### Bug fixes
205
206- Image
207 - Fix Image component SSR compatibility (#16737 by @luckyCao)
208- Chore
209 - Update dart-sass compatibility (#16744 by @LewisChennnnn)
210
211### 2.11.0
212
213*2019-07-25*
214
215#### New features
216
217- Drawer
218 - Add drawer component (#16577 by @JeremyWuuuuu)
219
220#### Bug fixes
221
222- Checkbox
223 - Enhance css selector (#16006 by @Hazlank)
224- Tree
225 - Make el-tree generic (#15934 by @JeremyWuuuuu)
226 - Set isCurrent prop to False (#15870 by @kkkisme)
227- Dropdown
228 - Fix split-button caret default color (#15931 by @JuniorTour)
229- Cascader
230 - Fix level 1 children is empty update problem (#16399 by @luckyCao)
231 - Add sets default values when lazy is true (#16420 by @luckyCao)
232 - Fix display errors when node value is duplicate (#15935 by @junyiz)
233 - Expose getCheckedNodes and fix options change bug (#16709 by @SimonaliaChen)
234- Calendar
235 - Display correct header when range is specified (#16354 by @ziyoung)
236- Submenu
237 - Fix prop append-to-body (#16289 by @a631807682)
238- Table
239 - Fix tree table when updating data (#16481 by @island205)
240- Select
241 - Fix memory leak issue (#16463 by @island205)
242- InfiniteScroll
243 - Update naming & doc (#16698 by @iamkun)
244- Avatar
245 - Fix image not center vertically issue (#16489 by @luckyCao)
246- Dialog
247 - Add destroyOnClose attribute (#16455 by @ziyoung)
248- Image
249 - Add big Image preview feature (#16333 by @luckyCao)
250
251#### Optimization
252
253- Docs
254 - Fix dropdown demo (#16193 by @webxmsj)
255 - Fix typo in table documents (#15971 by @howiefh)
256- I18n
257 - Update translation of Thai language (#16689 by @ponkrit)
258- Chore
259 - Update theme base api (#16607 by @iamkun)
260 - Add form theme token (#16699 by @iamkun)
261 - Mark ali inner user's access (#16609 by @iamkun)
262 - Fix doc anchor bug (#16692 by @iamkun)
263
264### 2.10.1
265
266*2019-07-02*
267
268#### Bug fixes
269
270- Table
271 - Fix sort icon (#15439 by @bezany)
272 - Fix layout breaks when append slot exists (#16332 by @ziyoung)
273 - Fix showOverflowTooltip not reactive (#16295 by @a631807682)
274 - Register scrollbar in filter-panel (#16246 by @ziyoung)
275- Chore
276 - Fix 2.9 docs (#16233 by @ziyoung)
277 - Fix index page theme intro english css style issue (#16254 by @iamkun)
278
279#### Optimization
280
281- Tag
282 - Compatible with IE (#16334 by @ziyoung)
283- Chore
284 - Update Dingtalk Group QR image (#16236 by @iamkun)
285- Doc
286 - Update online theme roller doc (#16244 by @iamkun)
287
288### 2.10.0
289
290*2019-06-25*
291
292#### New features
293
294- I18n
295 - Added Uzbek language (#15796 by @ogabek96)
296- Calendar
297 - Add first-day-of-week attribute (#16047 by @ziyoung)
298- Avatar
299 - Add avatar component (#16144 by @luckyCao)
300- Upload:
301 - Add capability to customize thumbnail template (#13192 by @victorzhuk)
302
303#### Bug fixes
304
305- Tree
306 - Not highlight tree node when currentKey is null (#15668 by @yyjjqq94)
307 - Fix issue #15538 caused by two Tree sharing the same data (#15615 by @VanMess)
308- Upload
309 - Update the parameter `fileList` type (#15716 by @underfin)
310- Table
311 - Fix loading icon not display (#15868 by @ziyoung)
312 - Fix background color of complex table when hovering (#15504 by @cnlon)
313 - Fix current-row-key and select event bug (#15983 by @ziyoung)
314 - Height accepts more units (#16013 by @ziyoung)
315 - Fix reserve-selection not work (#16135 by @ziyoung)
316- Docs
317 - Fix Divider attribute type in zh-cn (#15889 by @haoranyu)
318- Menu
319 - Fixed submenu hidden bug after adding popper-append-to-body (#15391 by @PanJiaChen)
320- Select
321 - Fix initialInputHeight (#15989 by @yyjjqq94)
322 - Fix default-first-option behavior when typing Chinese (#15431 by @VanMess)
323 - fix double import problem (#16215 by @lengband)
324- Message
325 - Add type def for offset option (#16027 by @matjaz)
326- Timeline
327 - Fix reverse broken (#16091 by @ziyoung)
328- Slider
329 - Fix #15545 by adding explains about "input" event in Chinese (#15588 by @VanMess)
330- InfiniteScroll
331 - Update package name (#16125 by @iamkun)
332- MessageBox
333 - Fix  distinguishCancelAndClose action not same as docs bug (#15438 by @qingdengyue)
334- PopupManager
335 - Fix z-index cannot be rewritten at first using (#15738 by @luckyCao)
336- Docs
337 - Delete an incorrect closing html tag and empty block code (#16194 by @Alexeykhr)
338- Chore
339 - Update test api host (#15807 by @iamkun)
340
341#### Optimization
342
343- Tree
344 - Modify loop conditions to improve performance (#15699 by @KingJeason)
345- Theme
346 - Refine GA track & Update footer link forward to online theme roller (#16007 by @island205)
347- Badge
348 - Update badge prop check (#16198 by @iamkun)
349- Avatar
350 - Update theme config var (#16202 by @luckyCao)
351- I18n
352 - Update pt-br.js (#15776 by @gigioSouza)
353 - Update Farsi translation (#15881 by @pamenary)
354- Docs
355 - Add missing components in quickstart (#16063 by @pape2016)
356 - Update french translation (#16208 by @blombard)
357 - Add description $slots.default (#15444 by @Alexeykhr)
358 - Update Spanish Doc 2.9.1 (#15840 by @Gonzalo2310)
359 - Fix spelling mistakes in fr (#15837 by @blombard)
360 - Update changelog 2.9.2 Spanish (#16185 by @Gonzalo2310)
361
362#### Breaking changes
363
364- Form
365 - Remove success status (#16159 by @ziyoung)
366
367### 2.9.2
368
369*2019-06-21*
370
371#### Bug fixes
372
373- Chore
374 - Fix TS definitions file (#15805 by @NateScarlet)
375
376### 2.9.1
377
378*2019-05-30*
379
380#### New features
381
382- Table
383 - default-expand-all, expand-row-keys, toggle-row-expansion method and expand-change event are supported in Tree Table (#15709 by @ziyoung)
384
385#### Bug fixes
386
387- Table
388 - Fix some bugs (#15709 by @ziyoung)
389- Theme
390 - Update api host (#15784 by @iamkun)
391
392#### Optimization
393
394- Chore
395 - Update InfiniteScroll type (#15794 by @iamkun)
396
397### 2.9.0
398
399*2019-05-30*
400
401#### New features
402
403- Backtop
404 - Add Backtop component (#15541 by @iamkun)
405- PageHeader
406 - Add PageHeader component (#15714 by @ziyoung)
407- InfiniteScroll
408 - Add InfiniteScroll directive (#15567 by @iamkun)
409- Cascader
410 - Add multiple mode and filter-method (#15611 by @SimonaliaChen)
411- Message
412 - Display in stack mode (#15639 by @island205)
413- Tag
414 - Add prop effect (#15725 by @SimonaliaChen)
415- Tabs
416 - Left align title when type is card (#15695 by @luckyCao)
417- DatePicker
418 - Support literal strings (#15525 by island205)
419- Image
420 - Add support for transmit attrs and listeners (#15578 by @VanMess)
421- Theme
422 - Add popup background (#15412 by @iamkun)
423- Chore
424 - Update new 2.9.0 index page (#15682 by @iamkun)
425
426#### Bug fixes
427
428- Table
429 - Fix sort-change behaviour when sort condition is null (#15012 by @joelxr)
430- Image
431 - Fix ssr and object-fit compatibility (#15346 by @SimonaliaChen)
432- Input
433 - Fix show-word-count style in el-form (#15359 by @lvjiaxuan)
434 - Fix clear icon is not centered (#15354 by @YiiGuxing)
435- Calendar
436 - Fix not correct day of week when the day is Sunday (#15399 by @qingdengyue)
437 - Fix October disappear bug (#15394 by @qingdengyue)
438- Tabs
439 - Fix basic tab nested in card tab padding error (#15461 by @SimonaliaChen)
440- Tag
441 - Fix stop propagation problem (#15150 by @infjer)
442- Form
443 - Fix input-group within form-item height error (#15457 by @SimonaliaChen)
444 - Fix resetFields issue (15181 by @luckyCao)
445- Tooltip
446 - Fix custom tabindex not work (#15619 by @SimonaliaChen )
447- Link
448 - Fix link icon style class (#15752 by @iamkun)
449- Select
450 - Revert set value to null when cleared (#15447 by @iamkun)
451- Loading
452 - Fix dom not change when loading state change quickly (#15123 by @FAKER-A)
453- Switch
454 - Label with el-switch repeating event (#15178 by @FAKER-A)
455- Slider
456 - Fix style problem when clicking slider bar(#15561 by @luckyCao)
457- Radio
458 - Fix issue 14808 (#14809 by @OverTree)
459- Form
460 - Fix resetFields issue (15181 by @luckyCao)
461- Chore
462 - Upgrade dependencies and fix demo bug (#15324 by ziyoung)
463- Type
464 - Fix loading type definition (#15635 by @iamkun)
465 - Fix Icon type (#15634 by @iamkun)
466 - Fix Link type definition (#15402 by @iamkun)
467
468#### Optimization
469
470- Cascader
471 - Refactor (#15611 by @SimonaliaChen)
472- Chore
473 - Update make new component logic (by @iamkun)
474- Docs
475 - Rename variable in docs (#15185 by @liupl)
476 - Fix image attribute type and default value (#15423 by @haoranyu)
477 - Fix form doc bug (#15228 by @SHERlocked93)
478
479### 2.8.2
480
481*2019-04-25*
482
483#### Bug fixes
484
485- Icon
486 - Update icon (#15272 by @iamkun)
487- Docs
488 - Fix Form and Input doc style (#15273 by @ziyoung)
489
490### 2.8.1
491
492*2019-04-25*
493
494#### Bug fixes
495
496- Icon
497 - Update icon of cascader and select (#15264 by @SimonaliaChen)
498 - Update icon (#15258 #15268 by @iamkun)
499
500#### Optimization
501
502- Chore
503 - Update build script (#15267 by @ziyoung)
504- Docs
505 - Fix link underline color (#15265 by @iamkun)
506- Other
507 - Fix migrating config not compatible with camel case props and events (#15260 by @SimonaliaChen)
508
509### 2.8.0
510
511*2019-04-25*
512
513#### New features
514
515- Divider
516 - Add divider component (#15055 by @island205)
517- Rate
518 - Add custom colors and icon-classes by passing a object (#15051 by @SimonaliaChen)
519- Link
520 - Add link component (#15052 by @iamkun)
521- Calendar
522 - Add calendar component (#14908 by @ziyoung)
523- Icon
524 - Add icon (#15214 by @iamkun)
525- Alert
526 - Add dark theme (#15041 by @island205)
527- Image
528 - Add image component (#15117 by @SimonaliaChen)
529- Collapse
530 - CollapseItem can be disabled (#15076 by @ziyoung)
531- Carousel
532 - Add direction attribute and support vertical direction (#15122 by @ziyoung)
533- Pagination
534 - Add hide-on-single-page attribute (#15096 by @ziyoung)
535- Slider
536 - Add marks attribute (#15133 by @luckyCao)
537- Input
538 - Add show-word-count attribute (#15075 by @luckyCao)
539- InputNumber
540 - Add step-strictly attribute (#15050 by @luckyCao)
541- Tooltip, Dropdown, Popover
542 - Support tabindex attribute (#15167 by @ziyoung)
543
544#### Bug fixes
545
546- Notification
547 - Fix title word break (#15008 by @iamkun)
548- Form
549 - Fix switching the rules in el-form not work (#14985 by @luckyCao)
550 - Fix label style (#14969 by @ziyoung)
551 - Required FormItem displays asterisk when label is auto (#15144 by @ziyoung)
552- Pagination
553 - Fix slot not updated (#14711 by @lucyhao)
554- Table
555 - Fix load bug in lazy mode (#15101 by @ziyoung)
556 - Fix cell width when colspan is grater than 1 (#15196 by @ziyoung)
557 - Improve performance (#14868 by @ziyoung)
558 - Don't emit triggers sort-change during initialization (#14625 by @PeanutWatson)
559 - Equal behaviour for height and max-height (#14660 by @arthurdenner)
560- Dialog
561 - Fix dialog body correctly break long words (#15027 by @iamkun)
562- Alert
563 - update type definition (#15186 by @ziyoung)
564- Tabs
565 - Fix issue where Promise rejection was hitting application (#14816 by @ffxsam)
566 - Rerender when slot changes (#15238 by @ziyoung)
567- Message
568 - Fix type definition (#14968 by @agoni1212)
569- Select
570 - Fix error when value is undefined or null (#15022 by @luckyCao)
571- Tree
572 - Delete current node after it removed (#14604 by @sinchang)
573 - Improve performance (#14881 by @ChenZhuoSteve)
574- Dropdown
575 - Fix style (#14907 by @doing123)
576- Slider
577 - Fix broken keyboard a11y bug (#14792 by @erezsob)
578- Menu
579 - ActiveIndex value shall be null if defaultIndex does not exist(#14074 by @hoythan)
580- Directive
581 - RepeatClick: use Date.now() instead of new Date() (#14776 by @pavelmash)
582- Upload
583 - Fix Upload transparent picture display style (#15039 by @iamkun)
584- Theme
585 - Add zero border (#15256 by @iamkun)
586
587#### Optimization
588
589- Chore
590 - Update changelog zh-cn (#14965 by @iamkun)
591 - Hide demo description when it's empty (#15014 by @ziyoung)
592 - Display dev server info by default by @iamkun)
593 - Fix 2.6.0 changelog error (#15026 by @iamkun)
594 - Update build config (#14821 by @abc3660170)
595 - Add hmr (#15221 by @SimonaliaChen)
596 - Use sourcemap in dev environment (#15087 by @ibufu)
597Docs
598 - Rename variable in docs (#14602 #15003 #15094 #15105 by @liupl)
599 - Fix upload doc error (#15023 by @iamkun)
600 - Update Form custom validator doc (#15040 by @iamkun)
601 - Update Tabs docs to display vertical tabs (#15053 by @iamkun)
602 - Use eleme.cn as domain (#15139 by @ziyoung)
603 - Fix Image route name (#15194 by @iamkun)
604 - Remove duplicated fr translation (#15207 by @iamkun)
605
606#### Breaking changes
607
608- Rate
609 - Fix decimal display support in disabled mode (#15089 by @haoranyu)
610- Select
611 - Use placeholder option label to set placeholder in filter mode (#14989 by @ibufu)
612
613### 2.7.2
614
615*2019-04-03*
616
617#### Bug fixes
618
619- Form
620 - Fix auto `label-width` style (#14955 by @ziyoung)
621
622#### Optimization
623- Docs
624 - Fix doc img link error (#14957 by @iamkun)
625- Chore
626 - Fix deploy mkdir error (#14952 by @iamkun)
627
628### 2.7.1
629
630*2019-04-03*
631
632#### Bug fixes
633
634- Select
635 - Set value to null when cleared (#14322 by @aaronfulkerson)
636- Input
637 - Update DOM dependent values on type change (#14889 by @wacky6)
638- Table
639 - Make `defaultExpandAll` works when expanded column exists (#14935 by @ziyoung)
640- Dialog
641 - Background color can be configured (#14939 by @ziyoung)
642- Form
643 - `label-width` supports auto width (#14944 by @ziyoung)
644
645#### Optimization
646- Docs
647 - Update Spanish docs (#14913 by @Gonzalo2310)
648 - Add French doc for new component (#14924 by @ziyoung)
649 - Optimize Tabs docs (#14938 by @ziyoung)
650
651### 2.7.0
652
653*2019-03-28*
654
655#### New features
656
657- Table
658 - Add support tree structure data (#14632 by @ziyoung)
659
660#### Bug fixes
661
662- Tabs
663 - Use primary color as boxShadow color (#14558 by @Richard-Choooou)
664 - Rerender when label changes (#14496 by @akki-jat)
665- Table
666 - Footer follows body cell align (#14730 by @ziyoung)
667- NavMenu
668 - Fix click el-submenu trigger childMenu pop again bug (#14443 by @PanJiaChen)
669- Dropdown
670 - Make compatible with 2.6 new v-slot syntax (#14832 by @ziyoung)
671- ColorPicker
672 - Fix handle error hex color string (#14793 by @iamkun)
673- Tree
674 - Revert pr #13349 (#14847 by @ziyoung)
675- Tooltip
676 - Display when initial value is true (#14826 by @ziyoung)
677- Docs
678 - Update cascader docs (#14442 by @panhezeng)
679- Style
680 - Fix media query in sm-only, md-only, lg-only (#14611 by @sinchang)
681
682#### Optimization
683
684- Chore
685 - Add webpage description (#14802 by @iamkun)
686
687### 2.6.3
688
689*2019-03-21*
690
691#### Bug fixes
692
693- Fix Cascader demo style (#14789 by @ziyoung)
694- Remove unnecessary DOM operation (#14788 by @ziyoung)
695- Fix DatePicker default-value DST (#14562 by @wacky6)
696
697### 2.6.2
698
699*2019-03-21*
700
701#### New features
702
703- DatePicker
704 - Add monthrange for type attribute (#14487 by @zxyRealm)
705- i18n
706 - Add Croatian locale (#14360 by @danijelh)
707
708#### Bug fixes
709
710- Input
711 - Fix regression (#14572 by @wacky6)
712- DatePicker
713 - Fix first-day-of-week computation (#14523 by @sinchang)
714 - Fix week picker's value-format (#13754 by @wacky6)
715- Steps
716 - Fix issue #14502 (#14596 by @sinchang)
717 - Fix style with simple theme (#14610 by @sinchang)
718- Docs
719 - Update french doc for 2.6.1 and fix typos (#14555 by @smalesys)
720 - Rename variable in Table docs (#14587 by @likwotsing)
721 - Add french search index (#14565 by @iamkun)
722 - Fix TimePicker page style (#14579 by @ziyoung)
723 - Rename variable in Upload docs (#14593 by @liupl)
724 - French translation update (#14643 by @smalesys)
725 - Update Form async validator docs (#14694 by @iamkun)
726 - Fix tooltip doc error (#14748 by @iamkun)
727 - Fix typo (#14751 by @2bj)
728 - Fix highlighting control elements for Webkit touch (#14703 by @VladG0r)
729
730#### Optimization
731
732- Chore
733 - Update ci build script (#14600 by @ziyoung)
734 - Update ga tracking (#14560 by @iamkun)
735 - Add more ga event (#14633 by @iamkun)
736 - Update discusion group (#14741 by @iamkun)
737 - Update test deps and conf (#14735 by @wacky6)
738 - Upgrade gulp (#14745 by @ziyoung)
739 - Use codepen to display demo & fix doc error (#14747 by @ziyoung)
740
741### 2.6.1
742
743*2019-03-03*
744
745#### Bug fixes
746
747- **Don't specify node version** (by @iamkun in #14546)
748- Fix doc directory in `deloy-faas.sh` (by @ziyoung in #14553)
749- Fix date style issue in changelog for 2.6.0 (by @island205 in #14547)
750- Fix doc typo (by @wack6 in #14552)
751
752### 2.6.0
753
754*2019-03-01*
755
756#### New features
757- Timeline
758 - Add timeline component (by @jikkai in #14248)
759- DropdownItem
760 - Add icon prop to `el-dropdown-item` (by @gabrielboliveira in #14088)
761- Input
762 - Add show-password props (by @phshy0607 in #13966)
763- Select
764 - Add slot `empty` (by @elfman in #13785)
765- Autocomplete
766 - Add highlight-first-item prop (by @YamenSharaf in #14269)
767- I18n
768 - Created Armenian locale (by @hamletbarsamyan in #14214)
769- Docs
770 - French translation (by @smalesys in #12153, #14418, #14434)
771
772#### Optimization
773- Alert
774 - Update alert description default slot class (by @iamkun in #14488)
775- Input
776 - Update input password (by @iamkun in #14480)
777- InputNumber
778 - Remove unnecessary parseFloat (by @JuniorTour in #14172)
779- Menu
780 - Add support for `el-menu-item` without index (by @georgyfarniev in #13298)
781- Table
782 - Remove some html DOM operations (by @elfman in #13643)
783- Upload
784 - Optimize code (by @elfman in #13973)
785- Popup
786 - Optimize code (by @KAionro in #14413)
787- Docs
788 - Add more detail about how to run play mode for contribution (by @island205 in #14355)
789 - Warn input as a controlled component (by @wacky6 in #14463)
790 - Update Table doc (by @luguokong in #14329)
791 - Update input doc (by @iamkun in #14437)
792 - Update custom-theme docs (by @wangguohao in #14297)
793 - Make the icon style change when hover on it (by @tuxinghuan in #14295)
794- Build
795 - Minimizing css and js for Element doc site (by @iamkun in #14430)
796 - Speeding up webpack (by @hetech in #14484)
797 - Use cli to select release version (by @hetech in #14354)
798- Install stale for issue handling (by @island205 in #14392)
799
800#### Bug fixes
801- Menu
802 - Fix subMenu focus bug when switch browser tab (by @liupl in #13976)
803- MessageBox
804 - Fix type definition (by @NateScarlet in #14278)
805- ScrollBar
806 - Prevent right button click on thumb (by @xifeiwu in #14196)
807- Switch
808 - Trigger form validation if value changes (by @hetech in #14426)
809- Table
810 - Make toggleAllSelection method an instance method (by @letanure in #14075)
811- Tabs & Dropdown
812 - Fix style (by @hetech in #14452)
813- Tree
814 - Empty-text tips are different from tables (by @ColinCll in #14331)
815- Docs
816 - Fix DatetimePicker format doc error (by @iamkun in #14290)
817 - Spelling issue in datepicker documentation (by @helmut in #14481)
818 - Fix pagination doc style (by @liuchuzhang in #14451)
819
820#### Breaking changes
821- Table
822 - Fix params order of row events (by @jikkai in #12086)
823
824### 2.5.4
825
826*2019-02-01*
827
828#### Bug fixes
829
830- Build: Fix babel config issue which lead to collapse transition broken (by @island205 in #14282)
831
832### 2.5.3
833
834*2019-01-31*
835
836#### Optimization
837
838- Optimize code of Message (by @vok123 in #14029)
839- Retire gh-pages (by @ziyoung in #14266)
840- Add IssueHunt link (by @island205 in #14261)
841
842#### Bug fixes
843
844- Fix UMD module error on server side (by @island205 in #14242)
845- Fix active TabBar style (by @iamkun in #14240)
846- Fix Table demo code error (by @xunmeng in #14253)
847
848### 2.5.2
849
850*2019-01-27*
851
852#### Optimization
853- Docs:
854 - Update ChangeLog ES 2.5.1 (by @Gonzalo2310 in #14231)
855
856#### Bug fixes
857- Build:
858 - Delete unremoved comments in umd module `lib/index.js` (by @island205 in #14233)
859 - Fix export error fired in commonjs module used in nuxt.js (by @island205 in #14232)
860 - Fix 2.5.1 build issues (by @iamkun in #14228)
861
862### 2.5.1
863
864*2019-01-26*
865
866#### Optimization
867- DatePicker: highlight current month and year (by @Debiancc in #14211)
868- Update 2.5.0 changelog (by @wacky6 in #14217)
869
870#### Bug fixes
871- Fix export issue generate by webpack upgrading (by @island205 in #14220)
872- Keep 2.4.11 docs && new sub folder for 2.5+ (by @iamkun in #14222)
873
874### 2.5.0
875
876*2019-01-25*
877
878#### New features
879- DatePicker
880 - Add `validate-event` attribute (by @ziyoung in #13531)
881- DateTimePicker
882 - `pickerOptions` support `selectableRange` option (by @eeeeeeeason)
883- Tag
884 - Add `click` event (by @licdream in #14106)
885- I18n
886 - support Kyrgyz language (by @zzjframework in #14174)
887
888#### Optimization
889- Upgrade to webpack@4 (by @jikkai in #14173)
890- Input
891 - Simplify implementation, follow one-way data flow. Fix several related bugs (by @wacky6 in #13471)
892- Update Axure file,add new components (by @ziyoung in #13773)
893
894#### Bug fixes
895- Autocomplete
896 - Fix dropdown's last line beging clipped (by @ziyoung in #13597)
897 - Fix missing popper arrow (by @liuchuzhang in #13762)
898- Carousel
899 - Cleanup timer when component is destroyed (by @elfman in #13820)
900- Cascader
901 - Remove deprecated property of computed props (by @iamkun in #13737)
902 - Fix CascaderOption's type definition in TypeScript (by @NateScarlet in #13613)
903 - Fix icon covering the text (by @ziyoung in #13596)
904- Checkbox
905 - Refine style (by @PanJiaChen)
906- DatePicker
907 - Add missing v-for `key` in TimeSpinner (by @Ende93 in #13547)
908 - Fix week highlight on year boundary (by @suyi91 in #13883)
909- Input
910 - Fix textarea DOM node reference (by @laomu1988 @island205 in #13803)
911- Pagination
912 - Input value won't be less than 1 (by @elfman in #13727)
913- Popover
914 - Fix popover issues with hover trigger (by @goldengecko in #13104)
915 - Fix popper instance memory leak (by @qpxtWhite in #13988)
916- Radio
917 - Refine style (by @ohhoney1)
918- Table
919 - Enhanced table sorting when clicking on the sorting arrow (by @ohhoney1 in #12890)
920 - Fix empty text vertical alignment issue on IE10+ (by @imzjy in #13638)
921 - Fix index type documentation (by @ilovefafa in #13628)
922 - Fix `show-summary` display issue when multilevel header has fixed attr (by @luckyCao in #13914)
923- Tabs
924 - Fix auto scroll bug (by @iamkun in #13696)
925 - Get the correct tab through tab name (by @iamkun in #13705)
926 - Use paneName instead of name to determine pane style (by @iamkun in #13733)
927- Tree
928 - Fix `showCheckbox` prop on `Tree` can not affect their children `tree-node` (by @KidneyFlower)
929 - Update doc and definition file (by @ziyoung in #13540)
930- Upload
931 - Add `url` prop to upload file when `list-type` changed (by @elfman in #13771)
932- Slider
933 - Fix source code indentation (by @wacky6 in #13955)
934- I18n
935 - Add missing Catalan translations (by @jaumesala)
936 - Add missing ru translation (by @justlp in #13658)
937 - Fix Finnish translations (by @jenkrisu in #14137)
938- Doc
939 - Update Spanish doc 2.4.11 (by @Gonzalo2310 in #13522)
940- Others
941 - Remove unnecessary script (by @ziyoung)
942 - Fix error anchor link (by @iamkun in #13753)
943 - Fix inconsistent capitalization in documentation (by @wonderjar)
944 - Add DingDing chat group qr code to readme (by @iamkun in #13957)
945 - Add yarn logs to .gitignore (by @mimimi in #13922)
946 - Remove sponsor duotai (by @island205 in #14156)
947 - Update readme qr code src (by @iamkun in #13960)
948 - Update CDN link, fix typo (by @ziyoung)
949
950### 2.4.11
951
952*2018-11-21*
953
954- Revert pr #13296. Fixed clicking on Menu external causing Submenu collapsed, #13478
955- Adjust small screen (xs) media query breakpoints, #13468 (by @alekoshen712)
956
957### 2.4.10
958
959*2018-11-16*
960
961- Fixed multiple clicks on Select to display the drop-down list, #13268
962- The clear icon for input is not displayed when Form is disabled, #13208
963- Adjust the style of Select, Progress, Autocomplete, Tooltip, Collaspe, TimePicker, #13188 (by @porcelainHeart) #13210 #13266 #13257 #13290 #13347 (by @PanJiaChen)
964- Carousel component added `loop` attribute, #13217
965- When the data of Table changes, the highlighted line will remain, #13200
966- Table header scoped slot can receive parameters, #13263
967- Table's `clearFilter` method supports arguments, #13176
968- Tooltip is no longer created when there is no content in the Table cell, #13152 (by @rongxingsun)
969- The input box contents of the ColorPicker panel can be displayed correctly, #13278
970- ColorPicker no longer triggers form validation when dragging, #13299
971- InputNumber added `select `method, #13286 (by @st-sloth)
972- Autocomplete added `clear` event, #12171(by arthurdenner) #13326
973- You can close Menu by clicking on Menu outside, #13296
974- Form's `validateField` method can receive arguments, #13319
975- Cascader added `visible-change` event, #13415
976- DatePicker added range-separator slot, #13272 (by @milworm)
977- Tree adds `iconClass` and `currentNodeKey` properties, #13337 #13197 (by @isnifer)
978- Progress's` status` added text #13198 (by @ali-master)
979- Fixing tree's `defaultCheckedKeys` caused an error, #13349 (by @dive2Pro)
980
981### 2.4.9
982
983*2018-10-26*
984
985- The parameter of Form's `clearValidate` supports string, #12990 (by @codinglobster)
986- Added type attribute for Badge, #12991
987- Users can use scoped-slot to customize table column header #13012 (by @ivanseidel)
988- Fixed the input box of Select unable to type text under IE, #13034 (by @GaliMU)
989- Select option does not wrap when space is enough, #12329 (by @akki-jat)
990- When dropdown list of Select is expanded, the arrow icon will also display correctly, #12353 (by @firesh)
991- Fixed that the size attribute of Select does not work, #13070
992- Select multiple values can be cleared, #13049 (by @ZSkycat)
993- Fixed the last TabNav unable be deleted, #13039
994- Fixed that TabNav label is not displayed correctly, #13178
995- Added title slot for Alert, #13082 (by @Kingwl)
996- Fixed an issue where the tooltip content in Table was incorrect, #13159 (by @elfman)
997- Optimize the animation of Upload when file is deleted, #12987
998- Adjusted style of InputNumber when control button is not displayed, #13052
999
1000### 2.4.8
1001
1002- Not displaying outline when Switch is focused, #12771
1003- Fixed Dropdown's style in ButtonGroup, #12819 (by @bluejfox)
1004- Added opened event for Dialog, #12828
1005- Fixed the incorrect display order of TabNav, #12846
1006- Fixed the problem that Tabs did not scroll to the selected tab, #12948
1007- Fixed the problem that the identifier does not display when the Tree node is dragged, #12854
1008- The validate event parameter of Form contains the validation message, #12860 (by @YamenSharaf)
1009- Fixed DatePicker not to verify the validity of user input time, #12898
1010- Fixed the problem that `render-header` attribute of Table header doesn't work, #12914
1011
1012### 2.4.7
1013
1014*2018-09-14*
1015
1016- Fixed DatePicker not triggering form validation, #12328 #12348
1017- Fixed DatePicker throwing errors in multiple mode, #12347
1018- Fixed incorrect position of DatePicker spinner, #12415 (by @rang-ali)
1019- Fixed automatic filling of DatePicker input box, #12521 (by @abdallanayer)
1020- Fixed Input not highlighted in Cascader, #12341
1021- Fixed wrong order of Tabpane, #12346
1022- Fixed incorrect position of ColorPicker cursor, #12376 (by @cnwhy)
1023- Fixed the style of Submenu, #2457
1024- Fixed not highlighted after Submenu is selected, #12479
1025- Fixed incorrect values selected by Cascader, #12508 (by @huangjinqiang)
1026- Fixed incorrect value of Pagination input box, #12525
1027- Fixed order that Pagination triggers events, #12530
1028- Fixed Table Filter not displayed, #12539
1029- Fixed Tree unable to delete nodes, #12684
1030- Fixed height of Select Input changing in single mode, #12719
1031- Fixed style of FormItem label in nested Form, #12748
1032- Added `autocomplete` attribute for Input, deprecated `auto-complete`, #12514 (by @axetroy)
1033- Added slots-scope for Form to display validation information, #12715 (by @YamenSharaf)
1034
1035### 2.4.6
1036
1037*2018-08-09*
1038
1039- Fixed Table not showing filter icon when `filters` is assigned empty array, #12165
1040- Fixed Menu not saving active state when `collapse` is changed, #12178 (by @elfman)
1041- Fixed Cascader not escaping special characters for Regexp, #12248
1042- Fixed disabled RadioButton showing box-shadow when clicked, #12262
1043- Fixed arrow key not effect when default value is `undefined`,#12322
1044- Fixed query function of Select not debounced in multi mode, #12181
1045- Fixed query keyword of Select disappearing in multi mode, #12304
1046- Fixed incorrect width of Dialog when it is displayed in full screen, #12203
1047- Fixed incorrect display of Main on IE, #12237
1048- Fixed Input triggering two form validations, #12260
1049- Fixed adding new Tree node causing nodes to disappear, #12256
1050- Fixed Tree node not deleted after dragging, #12279
1051- Fixed Popover not visible when InputNumber focuses, #12284
1052- Added `popper-append-to-body` attribute for Autocomplete, #12241
1053- Added `sync` modifier support for Pagination's `page-size` attribute, #12281
1054
1055### 2.4.5
1056
1057*2018-07-26*
1058
1059- Fixed Table setting `class-name` does not work for `expand` column, #12006
1060- Added `toggleAllSelection` method for Table, #12047
1061- Fixed wrong position of suffix slot when Input contains Select, #12108
1062- Fixed `line-height` of Option unable to set, #12120
1063- Fixed TimeSelect with default value of `null` could not be assigned after executing `resetField`, #12010
1064- Fixed keydown event which is not arrow key does not work in Tree, #12008
1065- Fixed parent node checked in lazy mode, #12106
1066- Added `includeHalfChecked` parameter for getCheckedNodes of Tree, #12014
1067
1068### 2.4.4
1069
1070*2018-07-13*
1071
1072- Fixed triggering Select validation after Form resetting, #11837
1073- Fixed wrong position of Input `suffix` slot when `suffix` slot with `append` slot, #11951
1074- Fixed clearable Input still displaying the clear icon when readonly, #11967
1075- Fixed Tree node checked when it's disabled, #11847
1076- Fixed Tree's `default-checked-keys` not working, #11971
1077- Fixed `empty-text` not visible when Tree node filtered, #11971
1078- Fixed the position of oversized `empty-text` in Table, #11965
1079- Fixed Table row not be unhighlighted when `current-row-key` is assigned to `null`, #11866
1080- Fixed showing filter dropdown when `filters` is an empty array, #11864
1081- Fixed Radio's label does not stop event propagation, #11912
1082
1083### 2.4.3
1084
1085*2018-07-03*
1086
1087- Fixed `allow-drop` not working properly when Tree nodes have a custom height, #11797
1088- Now you can pass a parameter to the `clearValidate` method of Form, specifying which FormItems' validation results need to be cleared, #11821
1089- Added `distinguishCancelAndClose` attribute for MessageBox, #11831
1090
1091### 2.4.2
1092
1093*2018-06-26*
1094
1095- Now `class-name` and `label-class-name` of Table are reactive, #11626
1096- Fixed Table still highlighting clicked row when `highlight-current-row` is `false`, #11646
1097- Fixed a style bug of ButtonGroup when it has only one `round` or `circle` Button, #11605
1098- Fixed style of page size Select of Pagination, #11622
1099- Fixed Menu's `open` method error when `collapse` is dynamically changed, #11646
1100- Added `activeName` and `oldActiveName` parameters to the before-leave hook of Tabs, #11713
1101- Fixed Cascader focused after outside clicked, #11588
1102- Fixed Cascader not closing when option is clicked when `change-on-select` is true, #11623
1103- Now updating Select's value programmatically will trigger form validation, #11672
1104
1105### 2.4.1
1106
1107*2018-06-08*
1108
1109- Removed Autocomplete's duplicate type declaration, #11388
1110- Fixed Select's dropdown arrow style in FireFox when nested in Form, #11427
1111- Fixed clear icon of Select still showing when the initial value is `null`, #11460
1112- Fixed disabled radio showing box-shadow when clicked, #11462
1113- Added `iconClass` attribute for MessageBox, #11499
1114- Added `stretch` attribute for Tabs, #11476
1115- Fixed rendering order issue of TabPane when Tabs is `lazy`, #11461
1116- Fixed Table not retaining current highlight row when expanded, #11464
1117- Fixed focusing state when `before-leave` returns a resolved promise, #11386
1118- Fixed disabled Popover still creating poppers, #11426
1119- Fixed Tree's endless loop when a new node is added in lazy mode, #11430 (by @wangjingf)
1120- Added `closed` event for Dialog, #11490
1121
1122### 2.4.0 Fullerene
1123
1124*2018-05-28*
1125
1126#### New features
1127- General
1128 - Dev tool and bundler is switched to native webpack, #11216
1129 - Now you can globally set the initial z-index of popups, #11257
1130- Autocomplete
1131 - Added `hide-loading` attribute, #11260
1132- Button
1133 - Now you can use the `size` attribute on circle buttons to control their sizes, #11275
1134- InputNumber
1135 - Added `precision` attribute, #11281
1136- Tabs
1137 - Added `before-leave` attribute, #11259
1138 - Added `lazy` attribute, #11167(by @Kingwl)
1139- Table
1140 - Added `sort` method to manually sort the table, #11311
1141
1142#### Bug fixes
1143- Input
1144 - Fixed an issue that causes a re-render when using the Chinese IME to quickly input text, #11235 (by @STLighter)
1145- Popover
1146 - Fixed the console error when the triggering element is Radio or Checkbox, #11265
1147- Breadcrumb
1148 - Fixed the `to` attribute not supporting dynamic update, #11286
1149- Upload
1150 - Fixed the console error when a File is resolved in the returned Promise of the `beforeUpload` method, #11297 (by @qusiba)
1151- Tooltip
1152 - Fixed arrow not positioned correctly when content is empty, #11335
1153- Autocomplete
1154 - Fixed incorrect input suggestions after deleting keyword quickly, #11323
1155- ColorPicker
1156 - Fixed `active-change` event incorrectly triggering when picker dropdown is closed, #11304
1157- Table
1158 - Fixed style error of oversized filter panel, #11314
1159 - Fixed currently selected row not retained when the table is sorted, #11348
1160- Checkbox
1161 - Fixed single checkbox not supporting validation, #11271
1162- Radio
1163 - Fixed disabled Radio still being selected when pressing space key, #11303
1164- MessageBox
1165 - Fixed the `el-popup-parent--hidden` class not removed when opening MessageBox in succession, #11371
1166
1167### 2.3.9
1168
1169*2018-05-18*
1170
1171- 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
1172- The `lockScroll` attribute of pop up components no longer adds an inline style to the parent element, but instead adds a class name, #11114
1173- Fixed the icon of Progress not displaying when its `status` is exception, #11172
1174- Fixed options' `disabled` attribute not working in filterable Cascader's filter result list, #11185
1175- Fixed an issue where Table's expanded row cannot be collapsed if the data source is updated after its expansion, #11186
1176- `setCurrentKey` of Tree now accepts `null` as its param to cancel the currently highlighted node, #11205
1177
1178### 2.3.8
1179
1180*2018-05-11*
1181
1182- Fixed DatePicker panel jumping to the current month after picking a date in a non-current month when `type` is dates, #10973
1183- Fixed clearable Input still displaying the clear icon when readonly, #10912
1184- Fixed closing the DatePicker panel without changing the value incorrectly triggering the `change` event, #11017
1185- Fixed keyboard navigation not working properly when Select has grouped options, #11058
1186- Added `prefix` named slot for Select, #11063
1187- Added `clearValidate` method for FormItem, #11076
1188- Added `checkOnClickNode` attribute for Tree, #11111
1189
1190### 2.3.7
1191
1192*2018-04-29*
1193
1194- Fixed Table not updating its header widths when the scroll bar disappears due to filtering, #10834
1195- Fixed clearable Input still showing the clear icon when its initial value is `null`, #10912
1196- Fixed incorrect trigger of the `active-change` event after changing ColorPicker's binding value programatically, #10903 (by @zhangbobell)
1197- Fixed filterable Select causing an infinite loop when navigating options using keyboard if all options are disabled, #10945
1198
1199### 2.3.6
1200
1201*2018-04-21*
1202
1203- Fixed wrong behavior of Tree's `allow-drop` callback when `type` parameter is used, #10821
1204- Now you can properly enter keywords in filterable single Select in IE11, #10822
1205- Fixed single Select incorrectly triggering `blur` event after clicking an option, #10822
1206
1207### 2.3.5
1208
1209*2018-04-20*
1210
1211- Fixed incorrect highlights in DatePicker panel when `type` is week, #10712
1212- Fixed InputNumber being empty when its initial value is 0, #10714
1213- Added `automatic-dropdown` attribute for Select, #10042 (by @Seebiscuit)
1214- Fixed disabled Rate's value still being updated by navigation keys, #10726 (by @Richard-Choooou)
1215- Now DatePicker's `type` attribute can be `'dates'`, where you can pick multiple dates in one picker, #10650 (by @Mini256)
1216- Added `prev-click` and `next-click` events for Pagination, #10755
1217- Added `pager-count` attribute for Pagination, #10493 (by @chongjohn716)
1218- Added `type` as the 3rd param of Tree's `allow-drop` attribute callback, #10792
1219- Now we use ResizeObserver to detect DOM element resizing, #10779
1220
1221### 2.3.4
1222
1223*2018-04-12*
1224
1225- Deleted duplicate `showTimeout` attribute in SubMenu's TypeScript declaration, #10566 (by @kimond)
1226- Now you can customize Transfer's data item using scoped slot, #10577
1227- Fixed clicking disabled prev and next button of Pagination still triggers `current-change` event, #10628
1228- Fixed Textarea displaying `undefined` in SSR when its value is not set, #10630
1229- Fixed disabled TabItem style when `type` is border-card, #10640
1230- Added `$index` as `formatter`'s fourth param of Table, #10645
1231- Fixed CheckboxButton not exported in TypeScript declaration, #10666
1232
1233### 2.3.3
1234
1235*2018-04-04*
1236
1237- Added `shadow` attribute for Card, #10418 (by @YunYouJun)
1238- Fixed Badge being hidden when `value` is `0`, #10470
1239- Fixed some bugs of draggable Tree, #10474 #10494
1240- Added `placement` for Autocomplete, #10475
1241- Now `default-time` attribute also works in non-range DateTimePicker, #10321 (by @RickMacTurk)
1242- Removed the blue outline of TabItem after the browser blurs or is minimized, #10503
1243- Added `popper-append-to-body` attribute for SubMenu, #10515
1244- Removed visual feedback when hovering on non-link BreadcrumbItem, #10551
1245- Fixed InputNumber's `change` event to ensure the component's binding value is updated in the event handler, #10553
1246
1247### 2.3.2
1248
1249*2018-03-29*
1250
1251- Fixed an Autocomplete regression, #10442
1252
1253### 2.3.1
1254
1255*2018-03-29*
1256
1257- Fixed a regression that `type` of Input is not passed down to the native input element, #10415
1258- Added `blur` method for Select, #10416
1259
1260### 2.3.0 Diamond
1261
1262*2018-03-28*
1263
1264#### New features
1265- Table
1266 - Now `formatter` of TableColumn can be dynamically updated, #10184 (by @elfman)
1267 - Added `select-on-indeterminate` attribute, #9924 (by @syn-zeta)
1268- Menu
1269 - Added `collapse-transition` attribute, #8809 (by @limichange)
1270- Input
1271 - Added `select` method, #10229
1272 - Added `blur` method, #10356
1273- ColorPicker
1274 - Added `predefine` attribute, #10170 (by @elfman)
1275- Tree
1276 - 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)
1277- Form
1278 - `validate` method now has a second parameter, containing information of form items that failed the validation, #10279
1279 - Added `validate` event, #10351
1280- Progress
1281 - Added `color` attribute, #10352 (by @YunYouJun)
1282- Button
1283 - Added `circle` attribute, #10359 (by @YunYouJun)
1284
1285#### Bug fixes
1286- Form
1287 - Fixed label of FormItem not align with mixed Input, #10189
1288- Menu
1289 - Now collapsed Menu will only show the Tooltip when the `title` slot of MenuItem is set, #10193 (by @PanJiaChen)
1290- Pagination
1291 - Fixed `current-change` event wrongly triggering without user interaction, #10247
1292- DatePicker
1293 - Now the date and time value in the dropdown panel are correctly formatted based on the `format` attribute, #10174(by @remizovvv)
1294- Upload
1295 - Fixed `accept` attribute not working when `drag` is true, #10278
1296
1297### 2.2.2
1298
1299*2018-03-14*
1300
1301- Added `clear` event for Input, #9988 (by @blackmiaool)
1302- Now manual input of ColorPicker supports `hsl`, `hsv` and `rgb` modes, #9991
1303- Fixed DatePicker not triggering `change` event when its initial value is cleared, #9986
1304- Now icon class related attributes of Rate support dynamic updates, #10003
1305- Fixed Table with fixed columns not updating its height correctly if `max-height` is set, #10034
1306- Now DatePicker's range mode supports reverse selection (clicking the end date, then clicking the start date), #8156 (by @earlymeme)
1307- Added `disabled` attribute for Pagination, #10006
1308- Added `after-enter` and ` after-leave` events for Popover, #10047
1309- Fixed Select not triggering validation when user selects an option after executing `resetFields` of Form, #10105
1310- Fixed incorrect widths of fixed columns of Table in some cases, #10130
1311- Fixed MessageBox inheriting the `title` attribute of its previous instance when called without `title`, #10126 (by @Pochodaydayup)
1312- Added `input-size` attribute for Slider, #10154
1313- Added `left-check-change` and `right-check-change` events for Transfer, #10156
1314
1315### 2.2.1
1316
1317*2018-03-02*
1318
1319- Fixed Aside, Header and Footer shrinking in some layout, #9812
1320- Fixed Table with a `height` attribute not rendering in SSR, #9876
1321- Fixed expandable Table not calculating its height when a row is expanded, #9848
1322- Fixed `change` event not trigger when manually typing date in DateTimePicker, #9913
1323- Fixed Select showing its options when the input box is right-clicked, #9894 (by @openks)
1324- Added `tooltip-class` attribute for Slider, #9957
1325- Now Select will stay focused after selection, #9857 (by @Seebiscuit)
1326- Added `target-order` attribute for Transfer, #9960
1327
1328### 2.2.0 Graphite
1329
1330*2018-02-12*
1331
1332#### New features
1333- Menu
1334 - Added `popper-class` and `disabled` attributes for SubMenu, #9604 #9771
1335 - Horizontal Menu now supports multi-layered SubMenu, #9741
1336- Tree
1337 - Added `node-contextmenu` event, #9678
1338 - Now you can customize node template using scoped slot, #9686
1339 - Added `getNode`, `remove`, `append`, `insertBefore`, `insertAfter`, `getCheckedKeys`, `getHalfCheckedNodes`, `getHalfCheckedKeys` methods and `check` event, #9718 #9730
1340- Transfer
1341 - Added `clearQuery` method, #9753
1342- Select
1343 - Added `popper-append-to-body` attribute, #9782
1344
1345#### Bug fixes
1346- Table
1347 - Fixed clicking expanding icon of an expandable row triggers `row-click` event, #9654
1348 - Fixed layout not update when column width is changed by user dragging, #9668
1349 - Fixed style issue when summary row co-exists with fixed columns, #9667
1350- Container
1351 - Fixed container components not stretching in IE11, #9655
1352- Loading
1353 - Fixed Loading not showing when the value of `v-loading` is changed to true in the `mounted` hook, #9722
1354- Switch
1355 - Fixed two native click events are triggered when Switch is clicked, #9760
1356
1357### 2.1.0 Charcoal
1358
1359*2018-01-31*
1360
1361#### New features
1362- Cascader
1363 - Added `focus` and `blur` events, #9184 (by @viewweiwu)
1364- Table
1365 - The `filter-method` now has a third param `column`, #9196 (by @liyanlong)
1366- DatePicker
1367 - Added `prefix-icon` and `clear-icon` attributes, #9237 (by @AdamSGit)
1368 - Added `default-time` attribute, #9094 (by @nighca)
1369 - `value-format` now supports `timestamp`, #9319 (by @wacky6)
1370- InputNumber
1371 - Now the binding value can be `undefined`, #9361
1372- Select
1373 - Added `auto-complete` attribute, #9388
1374- Form
1375 - Added `disabled` attribute, #9529
1376 - Added `validateOnRuleChange` attribute, #8141
1377- Notificaition
1378 - Added `closeAll` method, #9514
1379
1380#### Bug fixes
1381- InputNumber
1382 - Fixed value resetting when typing decimal point, #9116
1383- Dropdown
1384 - Fixed dropdown menu incorrect positioning when the page only has a horizontal scrollbar in some browsers, #9138 (by @banzhuanmei)
1385- Table
1386 - Fixed an error in calculating number of fixed columns after the column data changes, #9188(by @kolesoffac)
1387 - Fixed the border of the last column of the grouped header not properly displayed, #9326
1388 - Fixed incorrect positioning of table header in Safari, #9327
1389 - Fixed expanded row collapsing when the table data changes, #9462
1390 - Fixed unnecessary multiple renders in some conditions, #9426
1391 - Fixed column width calculation error when `width` of TableColumn changes, #9426
1392- Loading
1393 - Fixed Loading not hiding correctly in some conditions, #9313
1394- DatePicker
1395 - Fixed `focus` method not working in range mode, #9437
1396 - Fixed clicking the "now" button still selecting the current date even if it is disabled, #9470 (by @wacky6)
1397 - Fixed date clamping when navigating, #9577 (by @wacky6)
1398- Steps
1399 - Fixed style error in IE 11, #9454
1400
1401#### Breaking changes
1402- Menu
1403 - The popup menu in `collapse` mode now appends directly to `body`, so that it is visible when nested in Aside, #9263
1404- Table
1405 - Now checking the checkboxes in multi-selection Table doesn't trigger `row-click` event, #9467
1406- Loading
1407 - 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
1408- Dropdown
1409 - `show-timeout` and `hide-timeout` attributes now only works when trigger is `hover`, #9573
1410
1411### 2.0.11
1412
1413*2018-01-08*
1414
1415- Fixed border color issue of Select when in `prepend` or `append` slot of Input, #9089
1416- Fixed `remove-tag` event's parameter of Select, #9090
1417- Added `show-timeout` and `hide-timeout` attributes for SubMenu, #8934 (by @HugoLew)
1418- Fixed missing Tooltip style of `show-overflow-tooltip` when Table is imported on demand, #9130
1419- Fixed Table column's sorting malfunctioning after `clearSort` is executed on that column, #9100 (by @zEmily)
1420- i18n config file for Czech is renamed from `cz` to `cs-CZ`, #9164
1421
1422### 2.0.10
1423
1424*2017-12-29*
1425
1426- Fixed wrong max height calculation of Table when fixed column and summary row co-exist, #9026
1427- Fixed uncompiled color style of empty text in Table, #9028
1428- Now DatePicker only emits `change` event when value is truly changed, #9029 (by @remizovvv)
1429- Added `tabindex` attribute for Input, #9041 (by @dicklwm)
1430
1431### 2.0.9🎄
1432
1433*2017-12-24*
1434
1435- Added `before-remove` hook function for Upload, #8788 (by @firesh)
1436- Fixed initial value of `error` not working for FormItem, #8840
1437- Now Loading directive supports custom class name by assigning `element-loading-custom-class` attribute, #8826 (by @earlymeme)
1438- Fixed CarouselItem becoming invisible when data is asynchronously updated, #8921
1439- Added `renderAfterExpand` attribute for Tree, #8972
1440
1441### 2.0.8
1442
1443*2017-12-12*
1444
1445- Added Spanish documentation
1446- Fixed `show-timeout` of Dropdown not working when trigger is click, #8734 (by @presidenten)
1447- Fixed Form validation timing for rules whose trigger is blur, #8776
1448- Fixed blur event of ranged DatePicker, #8784
1449- `format` of TimePicker now supports AM/PM, #8620 (by @firesh)
1450
1451### 2.0.7
1452
1453*2017-11-29*
1454
1455- Fixed disabled text button style, #8570
1456
1457### 2.0.6
1458
1459*2017-11-29*
1460
1461- Fixed style bug of Table's sorting icons, #8405
1462- Fixed trigger mechanism for Popover when its `trigger` is manual, #8467
1463- Added `prefix-icon` and `suffix-icon` attributes for Autocomplete, #8446 (by @liyanlong)
1464- Added `separator` attribute for Cascader, #8501
1465- Added `clearable` attribute for Input, #8509 (by @lbogdan)
1466- Added `background` attribute for Pagination, #8553
1467
1468### 2.0.5
1469
1470*2017-11-17*
1471
1472- Fixed Popover, Tree, Breadcrumb and Cascader regression in 2.0.4, #8188 #8217 #8283
1473- Fixed memory leak of clickoutside directive, #8168 #8225 (by @badpunman @STLighter)
1474- Fixed multiple Select height when its value is cleared, #8317 (by @luciy)
1475- Added `collapse-tags` attribute for multiple Select to replace tags with one line of text, #8190
1476- Fixed high CPU consumption caused by hidden Table, #8351
1477- Now you can use `doLayout` method of Table to update its layout, #8351
1478
1479### 2.0.4
1480
1481*2017-11-10*
1482
1483- Improved accessibility for Cascader, Dropdown, Message, Notification, Popover, Tooltip and Tree
1484- Fixed Container resize when the width of viewport decreases, #8042
1485- Fixed Tree's `updateKeyChildren` incorrectly deleting child nodes, #8100
1486- Fixed bordered CheckboxButton's height when nested in a Form, #8100
1487- Fixed Menu's parsing error for custom colors, #8153 (by @zhouyixiang)
1488
1489### 2.0.3
1490
1491*2017-11-03*
1492
1493- Fixed `editable` and `readonly` attributes for ranged DatePicker, #7922
1494- Fixed style error of nested Tabs, #7941
1495- Fixed style error of the last Step of vertical Steps, #7980
1496- Fixed trigger timing of `current-change` event for Pagination, #7995
1497- Fixed unregistered Tooltip in Menu, #7995
1498
1499### 2.0.2
1500
1501*2017-10-31*
1502
1503- Now right-clicking the buttons of InputNumber won't change its value, #7817
1504- `validate` method of Form can now wait for asynchronous validations before executing its callback, #7774 (by @Allenice)
1505- Fixed range selection of DatePicker not working in Chromium 53-57 browsers, #7838
1506- Fixed missing preview and delete icons of Upload when its `list-type` is picture-card, #7857
1507- Added `sort-by` attribute for TableColumn, #7828 (by @wangfengming)
1508- Fixed DatePicker sometimes displaying wrong year number when selecting the first week in week mode, #7860 (by @hh23485)
1509- Fixed icon style error of vertical Steps, #7891
1510- The hot area for node arrows in Tree is expanded, #7891
1511
1512### 2.0.1
1513
1514*2017-10-28*
1515
1516- Fixed style error of RadioButton and CheckboxButton, #7793
1517- Fixed TimePicker not respond to mouse scroll in some conditions, #7811
1518- Fixed incomplete styles of some components when imported on demand, #7811
1519
1520### 2.0.0 Carbon
1521
1522*2017-10-27*
1523
1524#### New features
1525- General
1526 - A new theme: `theme-chalk`
1527 - Accessibility of the following components are improved: Alert, AutoComplete, Breadcrumb, Button, Checkbox, Collapse, Input, InputNumber, Menu, Progress, Radio, Rate, Slider, Switch, Upload
1528 - Added TypeScript typings
1529 - All existing icons are redesigned. Some new icons are added
1530 - Added a series of breakpoint-based utility classes that hide elements when the viewport size meets certain conditions
1531 - Added layout components: Container, Header, Aside, Main, Footer
1532 - 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.
1533- Button
1534 - Added `round` attribute. It's used for round-cornered Buttons #6643
1535- TimeSelect
1536 - Now can be navigated by `Up` and `Down`, and hitting `Enter` selects the time #6023
1537- TimePicker
1538 - Now can be navigated by arrow keys, and hitting `Enter` selects the time #6050
1539 - Added `start-placeholder` and `end-placeholder`. They're placeholders for the two input boxes in range mode #7169
1540 - Added `arrow-control` attribute to spin the time with arrows #7438
1541- Tree
1542 - Now child nodes don't render before the first expand #6257
1543 - Added `check-descendants` attribute. It determines if child nodes are checked when checking their parent node in `lazy` mode #6235
1544- Tag
1545 - Added `size` attribute #7203
1546- Datepicker
1547 - Now `timeFormat` can format the TimePicker when type is set to `datetimerange` #6052
1548 - Added `start-placeholder` and `end-placeholder`. They're placeholders for the two input boxes in range mode #7169
1549 - Added `value-format` attribute to customize the format of the binding value, #7367
1550 - Added `unlink-panels` attribute to unlink the two date panels when selecting a date range
1551- MessageBox
1552 - Added `closeOnHashChange` attribute #6043
1553 - Added `center` attribute so that the content can be centered #7029
1554 - Added `roundButton` attribute to display round Buttons #7029
1555 - Added `dangerouslyUseHTMLString` attribute. When set to `true`, `message` will be parsed as HTML string<sup>*</sup> #6043
1556 - Added `inputType` attribute to assign type for the inner input box, #7651
1557- Dialog
1558 - Added `width``fullscreen``append-to-body` attributes. Now Dialog can be nested
1559 - Added `center` attribute so that the content can be centered #7042
1560 - Added `focus-after-closed``focus-after-open` to improve accessibility #6511
1561- ColorPicker
1562 - Now you can type colors in the input box #6167
1563 - Added `size` and `disabled` attributes #7026
1564 - Added `popper-class` attribute #7351
1565- Message
1566 - Now color of the icons can be overridden by CSS #6207
1567 - Added `dangerouslyUseHTMLString` attribute. When set to `true`, `message` will be parsed as HTML string<sup>*</sup> #6207
1568 - Added `center` attribute so that the content can be centered #6875
1569- Notification
1570 - Added `position` attribute to configure where Notification pops up #6231
1571 - Added `dangerouslyUseHTMLString` attribute. When set to `true`, `message` will be parsed as HTML string<sup>*</sup> #6231
1572 - Added `showClose` attribute to hide the close button #6402
1573- Rate
1574 - Added `show-score` attribute to determine if current score is displayed #6295
1575- Tabs
1576 - Added `tab-position` attribute #6096
1577- Radio
1578 - Added `border` and `size` attributes #6690
1579- Checkbox
1580 - Added `border` and `size` attributes #6690
1581- Alert
1582 - Added `center` attribute so that the content can be centered #6876
1583- Menu
1584 - Added `background-color`, `text-color` and `active-text-color` attributes #7064
1585 - Added `open` and `close` methods to open and close SubMenu programmatically, #7412
1586- Form
1587 - Added `inline-message` attribute to determine if the validation message is displayed in inline style #7032
1588 - Added `status-icon` attribute to display a feedback icon when validated #7032
1589 - Form and FormItem now have a `size` attribute. Inner components will inherit this size if not specified on themselves, #7428
1590 - `validate` method will now return a promise if the callback is omitted, #7405
1591 - Added `clearValidate` method for clearing validating results for all form items, #7623
1592- Input
1593 - Added `suffix` and `prefix` named slots, `suffixIcon` and `prefixIcon` attributes to add contents inside the input box #7032
1594- Breadcrumb
1595 - Added `separator-class` attribute to support icons as item separators #7203
1596- Steps
1597 - Added `simple` attribute to activate simple-styled Steps #7274
1598- Pagination
1599 - Added `prev-text` and `next-text` attributes to customize texts of previous page and next page #7005
1600- Loading
1601 - Now you can customize spinner icon and background color with `spinner` and `background` prop, #7390
1602- Autocomplete
1603 - Added `debounce` attribute, #7413
1604- Upload
1605 - Added `limit` and `on-exceed` attributes to limit the amount of files, #7405
1606- DateTimePicker
1607 - Added `time-arrow-control` attribute to activate `arrow-control` of the nesting TimePicker, #7438
1608- Layout
1609 - Added a new breakpoint `xl` for viewport wider than 1920px
1610- Table
1611 - Added `span-method` attribute for merging cells
1612 - Added `clearSort` method to clear sorting programmatically
1613 - Added `clearFilter` method to clear filter programmatically
1614 - 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
1615 - Added `size` attribute
1616 - Added `toggleRowExpansion` method to expand or collapse expandable rows programmatically
1617 - Added `cell-class-name` attribute to assign class name for cells
1618 - Added `cell-style` attribute to style cells
1619 - Added `header-row-class-name` attribute to assign class name for header rows
1620 - Added `header-row-style` attribute to style header rows
1621 - Added `header-cell-class-name` attribute to assign class name for header cells
1622 - Added `header-cell-style` attribute to style header cells
1623 - TableColumn's `prop` attribute now accepts `object[key]` notations
1624 - Added `index` attribute for TableColumn to customize row indices
1625- Select
1626 - Added `reserve-keyword` attribute for reserving current search keyword after selecting an option
1627
1628#### Bug fixes
1629- DatePicker
1630 - Fixed `v-model` returning the second day of the selected week in week mode #6038
1631 - Fixed the first input being cleared in `daterange` type #6021
1632- DateTimePicker
1633 - Fixed DateTimePicker and TimePicker affecting each other when picked #6090
1634 - Fixed hour and second can be beyond limit when selecting time #6076
1635- TimePicker
1636 - Fixed `v-model` not update correctly when blurred #6023
1637- Dialog
1638 - Fixed texts having blurry edges when opening and closing nesting dropdowns #6088
1639- Select
1640 - Improved performance. Now Vue dev-tool won't crash when a large number of Selects are destroyed #6151
1641- Table
1642 - Fixed a bug that Table remains hiding when its parent element appears from `display: none`
1643 - Fixed Table expanding its width when its parent element has `display: flex`
1644 - Fixed a bug that fixed columns of a Table with `append` slot would disappear when data is dynamically fetched
1645 - Fixed `expand-row-keys` attribute not working with initial value
1646 - Fixed filter failing when `data` updates
1647 - Fixed a calculation error of fixed columns layout with grouped headers
1648 - Fixed a dynamic `max-height` bug
1649 - Fixed some style calculation errors
1650
1651#### Breaking changes
1652- General
1653 - Removed `theme-default`
1654 - Compatible with Vue 2.5.2+ and IE 10+
1655 - `change` event of form components and `current-change` event of Pagination now only trigger on user interaction
1656 - `size` attribute of Button and form components now accept `medium`, `small` and `mini`
1657 - 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
1658- Dialog
1659 - Removed `size` attribute. Now the size of Dialog can be configured by `width` and `fullscreen`
1660 - Now the visibility of Dialog cannot be controlled by `v-model`
1661- Rate
1662 - `text-template` is renamed to `score-template`
1663- Dropdown
1664 - `menu-align` is renamed to `placement`. Now it supports more positions
1665- Transfer
1666 - `footer-format` is renamed to `format`
1667- Switch
1668 - Attributes starting with `on-*` will be parsed to events in JSX, making all `on-*` attributes of Switch not
1669 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`
1670 - `active-text` and `inactive-text` attributes now don't have default values
1671- Tag
1672 - `type` attribute now accepts `success`, `info`, `warning` and `danger`
1673- Menu
1674 - Removed `theme` attribute. The color of Menu can be configured using `background-color`, `text-color` and `active-text-color`
1675- Input
1676 - Removed `icon` attribute. Now the suffix icon can be configured using `suffix-icon` attribute or `suffix` named slot
1677 - Removed `on-icon-click` attribute and `click` event. Now to add click handler on icons, please use named slots
1678 - `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.
1679- Autocomplete
1680 - Removed `custom-item` attribute. Now the template of input suggestions can be customized using `scoped slot`
1681 - Removed `props` attribute. Now you can use `value-key` attribute to designate key name of the input suggestion object for display
1682- Steps
1683 - Removed `center` attribute
1684 - Now the Steps will fill its parent container by default
1685- DatePicker
1686 - The params of DatePicker's `change` event is now the binding value itself. Its format is controlled by `value-format`
1687- Table
1688 - Removed support for customizing column template using `inline-template`
1689 - `sort-method` now aligns with `Array.sort`. It should return a number instead of a boolean
1690 - `append` slot is moved outside the `tbody` element to avoid multiple rendering
1691 - `expand` event is renamed to `expand-change`
1692 - The params of `row-class-name` and `row-style` method is now an object
1693
1694##
1695<i><sup>*</sup> Dynamically rendering arbitrary HTML on your website can be very dangerous because it can easily lead to [XSS attacks](https://en.wikipedia.org/wiki/Cross-site_scripting). So when `dangerouslyUseHTMLString` is on, please make sure the content of `message` is trusted, and **never** assign `message` to user-provided content.</i>