w-table-vue 1.0.13 → 1.0.15

package/docs/examples/w-table-edit_opt.kpHead.html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -482,6 +482,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_removeIdsWhenDownload (remove id, mappingId, order, isActive).html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -485,6 +485,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_slot btns-left.html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -506,6 +506,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_slot btns-right.html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -506,6 +506,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_slot cell-render.html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -498,6 +498,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_slot cell-tooltip.html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -498,6 +498,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_slot head-render.html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -498,6 +498,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_slot head-tooltip.html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -504,6 +504,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_slot infor (name_description).html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -499,6 +499,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/examples/w-table-edit_sortColIds (sort by order).html

@@ -43,7 +43,7 @@
     />
 
     <!-- w-table-vue -->
-    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.13/dist/w-table-vue.umd.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/w-table-vue@1.0.15/dist/w-table-vue.umd.js"></script>
 
     <style>
   .item {
@@ -483,6 +483,31 @@
               }
               return rows;
             }
+          },
+          opt8: {
+            keys: keys1,
+            kpHeadFilterType: kpHeadFilterType1,
+            rows: rows1,
+            kpCellFormat: {
+              //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+              make: function(value, key, row, params) {
+                //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return String(value).toUpperCase();
+              },
+              price: function(value, key, row, params) {
+                //空值不可直接Number(), 否則''與null會變成0.00
+                if (value === null || value === undefined || value === "") {
+                  return null;
+                }
+                return Number(value).toLocaleString("en-US", {
+                  minimumFractionDigits: 2,
+                  maximumFractionDigits: 2
+                });
+              }
+            }
           }
         },
         actions: []

package/docs/index.html

@@ -71,7 +71,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Fri Sep 04 2026 23:49:46 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 Sat Sep 05 2026 15:13:53 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/module-WTableEdit.html

@@ -163,11 +163,17 @@
         <td>No</td>
         <td>輸入下載Excel檔案時針對mat數據階段的攔截處理函數，預設為null</td>
     </tr><tr>
-        <td><code>enableHeadWhenDownload</code></td>
+        <td><code>useHeadWhenDownload</code></td>
         <td>Boolean</td>
         <td><code>false</code></td>
         <td>No</td>
         <td>輸入下載Excel檔案時是否將欄位鍵值轉換成head布林值，此需提供opt.kpHead物件，預設為false</td>
+    </tr><tr>
+        <td><code>useCellFormatWhenDownload</code></td>
+        <td>Boolean</td>
+        <td><code>true</code></td>
+        <td>No</td>
+        <td>輸入下載Excel檔案時是否依opt.kpCellFormat格式化各欄值布林值，true時下載內容與畫面一致(有格式化函數之欄為格式化後字串)，false時下載原值，無opt.kpCellFormat時無作用，對應w-aggrid-vue之downloadData與downloadDisplayData之useFormat，預設為true</td>
     </tr><tr>
         <td><code>fileNameWhenDownload</code></td>
         <td>String</td>
@@ -522,6 +528,12 @@
         <td><code>{}</code></td>
         <td>No</td>
         <td>輸入key對應cell之是否可編輯物件，預設各key值為defCellEditable</td>
+    </tr><tr>
+        <td><code>opt.kpCellFormat</code></td>
+        <td>Object</td>
+        <td><code>{}</code></td>
+        <td>No</td>
+        <td>輸入key對應cell之值格式化函數物件，函數簽名為(value, key, row, params)，回傳顯示字串，回傳null或undefined代表不格式化維持原值；所有原值(含null、undefined、空字串)皆原樣傳入，編輯模式新增列之各欄為空字串，故函數內須自行處理空值(如回傳null)；作用於顯示與下載(下載時params為null，可由組件useCellFormatWhenDownload關閉)，排序、過濾、編輯與save回傳之rows仍為原值；與cell-render slot可並用，預設各key值為undefined</td>
     </tr><tr>
         <td><code>opt.kpConvertKeysWhenUploadData</code></td>
         <td>Object</td>
@@ -801,11 +813,17 @@
         <td>No</td>
         <td>輸入下載Excel檔案時針對mat數據階段的攔截處理函數，預設為null</td>
     </tr><tr>
-        <td><code>enableHeadWhenDownload</code></td>
+        <td><code>useHeadWhenDownload</code></td>
         <td>Boolean</td>
         <td><code>false</code></td>
         <td>No</td>
         <td>輸入下載Excel檔案時是否將欄位鍵值轉換成head布林值，此需提供opt.kpHead物件，預設為false</td>
+    </tr><tr>
+        <td><code>useCellFormatWhenDownload</code></td>
+        <td>Boolean</td>
+        <td><code>true</code></td>
+        <td>No</td>
+        <td>輸入下載Excel檔案時是否依opt.kpCellFormat格式化各欄值布林值，true時下載內容與畫面一致(有格式化函數之欄為格式化後字串)，false時下載原值，無opt.kpCellFormat時無作用，對應w-aggrid-vue之downloadData與downloadDisplayData之useFormat，預設為true</td>
     </tr><tr>
         <td><code>fileNameWhenDownload</code></td>
         <td>String</td>
@@ -1160,6 +1178,12 @@
         <td><code>{}</code></td>
         <td>No</td>
         <td>輸入key對應cell之是否可編輯物件，預設各key值為defCellEditable</td>
+    </tr><tr>
+        <td><code>opt.kpCellFormat</code></td>
+        <td>Object</td>
+        <td><code>{}</code></td>
+        <td>No</td>
+        <td>輸入key對應cell之值格式化函數物件，函數簽名為(value, key, row, params)，回傳顯示字串，回傳null或undefined代表不格式化維持原值；所有原值(含null、undefined、空字串)皆原樣傳入，編輯模式新增列之各欄為空字串，故函數內須自行處理空值(如回傳null)；作用於顯示與下載(下載時params為null，可由組件useCellFormatWhenDownload關閉)，排序、過濾、編輯與save回傳之rows仍為原值；與cell-render slot可並用，預設各key值為undefined</td>
     </tr><tr>
         <td><code>opt.kpConvertKeysWhenUploadData</code></td>
         <td>Object</td>
@@ -1425,7 +1449,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Fri Sep 04 2026 23:49:46 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 Sat Sep 05 2026 15:13:53 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "w-table-vue",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "main": "dist/w-table-vue.umd.js",
   "dependencies": {
-    "w-aggrid-vue": "^2.0.82",
-    "w-component-vue": "^2.5.10",
+    "w-aggrid-vue": "^2.0.84",
+    "w-component-vue": "^2.5.11",
     "wsemi": "^1.8.84"
   },
   "devDependencies": {

package/src/AppZoneWTableEdit.vue

@@ -375,6 +375,25 @@
             </div>
 
 
+            <div class="bk">
+                <demolink
+                    :pkgname="'w-table-vue'"
+                    :kbname="'w-table-edit'"
+                    :casename="'opt.kpCellFormat'"
+                ></demolink>
+
+                <w-table-edit
+                    style="width:600px; height:400px;"
+                    :name="WTableEdit.name"
+                    :description="WTableEdit.description"
+                    :opt="WTableEdit.opt8"
+                    @success="evSuccess"
+                    @error="evError"
+                ></w-table-edit>
+
+            </div>
+
+
             <div class="bk">
                 <demolink
                     :pkgname="'w-table-vue'"
@@ -655,6 +674,27 @@
             </div>
 
 
+            <div class="bk">
+                <demolink
+                    :pkgname="'w-table-vue'"
+                    :kbname="'w-table-edit'"
+                    :casename="'editable & opt.kpCellFormat & no useCellFormatWhenDownload'"
+                ></demolink>
+
+                <w-table-edit
+                    style="width:600px; height:400px;"
+                    :name="WTableEdit.name"
+                    :description="WTableEdit.description"
+                    :opt="WTableEdit.opt8"
+                    :editable="true"
+                    :useCellFormatWhenDownload="false"
+                    @success="evSuccess"
+                    @error="evError"
+                ></w-table-edit>
+
+            </div>
+
+
             <div class="bk">
                 <demolink
                     :pkgname="'w-table-vue'"
@@ -844,6 +884,27 @@ export default {
                         return rows
                     },
                 },
+                'opt8': {
+                    keys: keys1,
+                    kpHeadFilterType: kpHeadFilterType1,
+                    rows: rows1,
+                    kpCellFormat: { //格式化僅影響顯示與下載, 排序、過濾、編輯與save回傳之rows仍為原值
+                        'make': function(value, key, row, params) {
+                            //空值(null、undefined、空字串)會原樣傳入, 編輯模式新增列之各欄為空字串, 回傳null代表不格式化維持原值
+                            if (value === null || value === undefined || value === '') {
+                                return null
+                            }
+                            return String(value).toUpperCase()
+                        },
+                        'price': function(value, key, row, params) {
+                            //空值不可直接Number(), 否則''與null會變成0.00
+                            if (value === null || value === undefined || value === '') {
+                                return null
+                            }
+                            return Number(value).toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })
+                        },
+                    },
+                },
             },
             'actions': [
             ],

package/src/components/WTableEdit.vue

@@ -302,7 +302,8 @@ import WAggridVue from 'w-aggrid-vue/src/components/WAggridVue.vue'
  * @vue-prop {String|Array} [removeIdsWhenDownload=''] 輸入下載Excel檔案時欲移除的欄位字串或陣列，預設''
  * @vue-prop {Boolean} [funGetLtdtHookWhenDownload=null] 輸入下載Excel檔案時針對ltdt數據階段的攔截處理函數，預設為null
  * @vue-prop {Boolean} [funGetMatHookWhenDownload=null] 輸入下載Excel檔案時針對mat數據階段的攔截處理函數，預設為null
- * @vue-prop {Boolean} [enableHeadWhenDownload=false] 輸入下載Excel檔案時是否將欄位鍵值轉換成head布林值，此需提供opt.kpHead物件，預設為false
+ * @vue-prop {Boolean} [useHeadWhenDownload=false] 輸入下載Excel檔案時是否將欄位鍵值轉換成head布林值，此需提供opt.kpHead物件，預設為false
+ * @vue-prop {Boolean} [useCellFormatWhenDownload=true] 輸入下載Excel檔案時是否依opt.kpCellFormat格式化各欄值布林值，true時下載內容與畫面一致(有格式化函數之欄為格式化後字串)，false時下載原值，無opt.kpCellFormat時無作用，對應w-aggrid-vue之downloadData與downloadDisplayData之useFormat，預設為true
  * @vue-prop {String} [fileNameWhenDownload='data.xlsx'] 輸入下載Excel檔案時儲存檔名稱字串，預設'data.xlsx'
  * @vue-prop {String} [sheetNameWhenDownload='data'] 輸入下載Excel檔案時sheet名稱字串，預設'data'
  * @vue-prop {Boolean} [editable=false] 輸入是否可編輯布林值，可被opt.defCellEditable複寫，預設為false
@@ -335,8 +336,8 @@ import WAggridVue from 'w-aggrid-vue/src/components/WAggridVue.vue'
  * @vue-slot {Object} infor 顯示模式下資訊區之渲染slot，slot props為{ infor }，infor為{ name, description }
  * @vue-slot {Object} btns-left 選單按鈕區最左側之插入slot，slot props為{ editable }
  * @vue-slot {Object} btns-right 選單按鈕區最右側之插入slot，slot props為{ editable }
- * @vue-slot {Object} cell-render 輸入cell之渲染slot，轉發至w-aggrid-vue，slot props為{ value, key, row }
- * @vue-slot {Object} cell-tooltip 輸入cell之tooltip渲染slot，轉發至w-aggrid-vue，slot props為{ value, key, row }，slot內容於掛載時取靜態HTML快照，不支援事件綁定、子組件狀態與響應式更新
+ * @vue-slot {Object} cell-render 輸入cell之渲染slot，轉發至w-aggrid-vue，slot props為{ value, valueFormatted, key, row }，value為原值，valueFormatted為該欄有opt.kpCellFormat時之格式化值，否則為undefined
+ * @vue-slot {Object} cell-tooltip 輸入cell之tooltip渲染slot，轉發至w-aggrid-vue，slot props為{ value, valueFormatted, key, row }，value為原值，valueFormatted為該欄有opt.kpCellFormat時之格式化值，否則為undefined，slot內容於掛載時取靜態HTML快照，不支援事件綁定、子組件狀態與響應式更新
  * @vue-slot {Object} head-render 輸入head之渲染slot，轉發至w-aggrid-vue，slot props為{ value, key }
  * @vue-slot {Object} head-tooltip 輸入head之tooltip渲染slot，轉發至w-aggrid-vue，slot props為{ value, key }，slot內容於掛載時取靜態HTML快照，不支援事件綁定、子組件狀態與響應式更新
  * @vue-prop {Object} [opt={}] 輸入w-aggrid-vue設定物件，預設{}
@@ -372,6 +373,7 @@ import WAggridVue from 'w-aggrid-vue/src/components/WAggridVue.vue'
  * @vue-prop {Object} [opt.kpCellAlignH={}] 輸入key對應cell之左右對齊字串物件，預設各key值為defCellAlignH
  * @vue-prop {Boolean} [opt.defCellEditable=false] 輸入cell預設之是否可編輯布林值，由組件editable複寫，預設為false
  * @vue-prop {Object} [opt.kpCellEditable={}] 輸入key對應cell之是否可編輯物件，預設各key值為defCellEditable
+ * @vue-prop {Object} [opt.kpCellFormat={}] 輸入key對應cell之值格式化函數物件，函數簽名為(value, key, row, params)，回傳顯示字串，回傳null或undefined代表不格式化維持原值；所有原值(含null、undefined、空字串)皆原樣傳入，編輯模式新增列之各欄為空字串，故函數內須自行處理空值(如回傳null)；作用於顯示與下載(下載時params為null，可由組件useCellFormatWhenDownload關閉)，排序、過濾、編輯與save回傳之rows仍為原值；與cell-render slot可並用，預設各key值為undefined
  * @vue-prop {Object} [opt.kpConvertKeysWhenUploadData={}] 輸入上傳Excel檔案時，當key轉會成對應新key值物件，預設{}
  * @vue-prop {Function} [opt.rowsChange=function(){}] 輸入rows change之觸發事件，預設為function(){}
  * @vue-prop {Function} [opt.rowClick=function(){}] 輸入row click之觸發事件，預設為function(){}
@@ -489,10 +491,14 @@ export default {
             type: Function,
             default: null,
         },
-        enableHeadWhenDownload: {
+        useHeadWhenDownload: {
             type: Boolean,
             default: false,
         },
+        useCellFormatWhenDownload: {
+            type: Boolean,
+            default: true,
+        },
         fileNameWhenDownload: {
             type: String,
             default: 'data.xlsx',
@@ -1133,7 +1139,8 @@ export default {
                     //     return mat
                     // },
                     funGetMatHook: vo.funGetMatHookWhenDownload,
-                    useHead: vo.enableHeadWhenDownload, //default: false
+                    useHead: vo.useHeadWhenDownload, //default: false
+                    useFormat: vo.useCellFormatWhenDownload, //default: true, 依opt.kpCellFormat格式化使下載與畫面一致
                     fileName: vo.fileNameWhenDownload, //default: 'data.xlsx'
                     sheetName: vo.sheetNameWhenDownload, //default: data
                 })