w-component-vue 2.4.65 → 2.4.66

package/docs/module-WTimeday.html

@@ -597,7 +597,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTimedayCore.html

@@ -381,7 +381,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTimedayRange.html

@@ -633,7 +633,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTimedayRangeCore.html

@@ -417,7 +417,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTimeminute.html

@@ -693,7 +693,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTimeminuteCore.html

@@ -477,7 +477,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTimeminuteRange.html

@@ -741,7 +741,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTimeminuteRangeCore.html

@@ -525,7 +525,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTinymceVueDyn.html

@@ -285,7 +285,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTooltip.html

@@ -501,7 +501,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTree.html

@@ -1557,7 +1557,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTreeIconCheckbox.html

@@ -333,7 +333,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTreeIconToggle.html

@@ -309,7 +309,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WVditorDyn.html

@@ -357,7 +357,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Jun 20 2026 22:48:48 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Jun 22 2026 10:34:44 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "w-component-vue",
-  "version": "2.4.65",
+  "version": "2.4.66",
   "main": "dist/w-component-vue.umd.js",
   "dependencies": {
     "@mdi/js": "^7.4.47",

package/src/AppZoneWExplorer.vue

@@ -803,12 +803,12 @@
                 ></demolink>
 
                 <div>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'show(rows[0])'" :borderRadius="4" @click="toggletreefoldersbyfun(0, true)"></w-button-chip>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'hide(rows[0])'" :borderRadius="4" @click="toggletreefoldersbyfun(0, false)"></w-button-chip>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'show(rows[1])'" :borderRadius="4" @click="toggletreefoldersbyfun(1, true)"></w-button-chip>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'hide(rows[1])'" :borderRadius="4" @click="toggletreefoldersbyfun(1, false)"></w-button-chip>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'show(rows[2])'" :borderRadius="4" @click="toggletreefoldersbyfun(2, true)"></w-button-chip>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'hide(rows[2])'" :borderRadius="4" @click="toggletreefoldersbyfun(2, false)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'show(rows[0])'" :borderRadius="4" @click="toggleTreeFoldersByFun(0, true)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'hide(rows[0])'" :borderRadius="4" @click="toggleTreeFoldersByFun(0, false)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'show(rows[1])'" :borderRadius="4" @click="toggleTreeFoldersByFun(1, true)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'hide(rows[1])'" :borderRadius="4" @click="toggleTreeFoldersByFun(1, false)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'show(rows[2])'" :borderRadius="4" @click="toggleTreeFoldersByFun(2, true)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'hide(rows[2])'" :borderRadius="4" @click="toggleTreeFoldersByFun(2, false)"></w-button-chip>
                 </div>
 
                 <w-explorer
@@ -828,10 +828,10 @@
                 ></demolink>
 
                 <div>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'display all'" :borderRadius="4" @click="toggletreefoldersall(true)"></w-button-chip>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'hide all'" :borderRadius="4" @click="toggletreefoldersall(false)"></w-button-chip>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'display to level1'" :borderRadius="4" @click="toggletreefoldersall(null,1)"></w-button-chip>
-                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'display to level2'" :borderRadius="4" @click="toggletreefoldersall(null,2)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'display all'" :borderRadius="4" @click="toggleTreeFoldersAll(true)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'hide all'" :borderRadius="4" @click="toggleTreeFoldersAll(false)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'display to level1'" :borderRadius="4" @click="toggleTreeFoldersAll(null,1)"></w-button-chip>
+                    <w-button-chip style="margin:0px 15px 5px 0px;" :text="'display to level2'" :borderRadius="4" @click="toggleTreeFoldersAll(null,2)"></w-button-chip>
                 </div>
 
                 <w-explorer

package/src/components/WDynamicList.vue

@@ -73,6 +73,7 @@ import cint from 'wsemi/src/cint.mjs'
 import genID from 'wsemi/src/genID.mjs'
 import delay from 'wsemi/src/delay.mjs'
 import isarr from 'wsemi/src/isarr.mjs'
+import isearr from 'wsemi/src/isearr.mjs'
 import isstr from 'wsemi/src/isstr.mjs'
 import isnum from 'wsemi/src/isnum.mjs'
 import iseobj from 'wsemi/src/iseobj.mjs'
@@ -181,13 +182,15 @@ export default {
             disableLoadingText: false, //禁止顯示載入中文字, 小數據時自動使用
             searchingResults: -1, //過濾結果, -1初始無狀態, 0過濾無結果, >0有結果
 
-            // scrollRatio: 0, //捲動比例
             scrollTop: 0, //捲動值
-            // scrollTopTemp: 0, //上次捲動值
             scrollInfor: null, //目前捲軸資訊
 
+            lockedAnchorIdx: null, //鎖定的窗口頂A index(拖bar往下時鎖定), 使indStart固定不往上漂, 避免上方項目被拉進渲染往下擠
+
             filterKeywordsTemp: '', //上次過濾關鍵字
 
+            rowsTemp: null, //setRowsCore被lockFromProcess擋住時暫存待重套之rows(修鎖丟rows致空樹bug, latest-wins單槽)
+
             itemsHeight: 0, //全部節點高度
             // itemsHeightTemp: 0, //上次全部節點高度
             itemsHeightPre: 0,
@@ -195,9 +198,6 @@ export default {
             useItems: [], //實際需顯示節點陣列
             emItemsTemp: [], //實際需顯示節點之指標陣列
 
-            // iNochangeScrollInfor: 0, //觸發changeScrollInfor時但所到scrollInfor為同值之次數
-            // tNochangeScrollInfor: 0, //增加scrollInfor同值次數時之時間
-
         }
     },
     mounted: function() {
@@ -219,6 +219,9 @@ export default {
             gm.remove(vo.mmkey)
         }
 
+        //清除rowsTemp, 因processItems是async, 其finally亦會於beforeDestroy之後才觸發, 故於beforeDestroy得先清避免finally拿去使用
+        vo.rowsTemp = null
+
     },
     watch: {
 
@@ -286,24 +289,29 @@ export default {
 
             let vo = this
 
-            //check
+            //check, 上鎖中須暫存最新給予之rows, 待processItems解鎖後給予
             if (vo.lockFromProcess) {
-                let msg = 'disabling call when lockFromProcess'
-                //console.log(msg)
+                vo.rowsTemp = rows
+                let msg = 'deferred'
                 return msg
             }
-            // if (vo.lockFromSetRows) { //setRows內需呼叫setRowsCore故不能上鎖
+
+            // //check, setRows內需呼叫setRowsCore故不能上鎖
+            // if (vo.lockFromSetRows) {
             //     let msg = 'disabling call when lockFromSetRows'
             //     //console.log(msg)
             //     return msg
             // }
-            // if (vo.lockFromRefreshUseItems) { //更新時可能會切換組件並塞入數據故不能上鎖
+
+            // //check, 更新時可能會切換組件並塞入數據故不能上鎖
+            // if (vo.lockFromRefreshUseItems) {
             //     console.log('return by lockFromRefreshUseItems')
             //     return
             // }
 
             //check
             if (!isarr(rows)) {
+                vo.rowsTemp = null //無效rows故須清除rowsTemp, 避免再被使用
                 let msg = 'rows is not array'
                 //console.log(msg)
                 return msg
@@ -314,6 +322,9 @@ export default {
             //     return msg
             // }
 
+            //清除rowsTemp, 此批rows正常落地, 清暫存(避免殘留被重複重套)
+            vo.rowsTemp = null
+
             //mmkey, 產生mmkey要放在資料變更的地方, 否則須放在beforeMount, 且於vue-cli編譯情況下會有部份情境有問題
             if (vo.mmkey !== null) {
 
@@ -342,6 +353,9 @@ export default {
             //changeDisplay, 若由外部強制變更rows或呼叫setRows變更rows, 則需重設changeDisplay使能重算全部節點高度
             vo.changeDisplay = true
 
+            //換新數據時清除鎖定的A index, 因index會對應到舊資料導致錯位
+            vo.lockedAnchorIdx = null
+
         },
 
         setRows: async function(rows) {
@@ -420,9 +434,13 @@ export default {
                 if (indStartActual === null) {
                     indStartActual = 0
                 }
-                // let indStart = Math.max(indStartActual - vo.itemsPreload, 0)
                 let indStart = Math.max(indStartActual - 1, 0) //只先預載上方1個
 
+                //拖bar往下時鎖定窗口頂A, indStart固定為A(不-1不隨y重算往上漂), 使A之上不渲染不測高, 避免上方項目被拉進渲染往下擠
+                if (vo.lockedAnchorIdx !== null) {
+                    indStart = Math.min(Math.max(vo.lockedAnchorIdx, 0), n - 1)
+                }
+
                 //indEnd, 該元素區(頂部)有侵入顯示區
                 let indEndActual = binarySearch(items, (ind) => {
                     let v = items[ind]
@@ -889,6 +907,30 @@ export default {
                 vo.scrollInfor = msg
                 // console.log('changeInfor scrollInfor', cloneDeep(msg))
 
+                //鎖定/清除窗口頂A index
+                let from = get(msg, 'evMsg.from', '')
+                if (msg.evName === 'scroll' && from === 'bar') {
+                    let items = gm.get(vo.mmkey)
+                    if (isearr(items)) {
+                        let indStartActual = binarySearch(items, (ind) => {
+                            let v = items[ind]
+                            let dy = vo.scrollInfor.t - (v.y + v.height)
+                            return dy
+                        })
+                        if (indStartActual === null) {
+                            indStartActual = 0
+                        }
+                        vo.lockedAnchorIdx = Math.max(indStartActual, 0)
+                    }
+                }
+                else if (from === 'wdl-refreshCore') {
+                    //settling自激(內容測真高後的重刷), 保持lockedAnchorIdx不變, 使indStart固定不往上漂
+                }
+                else {
+                    //其他操作(wheel捲shell/往上拖/內容mutation/processItems等), 清除鎖定退回原本行為
+                    vo.lockedAnchorIdx = null
+                }
+
                 //refresh
                 vo.refresh('changeInfor')
 
@@ -1003,6 +1045,13 @@ export default {
                     //unluck
                     vo.lockFromProcess = false
 
+                    //setRows於上鎖時段內最新一次被給的rows
+                    if (isarr(vo.rowsTemp)) {
+                        let r = vo.rowsTemp
+                        vo.rowsTemp = null
+                        vo.setRows(r)
+                    }
+
                 })
 
         },

package/src/components/WPanelScrollyCore.vue

@@ -66,9 +66,9 @@
 </template>
 
 <script>
-import get from 'lodash-es/get.js'
-import isEqual from 'lodash-es/isEqual.js'
-// import cloneDeep from 'lodash-es/cloneDeep.js'
+import get from 'lodash-es/get.js'
+import isEqual from 'lodash-es/isEqual.js'
+// import cloneDeep from 'lodash-es/cloneDeep.js'
 import waitFun from 'wsemi/src/waitFun.mjs'
 import debounce from 'wsemi/src/debounce.mjs'
 import domResize from '../js/domResize.mjs'

package/src/components/WTree.vue

@@ -1376,7 +1376,7 @@ export default {
                 //wait wdl, 組件初始化時會先觸發computed才會有實體元素出現, 故得用waitFun等待
                 await waitFun(() => {
                     return vo.$refs.wdl !== undefined
-                }, { timeInterval: 20 })
+                }, { attemptNum: 10000, timeInterval: 20 })
 
                 //setRows
                 if (vo.$refs.wdl) { //於async中組件切換時還是有可能消失
@@ -1615,7 +1615,7 @@ export default {
                 //wait wdl, 組件初始化時會先觸發computed才會有實體元素出現, 故得用waitFun等待
                 await waitFun(() => {
                     return vo.$refs.wdl !== undefined
-                }, { timeInterval: 20 })
+                }, { attemptNum: 10000, timeInterval: 20 })
 
                 //opt
                 let opt = {
@@ -1686,8 +1686,12 @@ export default {
                 //save
                 vo.selectionsTrans = selectionsTrans
 
-                //emit, 要放在wdl更新後才觸發事件
-                vo.$emit('update:selections', cloneDeep(selectionsTrans))
+                //emit, 要放在wdl更新後才觸發事件; emit前以isEqual守門, 若重產之selectionsTrans已等價於外部傳入selections則不emit, 避免多組件共用同一selections時各棵async完成時序差致輪流emit互相觸發之無限循環
+                if (!isEqual(selectionsTrans, vo.selections)) {
+                    setTimeout(() => {
+                        vo.$emit('update:selections', cloneDeep(selectionsTrans))
+                    }, 20)
+                }
 
             }
 
@@ -2626,8 +2630,12 @@ export default {
                 //save
                 vo.selectionsTrans = selectionsTrans
 
-                //emit, 要放在wdl更新後才觸發事件
-                vo.$emit('update:selections', cloneDeep(selectionsTrans))
+                //emit, 要放在wdl更新後才觸發事件; emit前以isEqual守門, 若重產之selectionsTrans已等價於外部傳入selections則不emit, 避免多組件共用同一selections時各棵async完成時序差致輪流emit互相觸發之無限循環
+                if (!isEqual(selectionsTrans, vo.selections)) {
+                    setTimeout(() => {
+                        vo.$emit('update:selections', cloneDeep(selectionsTrans))
+                    }, 20)
+                }
 
             }
 

package/vue.config.js

@@ -12,6 +12,12 @@ module.exports = {
             template: 'tmp/wtree-test/index.html',
             filename: 'wtree-test.html',
         },
+        //dev-only WDL 虛擬捲動探測頁: 單一大數據 WDynamicList, 量 dir/itemsHeightPre/scrollTop 漂移 (之後可移除)
+        'wdl-probe': {
+            entry: 'tmp/wdl-probe/main.js',
+            template: 'tmp/wdl-probe/index.html',
+            filename: 'wdl-probe.html',
+        },
     },
     devServer: {
         proxy: {