CHANGELOG.en-US.md
2026-04-10
is-range (#23878 by @IceMooncake)2026-03-20
step to be set to "mark" (#23685 by @zhixiaotong)password-icon slot (#23772 by @zhixiaotong)options (#23838 by @keeplearning66)2026-03-07
2026-03-06
save-on-blur prop (#23531 by @snowbitx)2026-02-28
dashed prop (#22738 by @lxKylin)name prop (#23633 by @snowbitx)tag-tooltip config object prop (#23556 by @LostElkByte)setPropsDefaults method (#23612 by @rzzf)requireNodeKey arg in updateKeyChildren (#23676 by @E66Crisp)FormRules (#23668 by @Dsaquel)2026-01-30
supply-validator-plugin plugin (#23458 by @btea)DrawerInstance (#23544 by @snowbitx)webkitdirectory="false" being preserved during hydration (#23374 by @rzzf)is-disabled class to disabled buttons when using unlink-panels (#23393 by @tjyuanpeng)visible-change during the first search (#23507 by @keeplearning66)offset prop (#23526 by @snowbitx)2026-01-09
clearable prop and clear event (#22999 by @keeplearning66)controller-type and formatter props (#23045 by @keeplearning66)confirmButtonType and cancelButtonType props (#23193 by @keeplearning66)directory prop (#23265 by @rzzf)setInitialValues and setInitialValue function (#23013 by @lw56777)icon slot (#23300 by @ZacharyBear)mode prop (#22929 by @keeplearning66)showOverflowTooltip overwrite (#23215 by @zhixiaotong)closing state (#23249 by @rzzf)current-change event exposes the old row object (#23237 by @cassie-ye)2025-12-19
disabled props (#23022 by @jeff-fe)disabled state should the same as component (#23029 by @jeff-fe)uno.css imported multiple times (#23106 by @btea)el$ exists (#23137 by @xjh22222228)2025-12-05
2025-11-28
splitterPanelRef (#22791 by @keeplearning66)remote-show-suffix prop (#22885 by @alonely-boy)reverse prop (#22931 by @rzzf)is-hovering to disabled option (#22845 by @Putia3)2025-11-15
focus and blur methods (#22737 by @rzzf)resize-start resize resize-end emits (#22784 by @jevin98)name attribute (#22718 by @rzzf)useLockscreen for scroll lock (#22734 by @rzzf)event parameter avoid conflicts (#22790 by @btea)2025-11-01
2025-10-31
modal-penetrable prop (#22498 by @Lensiq)tabindex prop (#22624 by @btea)collapseNode/expandNode expand/collapse icon status error (#22205 by @jevin98)2025-10-17
fontGap prop (#22342 by @suqingyao)lazyLoad support reject (#22283 by @btea)modelModifiers prop (#22415 by @cszhjh)word-limit-position attributes (#22359 by @FrontEndDog)2025-09-26
automatic-dropdown prop (#21764 by @btea)loopNavigation attributes (#22281 by @cszhjh)context param (#22262 by @cszhjh)setText to accept VNode type (#22264 by @cszhjh)visibleChange not triggered on Popper hide (#22206 by @cszhjh)enter open tooltip (#19830 by @warmthsea)tooltip-v2 visual-hidden components (#22252 by @warmthsea)2025-09-19
virtual-ref / virtual-triggering / show-arrow props (#22056 by @cszhjh)treeRef & selectRef instances (#22147 by @Dsaquel)initial-scale prop (#22071 by @catanswer)error slot (#21961 by @zzjiaxiang)datetime type debacle (#22033 by @warmthsea)showAfter not needed (#22028 by @cszhjh)maxCollapseTags (#22087 by @btea)resize-end event sizes value is not the latest (#22125 by @Bigpawn)valueOnClear (#22059 by @micaiguai)closable prop of tab-pane (#22187 by @cszhjh)any type (#22127 by @cszhjh)2025-09-05
close-on-press-escape prop (#21981 by @thinkasany)focus-on-target prop (#21905 by @tolking)LoadingInstance (#22027 by @jevin98)autosize in Splitter (#21840 by @cszhjh)LEFT member in Alignment (#22010 by @Dsaquel)2025-08-23
2025-08-22
options (#21692 by @cszhjh)lazy prop (#21730 by @cszhjh)resizable prop (#21608 by @cszhjh)date-picker core component (#21331 by @Dsaquel)placement option & method (#21747 by @zhixiaotong)collapse-* prop (#21477 by @eighty-cents)color-picker core component (#21668 by @Dsaquel)activeIndex is inaccurate (#21736 by @jevin98)collapsible does not take effect dynamically (#21742 by @thinkasany)work-break to CONTEXT_STYLE (#21809 by @Dsaquel)show-overflow-tooltip dynamic (#21823 by @Dsaquel)tagTooltipRef as array (#21826 by @Dsaquel)TreeV2Instance & optimize type usage (#21718 by @zhixiaotong)2025-08-12
dialog config (#21684 by @zhixiaotong)2025-08-08
header/footer slot (#21617 by @btea)layout should be reactive (#21607 by @cszhjh)2025-08-01
persistent and append-to prop (#21393 by @btea)disabled-scientific prop (#21319 by @snowbitx)checkOnClickNode and prefix prop (#21089 by @snowbitx)distance prop (#21261 by @btea)transition prop (#21479 by @zhixiaotong)show-checked-strategy prop (#16922 by @nigiwen)effect prop (#21507 by @cszhjh)show-footer propcard config (#21483 by @Dsaquel)modal-penetrable prop (#21511 by @cszhjh)check-on-click-leaf attribute (#21508 by @Dsaquel)cacheCollapsedSize is set (#21259 by @cszhjh)update:model-value when two dates reacheddefaultCheckedKeys trigger rerender (#21503 by @SpanManX)up/down keys stop working after expanding nodes (#21526 by @SpanManX)getOrderedChildren hook (#21450 by @thinkasany)scrollIntoViewOptions type (#21552 by @cszhjh)MessageType replace messageType (#21579 by @thinkasany)2025-07-11
whole-remove event (#21050 by @56jun)scrollbar-always-on attribute (#21293 by @Dsaquel)2025-07-04
expanded and responds to UI (#21066 by @zhixiaotong)@ts-nocheck and optimize code (#20014 by @zzjiaxiang)@ts-nocheck (#21139 by @Dsaquel)@ts-nocheck (#21197 by @Dsaquel)@ts-nocheck (#21200 by @Dsaquel)2025-06-13
2025-06-07
2025-06-06
end-reached event (#20812 by @Dsaquel)expand slot (#20750 by @wjp980108)default-first-option and allow-create are not effective together (#20872 by @kooriookami)0 or "" (#20905 by @YiMo1)index attribute required (#19007 by @DDDDD12138)manuallyRenderSlots execute (#20854 by @jeff-fe)ts-nocheck comments (#16928 by @warmthsea)2025-05-23
link config (#20773 by @Dsaquel)default-expand-all invalid (#20715 by @btea)expand-row-keys invalid (#20811 by @warmthsea)keep-alive position top error (#20813 by @warmthsea)scrollToError scroll to correct position (#20826 by @btea)2025-05-09
tabNavRef and tabListRef (#20552 by @xinconan)title slot with isActive property (#20613 by @w2xi)append-to prop (#20596 by @warmthsea)show-progress prop available (#20590 by @w2xi)fields reactive (#20567 by @w2xi)2025-04-27
append-to prop (#20472 by @betavs)endReached to fail to trigger (#17065 by @YancyZhang30)onEndReached executes multiple times (#20517 by @warmthsea)append-to prop type across multiple components (#20501 by @betavs)2025-04-18
handleClose (#20323 by @btea)progress slot higher priority (#20353 by @btea)suffix-icon prop with default ArrowDown (#20370 by @cn-xufei)header-class and footer-class for slots (#20408 by @Dsaquel)closeIcon option with default Close (#20402 by @cn-xufei)message overflow container (#20347 by @zzjiaxiang)scrollbarEmits path error (#20415 by @btea)2025-03-21
icon slot (#20034 by @xinconan)setActiveItem in slot (#20190 by @warmthsea)saveOnBlur prop (#20158 by @QFifteen)default-first-option to fail (#19806 by @noki-maker)ElMessageBoxOptions type missing modalClass (#20135 by @a3660980)showOverflowTooltip and align='center' styles (#20157 by @webvs2):model-value without changes (#20149 by @stillgg)2025-03-07
check-on-click-leaf attribute (#19494 by @Dsaquel)@change event value formatter (#20000 by @qq1037305420)button-props as a Partial type (#20035 by @Dsaquel)2025-02-21
persistent prop (#19797 by @zzjiaxiang)persistent prop (#19874 by @zzjiaxiang)persistent prop (#19889 by @zzjiaxiang)script setup writing and optimizing code (#19816 by @zzjiaxiang)2025-02-07
progress slot and show-progress props (#19465 by @zzjiaxiang)prefix slot (#19631 by @DavidKitano)selection column when fixed state changes dynamically (#19703 by @wNing50)lastVisitedColumnIdx if width change (#19757 by @Dsaquel)timePickerRangeTriggerProps (#19487 by @DDDDD12138)2025-01-10
labelWidth is invalid when no border (#19162 by @btea)2025-01-03
fit-input-width prop (#18834 by @YiMo1)sliceIndex calculation error (#19164 by @wen-lun)prefix and suffix (#19042 by @DDDDD12138)$slots instead of useSlots (#19455 by @Dsaquel)2024-12-13
filter-method support third parameter (#19177 by @btea)2024-11-29
props.class prop (#18911 by @zzjiaxiang)empty (#18980 by @zhixiaotong)selectedLabel (#18981 by @zhixiaotong)--font-size-base for default font size (#18725 by @DDDDD12138)2024-11-15
append-to prop (#18798 by @btea)throttle supports values as object (#17041 by @chenweiyi)offset and show-arrow prop (#18837 by @DDDDD12138)flattedChildren traverse component's subTree (#18649 by @ddeerdevil)!global assignments deprecation warning (#18711 by @warmthsea)table-layout:auto fixed column misalignment (#18736 by @btea)2024-11-01
show-now prop (#18625 by @btea)2024-10-18
2024-10-11
selectedLabel (#18350 by @warmthsea)blur in the tooltip slot has no effect (#18335 by @warmthsea)2024-09-27
placement & fallback-placements (#18310 by @btea)updateKeyChildren method & correct version (#17709 by @warmthsea)step-strictly is true and should keep the initial value and step matching (#18277 by @KESHAOYE)wrapRef does not exist (#18311 by @btea)inline-block element (#18293 by @warmthsea)border-radius (#18351 by @warmthsea)2024-09-13
node-drop event (#16935 by @MoConWu)empty slot (#16274 by @btea)2024-09-06
2024-08-23
placement & fallback-placements (#17840 by @btea)global.d.ts file (#17949 by @DDDDD12138)2024-08-09
show-overflow-tooltip (#17629 by @makedopamine)toggleRowSelection (#17687 by @makedopamine)border-card-shaped tab (#17694 by @makedopamine)2024-07-26
type add months params (#17342 by @Panzer-Jack)filter-icon slot (#17272 by @btea)activeIndex (#17650 by @warmthsea)modelValue boolean type validation warning (#17656 by @ToyCat93)2024-07-12
label-position prop (#17111 by @xing403)tag-effect prop (#17445 by @ntnyq)size global adaptation (#17306 by @webvs2)px (#17101 by @warmthsea)2024-06-21
size prop (#16858 by @webvs2)header-click (#17093 by @btea)row-key is a number (#16989 by @Whbbit1999)teleported="false" dropdown closes abnormally (#16714 by @GUEThe)format (#17161 by @dddssw)2024-06-07
is-focus class name when textarea focus (#17049 by @btea)hanging (#17036 by @warmthsea)2024-05-31
async-validator string length calc (#16757 by @btea)2024-05-13
Parameters extraction rules (#16592 by @reiwang01)2024-04-26
teleported prop (#16634 by @zhixiaotong)isDisabled is not fresh (#16419 by @makedopamine)2024-04-20
2024-04-12
2024-03-29
2024-03-22
type default value typo (#16102 by @cullyfung)type type typo (#16119 by @warmthsea)header/footer slot (#16151 by @warmthsea)gulp-clean-css with cssnano (#16056 by @zhixiaotong)node to trigger side effects (#16198 by @makedopamine)2024-03-08
2024-03-01
2024-02-18
2024-02-03
2024-02-02
calcSliceIndex (#15699 by @zhixiaotong)2024-01-22
2024-01-19
2024-01-11
2024-01-10
popper-class、subMenuTimeout props (#15193 by @zhixiaotong)loading slot (#15206 by @zhixiaotong)filterClassName props in TableColumn (#15389 by @xiaoxian521)allowDrop method (#15005 by @CherishTheYouth)fonts.loli.net with original fonts.googleapis.com (#15182 by @plainheart)type prop error in web-types.json (#15376 by @btea)teleported, parent menu popper not closed (#15342 by @xiaoxian521)publish-npm-nightly.yml (#15382 by @xiaoxian521)ButtonInstance and format code (#15304 by @btea)menu-trigger:hover (#15383 by @xiaoxian521)2023-12-15
2023-11-27
2023-11-03
2023-10-18
2023-10-13
minScale and maxScale (#14120 by @IceyWu)label-position type error (#14312 by @btea)element-plus/global (#13698 by @mioxs)withDirectives add custom directive (#14299 by @btea)undefined (#14011 by @btea)2023-09-14
Fix release error. The changelog is the same as 2.3.13.
2023-09-14
calendar-change event parameter type error (#14237 by @btea)calendar-change (#14262 by @Justineo)keypress with keydown (#14137 by @btea)2023-08-26
2023-08-25
2023-08-04
2023-07-14
2023-06-21
2023-06-02
2023-05-19
checkOnClickNode without checkbox (#12826 by @yujinpan)2023-04-23
2023-04-07
show hide expose (#11942 by @xiterjia)2023-03-31
2023-03-19
2023-03-12
2023-03-08
2023-03-07
2023-03-06
2023-03-03
2023-02-19
2023-02-17
2023-02-10
2023-02-03
2022-12-30
enterable and customization (#10984 by @plainheart)2022-12-16
cacheData not reactive (#10885 by @yujinpan)2022-12-02
popper-effect menu attribute (#10867 by @xiaoxian521)2022-11-25
2022-11-25
2022-11-25
2022-11-18
2022-11-11
hide-on-click-modal not work (#10568 by @holazz)2022-11-06
2022-10-21
2022-10-13
withInstallDirective type error (#9946 by @BTBMan)prop property (#9993 by @btea)viewBox default value (#9769 by @tolking)2022-09-16
message option (#9405 by @holazz)el-loading-parent--relative correctly (#9630 by @wiidede)--el-component-size (#9706 by @holazz)shell-emulator instead of cross-env (#9693 by @sxzz)flattedChildren (#9748 by @Tsong-LC)2022-09-02
setActiveItem method (#9389 by @holazz)readonly (#9545 by @holazz)onPreview not work when picture list type (#9448 by @holazz)updateRoot (#9159 by @CodeListener)iconPropType (#9506 by @holazz)$attrs (#9455 by @holazz)td tags with content can be select (#9537 by @btea)menu.value is null (#9566 by @xiaoxian521)expand-on-click-node not work (#8973 by @holazz)iconPropType (#9502 by @holazz)iconPropType (#9515 by @holazz)2022-08-26
setExpendKeys method (#9412 by @holazz)expand-close-icon、expand-open-icon、collapse-close-icon、collapse-open-icon props (#9444 by @xiaoxian521)setExpandedKeys instead of setExpendKeys (#9413 by @holazz)vertical-align (#8800 by @holazz)2022-08-19
2022-08-12
resize-event (#8618 by @holazz)2022-08-01
2022-07-27
clearFilter not work (#8966 by @holazz)2022-07-22
addEventListener (#8784 by @holazz)2022-07-08
2022-07-01
2022-07-01
2022-06-17
column's min-width should work normal (#8226 by @webfansplz)2022-06-08
useResizeObserver (#8124 by @CarterLi)2022-06-05
2022-06-04
2022-05-23
2022-05-20
2022-05-09
type="text" has been removed from button, now you can do this, for more detail see Documentation--- <el-button type="text"/>
+++ <el-button text />
icon support Component. fix [#7517] (#7518 by @JobinJia)2022-04-25
2022-04-18
cell-class-name not work (#7149 by @plainheart)proxy instead of ctx (#7160 by @plainheart)SummaryMethod type (#7206 by @hminghe)2022-04-11
suffix and prefix are displayed (#7001 by @baiwusanyu-c)2022-04-03
2022-03-28
Revert "fix(components): [el-tabs] label slot not update (#6738 by @btea)" (#6871)
2022-03-27
2022-03-25
2022-03-16
2022-03-15
2022-03-14
2022-03-13
2022-03-12
2022-03-11
2022-03-06
persistent in el-select (#6428 by @CarterLi)2022-02-28
isElement (#6292 by @btea)2022-02-25
2022-02-14
defineOptions for script-setup (#5932 by @sxzz)maxHeight support more units (#5904 by @msidolphin)namespace.is default state (#5941 by @sxzz)2022-02-07
2022-02-07
2022-01-31
2022-01-25
2022-01-24
2022-01-22
2022-01-22
2022-01-12
2022-01-11
2022-01-09
value-format="x" emit number timestamp value (#5187 by @CarterLi)2022-01-08
2021-12-31
@vue/compiler-sfc (#4815 by @sxzz)2021-12-10
ConfigProvdierContext to ConfigProviderContext (#4620 by @emojiiii)2021-12-01
2021-11-27
range-separator slot don't work (#4522 by @emojiiii)2021-11-09
2021-11-05
h function children parameter usage (#4238 by @adaex)2021-10-30
2021-10-20
2021-10-20
2021-10-20
2021-10-18
2021-10-11
2021-09-30
2021-09-28
2021-09-27
2021-09-24
2021-09-23
2021-09-22
2021-09-22
2021-09-14
2021-09-13
clearFiles support filter status (#1501 by @gaoyia)throwError (#3301 by @sxzz)2021-09-05
calc (#3181 by @cokemine)$--border-color-hover var reference (#3179 by @adaex)2021-08-31
2021-08-26
2021-08-26
2021-08-25
2021-08-25
2021-08-24
2021-08-24
2021-08-24
key. (#2944 by @callmesoul)2021-08-18
2021-08-05
2021-08-04
2021-08-04
2021-08-04
2021-08-03
2021-07-28
2021-07-27
2021-07-26
2021-07-26
Config Provider (#2679)2021-07-26
dayjs integration issue with el-config-provider and build.sh shell error (#2678)2021-07-26
2021-07-24
2021-07-23
2021-07-23
2021-07-09
2021-07-02
2021-06-25
2021-06-24
2021-06-23
2021-06-11
2021-06-04
2021-05-28
2021-05-11
2021-05-10
2021-05-09
!default modifiers for global variables (#1969)2021-04-26
2021-04-14
2021-04-09
packages/utils path issue (#1792)2021-04-08
packages/utils build issue caused setConfig not working (#1788)2021-04-08
2021-03-28
2021-03-15
2021-03-12
it.only with it in test (#1586)2021-03-03
2021-01-31
importing on demand section in `quickstart.md, to solve the issue which caused importing on demand not working (#1414)2021-01-31
2021-01-25
2021-01-25
2021-01-20
2021-01-15
2021-01-14
Affix (#1210)2021-01-11
2021-01-07
ElEmpty (#1210)2021-01-06
2021-01-05
2021-01-02
2020-12-31
2020-12-27
2020-12-24
2020-12-21
2020-12-18
2020-12-16
native is not true (#971)2020-12-12
2020-12-10
2020-12-09
2020-12-07
2020-12-05
2020-12-03
2020-12-02
2020-12-01
bodyStyle bug (#754)