[TOC]
> Wed May 26 2021 22:00:24 GMT+0800 (GMT+08:00)
本節涉及 Javascript Array 對象的相關知識,不熟悉的小伙伴可以多研究下 Array 的相關屬性和方法。
本小節來看看單元格區域的 Value() 吧。測試數據如表:
_|A|B|C
--|--|---|--
1|A|B|C
2|D|E|F
3|G|H|I
## 測試
這里測試3種情形。行列混合;單行;單列。
### 行列混合
```js
function t(){
let rng = Range("A1:C3")
let rng_address = rng.Address() // 單元格區域地址
let rng_value = rng.Value() // 單元格區域的值
Console.log(`${rng_address}==>${JSON.stringify(rng_value)}`)
}
```
結果:
```
$A$1:$C$3==>[["A","B","C"],["D","E","F"],["G","H","I"]]
```
### 單行測試
```js
function t(){
let rng = Range("A1:C1")
let rng_address = rng.Address()
let rng_value = rng.Value()
Console.log(`${rng_address}==>${JSON.stringify(rng_value)}`)
}
```
結果:
```
$A$1:$C$1==>[["A","B","C"]]
```
挺正常的。
### 單列測試
```js
function t(){
let rng = Range("A1:A3")
let rng_address = rng.Address()
let rng_value = rng.Value()
Console.log(`${rng_address}==>${JSON.stringify(rng_value)}`)
}
```
結果:
```
$A$1:$A$3==>[["A"],["D"],["G"]]
```
## 結論
以 **`行`** 作為基礎數組對象來描述多行列單元格區域。有幾行就有幾個子數組對象,也可以看作有幾行就有幾個內嵌`[]`。行內的單元格均被 `[]`包裹。
> 這符合人們常規理解的表格行、列結構的描述邏輯。在早期版本的 wps js宏中沒有體現這一點。
1. 行內單元格的值被 `[]` 包裹;被子數組對象包含的值均在同一行。
## 扁平化
> 這部分涉及 JavaScript Array 對象的扁平化處理知識。參考:`Array.prototype.flat()` 方法。
雖然現在的單元格區域的值容易理解,但我們還是稍稍再拓展下。
1. 按照結論,比如單個單元格的值可以描述為 `[["A"]]`,扁平化之后得到 `"A"`;所以單個單元格的值不是數組對象而是具體的值。
>示例:
```js
function t2(){
let arr = [["A"]]
Range("A4").Value2 = arr;
}
```
2. 比如 `["A", "B", "C"]` 可以看作 `[["A", "B", "C"]]` 扁平化之后的結果,表示 1 行內連續的 3 個單元格。
3. 雖然經過 `Array.flat()` 處理之后,`[["A"], ["B"], ["C"]]`(表示 3 行 1 列) 也能變成 `["A", "B", "C"]`。但根據結論,這樣處理后行、列結構已經變化,變成了 1 行 3 列。
從以上幾點可以看出,在單元格區域中,`[]`是單元格的核心結構,你做的處理(扁平化、擴展處理)需要注意是否會導致原有單元格區域行、列結構發生變化!
> 當然,有時候我們需要這種變化!比如多行變單行。
同時也提示我們:在用 Array 的 flat 方法時應當小心!尤其是在單元格區域讀值時。
## 單元格區域的賦值(寫入)
有個通用的方法可以較準確地將數組寫入單元格區域:
```js
/**
* 單元格區域寫入
* @param {Array} arr 要寫入的數組。
* @param {Range} topRange 要寫入的單元格區域的首個單元格
*/
function writeArea(arr,topRange){
// 判斷首元素是不是數組
// 實質就是判斷是否為多行結構
let isArrayItem = Array.isArray(arr[0])
// 如果首元素是數組,即多行。
if(isArrayItem){
// arr.length 行數
// arr[0].length 列數
//(在多行列單元格區域中,每行的列數可定是相同的)
topRange.Resize(arr.length, arr[0].length).Value2 = arr;
}else{
// 否則為單行多列
topRange.Resize(1,arr.length).Value2 = arr;
}
}
```
> 這個方法足以應對絕大多數場景,如果參數 arr 的初始數組是比較復雜的結構請自行理順,使其符合單元格區域的讀值的相似結構。
我們接著看下面的例子:
```js
function t3(){
let arr = ["A", "B", "C"]
Range("E1").Resize(1,3).Value2 = arr // 1 行 3 列;成功賦值
Range("H1").Resize(3,1).Value2 = arr // 3 行 1 列;"B"、"C"丟失,賦值目的未達到
}
```
從例子可以看出,能否將數組內的元素完整寫入目標單元格區域,取決于**數組結構所表示的行、列結構** 與 **目標單元格行、列結構是否一致**。
### 拓展數組行、列結構
有時候數組內的元素不能滿足我們寫入單元格區域的行列結構,我們可以數組進行拓展。
#### 單行變多行
單行單元格區域怎么變多行單元格區域,看例子:
```js
function t4(){
let arr = ["A", "B", "C"]
let brr = arr.map(e=>[e]) // [["A"], ["B"], ["C"]]
Range("R1").Resize(brr.length, 1).Value2 = brr
}
```
#### 多行變單行
我們用開頭的例子:
```js
function R2C(){
let arr = [["A", "B", "C"], ["D", "E", "F"], ["G", "H", "I"]]
let brr = arr.flat()
Range("L1").Resize(brr.length, 1).Value2 = brr.map(e=>[e]);
}
```
變成每行兩格:
> 自行導入 lodash.js 或者自行解決數組分組的問題。
```js
function R1C2(){
let arr = [["A", "B", "C"], ["D", "E", "F"], ["G", "H", "I"]]
let brr = arr.flat()
// 偷懶,使用 lodash.js 的 chunk 方法
let crr = _.chunk(brr,2) // [["A", "B"], ["C", "D"],...]
Range("K1").Resize(crr.length, crr[0].length).Value2 = crr;
}
```
- 1-概述
- 2-升級吧
- 3-閱讀指南
- 4-答萌新問
- 5-iTool 加載項
- 6-iTool下載安裝
- 7-Gitee token 生成
- 8-喜歡用表格當下載器的小伙伴看過來
- 9-喜歡扒數據的小伙伴跟上
- 10-了解 WPS JS宏編輯器
- 11-快捷鍵
- 12-立即窗口
- 13-斷點調試
- 14-如何在 VB、JS 環境之間切換
- 15-如何快速進入使用、編輯JS宏
- 16-使用宏編輯器需要注意的點
- 17-保存&導出&使用宏
- 18-全局隱藏函數名(僅WPS)
- 19-如何命名自己的全局函數的名稱(宏名)
- 20-如何使用別人寫的宏
- 21-如何修改錄制好的宏
- 22-WPS 宏中可用的 JS 庫
- 23-將 Lodash 裝進 WPS JS宏
- 24-使用 Moment.js
- 25-用 Papa Parse 進行JSON、CSV 互轉
- 26-Lodash.js源碼
- 27-Moment.js源碼
- 28-papaparse.js源碼
- 29-WPS JSAPI
- 30-對象名中英文對照表
- 31-事件匯總
- 32-對象屬性的使用
- 33-從 Excel VBA 宏到 WPS JS宏
- 34-從 Visual Basic Script 轉到 JavaScript
- 35-fileSystem文件系統
- 36-Open 與 Write
- 37-將內容寫入 TXT 文件
- 38-Dir 函數讀文件夾
- 39-關于顏色
- 40-表單、ActiveX控件
- 41-控件樣式
- 42-數據綁定
- 43-解決“我是誰,我在哪”的問題
- 44-繞坑:那些奇奇怪怪的問題
- 45-警惕:宏操作對象限制
- 46-別造輪子了,用現成的吧
- 47-Item 屬性快把你逼瘋了吧
- 48-空單元格的值是什么
- 49-單元格區域(多個單元格)的值
- 50-編譯參數禁止項開關導致的問題
- 51-代碼上下文帶來的問題
- 52-API 中方法函數參數的問題
- 53-結束進程吧
- 54-福利:WPS 表格 Modules 開箱即用
- 55-最后一格可用空單元格總在變?幫你追上它
- 56-判斷一個單元格是不是在指定區域里
- 57-工作表類
- 58-單元格讀取封裝
- 59-WPS JS 加載項
- 60-加載項開發繞坑
- 61-開發
- 62-部署、分發
- 63-安裝、卸載加載項
- 64-更智能的處理加載項的安裝
- 65-WPS 控件點擊之后報錯:Error: arguments error
- 66-對 wpsjs npm 包的一些改進
- 67-加載項中 TaskPane 和 Dialog之間的差別
- 68-怎么解決 ShowDialog 窗口無限彈出?
- 69-Custom UI
- 70-控制控件在不同應用上的顯示和隱藏
- 71-本地化處理
- 72-加載項示例和自建工具
- 73-如何保證在無 WEB 環境下加載項依舊正常工作
- 74-WPS 對 customUI 組件的支持程度
- 75-如何讓加載項的 input 類元素準確關聯 SheetSelectionChange 事件
- 76-從零開始開發一個簡易的 JS 加載項
- 77-搭建項目
- 78-插件規劃
- 79-第一個 ribbonUI 控件
- 80-第一個彈窗 confirm
- 81-第一個 Web 彈窗: ShowDialog
- 82-第一個側欄 TaskPane
- 83-打包第一個版本
- 84-RibbonUI 控件不完全示例
- 85-基本結構
- 86-WPS JS加載項 RibbonUI 控件 API 與 VBE API 的差別
- 87-控件屬性設計"誤區"
- 88-主控:有條件加載 customUI.onLoad
- 89-布局盒子(父元素)
- 90-控件屬性·事件·動作
- 91-簡單示例
- 92-WPS 表格
- 93-單元格
- 94-如何描述單元格對象
- 95-單元格讀寫
- 96-單元格信息
- 97-關于合并單元格
- 98-合并單元格,I hate it!
- 99-單元格復制粘貼
- 100-選擇性粘貼
- 101-自定義序列
- 102-單元格的刪除/插入
- 103-單元格填充
- 104-單元格去重和高亮突出顯示
- 105-單元格條件格式
- 106-數據透視表
- 107-自動篩選
- 108-通過 JS 宏處理 DISPIMG 函數
- 109-計時器:OnTime 和 Wait
- 110-探索: Range.Offset 如何安全“漂移”
- 111-表格自動化事件
- 112-創建一個事件記錄日志工作表
- 113-實現類 Vlookup 單條件提取內容
- 114-代碼和宏說明
- 115-創建工作表目錄
- 116-將所有批注匯總成列表
- 117-JS宏代碼
- 118-剝離 UDF 公式(數值化處理)
- 119-單元格區域轉 JSON 并寫入文件
- 120-JS宏代碼
- 121-設置工作表標簽(Tab)顏色
- 122-插入日歷 calendar
- 123-再偷懶些
- 124-示例代碼
- 125-WPS 表格函數表
- 126-JS 宏中可用的表格函數
- 127-WPS 表格-工作表-工作簿
- 128-通用簡易工作表目錄
- 129-工作表排序
- 130-巧用 Parent 進行對象鎖定
- 131-我想要的 WPS 表格函數
- 132-單元格字符匹配統計
- 133-基于正則表達式的 Replace
- 134-身份證
- 135-控件 API 精講(以表格為例)
- 136-窗體控件
- 137-ActiveX 控件
- 138-WPS 文檔
- 139-"定位"專題
- 140-視圖切換
- 141-別被 paragraph 騙了
- 142-無效腳注、尾注檢測
- 143-獲取所有標題
- 144-答網友問
- 145-輪序鍵入——鍵入完成自動切換單元格
- 146-又是一個很會偷懶的 Bigger Cousin
- 147-給你演示什么叫"畫地為牢"
- 148-示例代碼
- 149-如何批量超鏈接到同名的sheet?
- 150-如何將一個表中一個列的值合并到另一個表中的一個單元格中?
- 151-多個字符都往一個單元格里塞
- 152-wps如何將A列里包含B列的單元格高亮顯示?
- 153-excel中隨著打印份數漸序更新日期的函數?
- 154-就是玩兒
- 155-挖寶:尋找API文檔中沒有的接口
- 156-通過 Application 對象的屬性獲取信息
- 157-呵呵,失敗的抽獎!
- 158-哪里不會點哪里
- 159-芝麻開門
- 160-乖,別鬧,Stay here
- 161-JS宏 實現【WPS 表格 VIP 專享】功能挑戰
- 162-工作表批量重命名
- 163-工作表標簽批量著色
- 164-工作表拆分為工作簿
- 165-工作簿合并為工作表
- 166-WPS 表格 API 參考
- 167-Application.InpuBox
- 168-Worksheet(s)、Sheets
- 169-Range.End 精講
- 170-Cells 精講
- 171-WPS 文字 API 參考
- 172-怎么快速掌握 文字 宏API
- 173-WPS 宏編輯器 API 參考
- 174-InputBox
- 175-MsgBox
- 176-alert
- 177-WPS 擴展 API 參考
- 178-WebShape
- 179-通用 API 參考
- 180-WPS Office文件上傳&下載 JavaScript 宏 API
- 181-JS宏API:Office(全網獨一份)
- 182-公共部分
- 183-文字獨有
- 184-JavaScript 語言基礎筆記
- 185-國際化API(格式化處理)
- 186-數組
- 187-日期時間
- 188-數學計算
- 189-外接輸入設備(讀卡器、掃碼槍)數據寫進 WPS 可行性
- 190-鳴謝