如何用WPS JS宏跳过筛选后的隐藏行？

Question

在使用WPS JS宏处理表格数据时，一个常见的问题是：如何在遍历数据时跳过筛选后被隐藏的行？用户通常希望仅对可见行进行操作，但默认情况下JS宏会遍历所有行，包括被筛选隐藏的行。这会导致数据处理结果不准确或效率低下。解决该问题的关键在于判断当前行是否为“可见”状态。可通过读取行的 `EntireRow.Hidden` 属性来判断该行是否被隐藏，并结合循环结构跳过隐藏行，从而实现仅对筛选后的可见行进行操作，提升脚本的实用性和准确性。

Answer 1

在WPS JS宏中跳过筛选后隐藏行的处理方法

在使用WPS JS宏处理表格数据时，一个常见的问题是：如何在遍历数据时跳过筛选后被隐藏的行？用户通常希望仅对可见行进行操作，但默认情况下JS宏会遍历所有行，包括被筛选隐藏的行。这会导致数据处理结果不准确或效率低下。

1. 问题背景与常见现象

当用户在WPS表格中使用自动筛选功能后，部分行会被隐藏。此时如果通过JS宏循环处理整列或整表的数据，默认行为是访问所有行，无论其是否被隐藏。

• 例如，在以下代码中，即使某行被隐藏，也会被访问到：

for (let i = 1; i <= sheet.UsedRange.Rows.Count; i++) {
    let cellValue = sheet.Cells(i, 1).Text;
    // 处理逻辑
}
    

2. 判断行是否为“可见”状态

解决该问题的关键在于判断当前行是否为“可见”状态。可通过读取行的 EntireRow.Hidden 属性来判断该行是否被隐藏。

属性名称	含义	返回值类型
EntireRow.Hidden	判断整行是否被隐藏	布尔值（true 表示隐藏）

3. 结合循环结构实现跳过隐藏行

通过在循环中加入条件判断语句，可以跳过被隐藏的行。这样就能实现仅对筛选后的可见行进行操作。

let sheet = Application.ActiveSheet;
for (let i = 1; i <= sheet.UsedRange.Rows.Count; i++) {
    if (!sheet.Rows(i).EntireRow.Hidden) {
        let value = sheet.Cells(i, 1).Text;
        console.log(value);
    }
}
    

4. 性能优化建议

虽然上述方法能够实现目标，但在大数据量下可能会有性能瓶颈。可以通过以下方式进行优化：

1. 限制遍历范围，如只处理有数据的区域（UsedRange）。
2. 避免频繁调用 .Text 或 .Value，可将整列数据一次性读入数组处理。

5. 流程图说明整体逻辑

graph TD
            A[开始] --> B[获取当前工作表]
            B --> C[遍历每一行]
            C --> D{行是否被隐藏?}
            D -- 是 --> E[跳过该行]
            D -- 否 --> F[处理该行数据]
            E --> G[继续下一行]
            F --> G
            G --> H{是否完成遍历?}
            H -- 否 --> C
            H -- 是 --> I[结束]