概述
本 Demo 展示了如何在 SpreadJS 公式中使用通配符进行模糊匹配。通过 DCOUNT、VLOOKUP、COUNTIF、SEARCH 等函数演示了三种通配符的用法：问号（?）匹配任意单个字符、星号（*）匹配任意多个字符、波浪号（~）转义通配符字符。
实现思路
创建三个表格：条件表格（A1:F3）、数据表格（A4:E10）、公式结果表格（A12:F17）
在条件表格中设置包含通配符的筛选条件
在数据表格中填充水果数据（名称、高度、年龄、产量、利润）
在公式结果表格中使用不同函数演示通配符的应用场景
通过 setFormula 方法设置公式，展示通配符在各种函数中的使用方式
代码解析
设置数据表格和条件表格
这段代码创建了条件区域和数据区域。条件区域的第一行为字段名，第二行和第三行为筛选条件。=App?e 使用问号通配符匹配 "Apple" 和 "AppLe"，=P* 使用星号通配符匹配所有以 "P" 开头的名称。
使用 DCOUNT 函数配合通配符
DCOUNT 函数使用 A1:F3 作为条件区域，条件中包含通配符，统计符合条件的数据行中 Age 列的数字单元格数量。条件区域的第二行 =App?e,>10,<16 表示匹配名称为 "App?e" 模式、高度大于 10、高度小于 16 的记录。
使用 VLOOKUP 函数配合通配符
VLOOKUP 使用 "Ch*" 作为查找值，匹配以 "Ch" 开头的第一个记录（"Cherry"），并返回对应的高度值 13。
使用 SEARCH 函数配合通配符
SEARCH 函数使用 "?t" 模式，在 B1 单元格（"Height"）中查找第二个字符为 "t" 的位置，返回结果为 4。
使用 COUNTIF 函数配合通配符
COUNTIF 函数统计 A5:B11 区域中匹配 "App?e" 模式的单元格数量，该模式匹配 "Apple" 和 "AppLe"。
转义通配符字符
当需要查找实际的通配符字符时，使用波浪号 ~ 进行转义。"=P~*" 表示查找包含字面值 "=P*" 的文本，而不是将 * 作为通配符。
运行效果
表格显示三个区域：条件表格（顶部）、数据表格（中部）、公式结果表格（底部）
DCOUNT 公式返回符合条件的数据行数
VLOOKUP 公式返回匹配 "Ch*" 模式的第一个结果
SEARCH 公式返回字符位置
COUNTIF 公式返回匹配单元格的数量
所有公式都利用通配符实现了灵活的模式匹配
通配符说明
SpreadJS 支持以下三种通配符：
? - 匹配任意单个字符。例如："App?e" 匹配 "Apple" 和 "AppLe"
* - 匹配任意多个字符（包括零个字符）。例如："Ch*" 匹配 "Cherry" 和 "China"
~ - 转义字符，用于匹配实际的 ?、* 或 ~ 字符。例如："a~*" 匹配字面值 "a*"
重要限制：通配符只能在匹配条件为等于（=）时使用，不能在其他比较运算符（>、<、!=、<=、>=）中使用。
支持通配符的函数
以下函数的条件参数支持使用通配符：
统计函数
AVERAGEIF、AVERAGEIFS - 条件平均值计算
COUNTIF、COUNTIFS - 条件计数
SUMIF、SUMIFS - 条件求和
查找函数
VLOOKUP、HLOOKUP - 纵向/横向查找
MATCH - 位置匹配
SEARCH - 文本搜索
数据库函数
DAVERAGE、DCOUNT、DCOUNTA、DGET、DMAX、DMIN、DPRODUCT、DSTDEV、DSTDEVP、DSUM、DVAR、DVARP
数据库函数的条件区域单元格值中可以使用通配符进行模式匹配。
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 1 });
initSpread(spread);
};
function initSpread(spread) {
var spreadNS = GC.Spread.Sheets;
var sheet = spread.sheets[0];
spread.suspendPaint();
sheet.options.allowCellOverflow = true;
var array = [
["Tree", "Height", "Age", "Yield", "Profit", "Height"],
["=App?e", ">10", null, null, null, "<16"],
["=P*"],
["Tree", "Height", "Age", "Yield", "Profit"],
["Apple", 18, 20, 14, 105],
["Pear", 12, 12, 10, 96],
["Cherry", 13, 14, 9, 105],
["AppLe", 14, 15, 10, 75],
["Pear", 9, 8, 8, 76.8],
["Apple", 8, 9, 6, 45]
];
sheet.setArray(0, 0, array);
sheet.setColumnWidth(0, 100);
var table = sheet.tables.add("Table1", 0, 0, 3, 6, spreadNS.Tables.TableThemes.medium4);
table.rowFilter().filterButtonVisible(false);
table = sheet.tables.add("Table2", 4, 0, 7, 5, spreadNS.Tables.TableThemes.medium4);
table.rowFilter().filterButtonVisible(false);
table = sheet.tables.add("Table3", 12, 0, 5, 6, spreadNS.Tables.TableThemes.medium4);
table.rowFilter().filterButtonVisible(false);
sheet.addSpan(12, 1, 1, 5);
sheet.setValue(12, 0, 'Formula Result');
sheet.setValue(12, 1, 'Formula with wildcard');
sheet.addSpan(13, 1, 1, 5);
sheet.setValue(13, 1, '=DCOUNT(A4:E10,"Age",A1:F3)');
sheet.setFormula(13, 0, 'DCOUNT(A4:E10,"Age",A1:F3)');
sheet.addSpan(14, 1, 1, 5);
sheet.setValue(14, 1, '=SEARCH("?t", B1)');
sheet.setFormula(14, 0, 'SEARCH("?t", B1)');
sheet.addSpan(15, 1, 1, 5);
sheet.setValue(15, 1, '=VLOOKUP("Ch*",A5:B10,2,0)');
sheet.setFormula(15, 0, 'VLOOKUP("Ch*",A5:B10,2,0)');
sheet.addSpan(17, 1, 1, 5);
sheet.setValue(17, 1, '=COUNTIF(A5:B11,"App?e")');
sheet.setFormula(17, 0, 'COUNTIF(A5:B11,"App?e")');
sheet.setValue(18, 1, '=SEARCH("=P~*",A3)');
sheet.setFormula(18, 0, 'SEARCH("=P~*",A3)');
spread.resumePaint();
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta name="spreadjs culture" content="zh-cn" />
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" class="sample-spreadsheets"></div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
.sample-spreadsheets {
width: 100%;
height: 100%;
overflow: hidden;
float: left;
border: 1px solid gray;
}
