Merge pull request #302 from leezng/dev

release

Author: leezng

README.md

@@ -119,7 +119,8 @@ plugins: [
 | showDoubleQuotes         | Show doublequotes on key                                                                                                | boolean                                        | true    |
 | virtual                  | Use virtual scroll                                                                                                      | boolean                                        | false   |
 | height                   | The height of list when using virtual                                                                                   | number                                         | 400     |
-| itemHeight               | The height of node when using virtual                                                                                   | number                                         | 20      |
+| itemHeight               | Fixed row height when using virtual (Estimated row height used before measurement when `dynamicHeight` is true)         | number                                         | 20      |
+| dynamicHeight            | Enable dynamic row heights (measured per row)                                                                           | boolean                                        | true    |
 | selectedValue(v-model)   | Selected data path                                                                                                      | string, array                                  | -       |
 | rootPath                 | Root data path                                                                                                          | string                                         | `root`  |
 | nodeSelectable           | Defines whether a node supports selection                                                                               | (node) => boolean                              | -       |
@@ -147,10 +148,10 @@ plugins: [
 
 ## Slots
 
-| Slot Name         | Description         | Parameters                                     |
+| Slot Name         | Description         | Parameters                                     |       |
 | ----------------- | ------------------- | ---------------------------------------------- | ----- |
-| renderNodeKey     | render node key     | { node, defaultKey }                           |
-| renderNodeValue   | render node value   | { node, defaultValue }                         |
+| renderNodeKey     | render node key     | { node, defaultKey }                           |       |
+| renderNodeValue   | render node value   | { node, defaultValue }                         |       |
 | renderNodeActions | render node actions | boolean \| ({ node, defaultActions }) => vNode | false |
 
 ## Contributors

README.zh_CN.md

@@ -23,7 +23,8 @@
 | showDoubleQuotes         | 展示 key 名的双引号                             | boolean                                        | true          |
 | virtual                  | 使用虚拟滚动(大数据量)                          | boolean                                        | false         |
 | height                   | 使用虚拟滚动时，定义总高度                      | number                                         | 400           |
-| itemHeight               | 使用虚拟滚动时，定义节点高度                    | number                                         | 20            |
+| itemHeight               | 使用虚拟滚动时，定义节点高度(可为预估值)        | number                                         | 20            |
+| dynamicHeight            | 使用虚拟滚动时，开启每一行可为动态高度          | boolean                                        | true          |
 | selectedValue(v-model)   | 双向绑定选中的数据路径                          | string, array                                  | string, array |
 | rootPath                 | 定义最顶层数据路径                              | string                                         | `root`        |
 | nodeSelectable           | 定义哪些数据节点可以被选择                      | function(node)                                 | -             |

example/VirtualList.vue

@@ -10,6 +10,10 @@
           <label>itemHeight</label>
           <input v-model="state.itemHeight" type="number" />
         </div>
+        <div>
+          <label>dynamicHeight</label>
+          <input v-model="state.dynamicHeight" type="checkbox" />
+        </div>
         <div>
           <label>showLine</label>
           <input v-model="state.showLine" type="checkbox" />
@@ -49,6 +53,8 @@
         :collapsed-node-length="state.collapsedNodeLength"
         :virtual="true"
         :item-height="+state.itemHeight"
+        :dynamic-height="state.dynamicHeight"
+        :estimated-item-height="+state.estimatedItemHeight"
         :data="state.data"
         :deep="state.deep"
         :show-line="state.showLine"
@@ -74,7 +80,7 @@ const defaultData = {
 for (let i = 0; i < 10000; i++) {
   defaultData.data.push({
     news_id: i,
-    title: 'iPhone X Review: Innovative future with real black technology',
+    title: `Contrary to popular belief, Lorem Ipsum is not simply random text. It has roots in a piece of classical Latin literature from 45 BC, making it over 2000 years old. Richard McClintock, a Latin professor at Hampden-Sydney College in Virginia, looked up one of the more obscure Latin words, consectetur, from a Lorem Ipsum passage, and going through the cites of the word in classical literature, discovered the undoubtable source. Lorem Ipsum comes from sections 1.10.32 and 1.10.33 of "de Finibus Bonorum et Malorum" (The Extremes of Good and Evil) by Cicero, written in 45 BC. This book is a treatise on the theory of ethics, very popular during the Renaissance. The first line of Lorem Ipsum, "Lorem ipsum dolor sit amet..", comes from a line in section 1.10.32.`,
     source: 'Netease phone',
   });
 }
@@ -93,6 +99,7 @@ export default defineComponent({
       deep: 3,
       collapsedNodeLength: Infinity,
       itemHeight: 20,
+      dynamicHeight: true,
     });
 
     const { localDarkMode, toggleLocalDarkMode, globalDarkModeState } = useDarkMode();

example/styles.less

@@ -82,15 +82,16 @@ body {
 
 .example-box {
   display: flex;
+  gap: 60px;
 
   .title {
     text-align: center;
   }
 
   .block {
-    width: 50%;
+    flex: auto;
     &:first-child {
-      padding-right: 30px;
+      flex: 0 0 450px;
     }
   }