Updated ChangeLog 2.0.0 (markdown)

ChangeLog-2.0.0.md

@@ -6,26 +6,7 @@
   - 新增 TypeScript 类型声明
   - 重绘了全部图标，并新增了部分图标
   - 新增了一系列基于断点的工具类，用于当视口尺寸满足一定条件时隐藏元素
-  - 新增全局配置组件尺寸的功能
+  - 新增全局配置组件尺寸的功能。在引入 Element 时，配置 `size` 字段可以改变所有组件的默认尺寸
-
-    在引入 Element 时，配置 `size` 字段可以改变所有组件的默认尺寸。按照引入 Element 的方式，具体操作如下：
-    
-    完整引入 Element：
-    ```JS
-    import Vue from 'vue'
-    import Element from 'element-ui'
-    Vue.use(Element, { size: 'small' })
-    ```
-    
-    按需引入 Element：
-    ```JS
-    import Vue from 'vue'
-    import { Button } from 'element-ui'
-
-    Vue.prototype.$ELEMENT = { size: 'small' }
-    Vue.use(Button)
-    ```
-    按照以上设置，项目中所有拥有 `size` 属性的组件的默认尺寸均为 'small'。
 - Button
   - 新增 `round` 属性，用于圆角按钮 #6643
 - TimeSelect
@@ -83,7 +64,7 @@
 - Form
   - 新增 `inline-message` 属性，设置后校验信息会以行内样式显示 #7032
   - 新增 `status-icon` 属性，用于在输入框中显示校验结果反馈图标 #7032
-  - Form 和 Form-item 新增 `size` 属性，用于控制表单内组件的尺寸，#7428
+  - Form 和 FormItem 新增 `size` 属性，用于控制表单内组件的尺寸，#7428
   - `validate` 方法在不传入 callback 的情况下返回 promise，#7405
   - 新增 `clearValidate` 方法，用于清空所有表单项的验证信息，#7623
 - Input
@@ -136,7 +117,6 @@
 - Select
   - 提升性能，修复组件销毁时可能导致 Vue dev-tool 卡死的问题 #6151
 - Table
-  - 修复 TableColumn 的 `header-align` 属性失效的问题
   - 修复 Table 在父元素从 `display: none` 变成其他状态时会隐藏的问题
   - 修复 Table 在父元素为 `display: flex` 时可能出现的宽度逐渐变大的问题
   - 修复 `append` 具名 slot 和固定列并存时，动态获取表格数据会导致固定列消失的问题
@@ -149,7 +129,7 @@
 ## 非兼容性更新
 - 综合
   - 移除 `theme-default`
-  - 最低兼容 Vue 2.5.2 版本
+  - 最低兼容 Vue 2.5.2 和 IE 10
   - 表单组件的 `change` 事件和 Pagination 的 `current-change` 事件现在仅响应用户交互
   - Button 和表单组件的 `size` 属性不再接受 `large` 值，可接受 `medium`、`small` 和 `mini`
   - 为了方便使用第三方图标，Button 的 `icon` 属性、Input 的 `prefix-icon` 和 `suffix-icon` 属性、Steps 的 `icon` 属性现在需要传入完整的图标类名
@@ -179,7 +159,7 @@
 - Steps
   - 移除 `center` 属性
   - 现在步骤条将默认充满父容器
-- DatePicker
+  - DatePicker
   - `change` 事件参数现在为组件的绑定值，格式由 `value-format` 控制
 - Table
   - 移除通过 `inline-template` 自定义列模板的功能
@@ -189,7 +169,7 @@
   - `row-class-name` 和 `row-style` 的函数参数改为对象，以保证 API 的一致性
 
 ##
-<sup>*</sup> 在网站上动态渲染任意 HTML 是非常危险的，因为容易导致 [XSS 攻击](https://en.wikipedia.org/wiki/Cross-site_scripting)。因此请在 `dangerouslyUseHTMLString` 打开的情况下，确保 `message` 的内容是可信的，**永远不要**将用户提交的内容赋值给 `message` 属性。
+<i><sup>*</sup> 在网站上动态渲染任意 HTML 是非常危险的，因为容易导致 [XSS 攻击](https://en.wikipedia.org/wiki/Cross-site_scripting)。因此请在 `dangerouslyUseHTMLString` 打开的情况下，确保 `message` 的内容是可信的，**永远不要**将用户提交的内容赋值给 `message` 属性。</i>
 
 #
 
@@ -200,27 +180,8 @@
   - 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
-  - Layout components: Container, Header, Aside, Main, Footer
+  - Added layout components: Container, Header, Aside, Main, Footer
-  - Configure component sizes globally
+  - 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.
-
-    Now when you import Element, you can add a global config object with a `size` prop to configure default sizes for all components:
-    
-    Fully import:
-    ```JS
-    import Vue from 'vue'
-    import Element from 'element-ui'
-    Vue.use(Element, { size: 'small' })
-    ```
-    
-    Partial import:
-    ```JS
-    import Vue from 'vue'
-    import { Button } from 'element-ui'
-
-    Vue.prototype.$ELEMENT = { size: 'small' }
-    Vue.use(Button)
-    ```
-    With the above config, the default size of all components that have `size` attribute will be 'small'
 - Button
   - Added `round` attribute. It's used for round-cornered Buttons #6643
 - TimeSelect
@@ -231,14 +192,14 @@
   - 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
+  - Added `check-descendants` attribute. It determines if child nodes are checked when checking their parent node in `lazy` mode #6235
- 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
@@ -252,6 +213,7 @@
 - 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<sup>*</sup> #6207
@@ -265,7 +227,6 @@
 - Tabs
   - Added `tab-position` attribute #6096
 - Radio
-  - Improved accessibility #6101
   - Added `border` and `size` attributes #6690
 - Checkbox
   - Added `border` and `size` attributes #6690
@@ -277,7 +238,7 @@
 - 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 Form-item now have a `size` attribute. Inner components will inherit this size if not specified on themselves, #7428
+  - 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
@@ -296,14 +257,13 @@
   - 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
-  - Added `unlink-panels` attribute to unlink the two date panels when selecting a date range
 - 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 styles
+  - 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
@@ -330,10 +290,7 @@
   - 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
-- ColorPicker
-  - Added `popper-class` attribute for ColorPicker, #7351
 - Table
-  - Now `header-align` of TableColumn works properly
   - 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
@@ -346,9 +303,9 @@
 ## Breaking changes
 - General
   - Removed `theme-default`
-  - Only compatible with Vue 2.5.2 and beyond
+  - 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 can no longer be set to `large`. Now they accept `medium`, `small` and `mini`
+  - `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`
@@ -361,7 +318,7 @@
   - `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`
+  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`
@@ -373,8 +330,7 @@
   - `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
+  - Removed `props` attribute. Now you can use `value-key` attribute to designate key name of the input suggestion object for display
- object for display
 - Steps
   - Removed `center` attribute
   - Now the Steps will fill its parent container by default
@@ -388,4 +344,4 @@
   - The params of `row-class-name` and `row-style` method is now an object
 
 ##
-<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><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>