概述
本 Demo 展示了 REGEXTEST 函数的使用方法,该函数用于判断文本是否匹配指定的正则表达式。Demo 中包含两个功能区域:第一部分演示了如何结合条件格式,根据匹配结果显示不同颜色;第二部分演示了如何结合数据校验功能,对匹配结果进行验证。
实现思路
初始化表格样式,设置居中对齐和列宽
创建第一个功能区域:条件格式演示区
设置三组测试数据(文本、正则表达式、是否区分大小写)
在 E 列使用 REGEXTEST 函数计算匹配结果
应用条件格式:TRUE 显示绿色,FALSE 显示粉色
创建第二个功能区域:数据校验演示区
设置相同结构的测试数据
使用数据校验功能对匹配结果进行验证
代码解析
核心公式设置
代码中动态设置 REGEXTEST 公式,参数分别引用 A 列(文本)、B 列(正则表达式)、C 列(是否区分大小写)。FORMULATEXT 函数用于在 D 列显示公式文本。
条件格式设置
代码为结果列设置了两条条件格式规则:当单元格值等于 TRUE 时显示绿色背景,等于 FALSE 时显示粉色背景。
数据校验设置
代码使用公式验证器创建数据校验规则,并为校验失败的单元格设置左上角的粉色折角标记。
运行效果
表格分为两个区域:"条件格式"和"数据校验"
每个区域包含三组测试数据:
"SpreadJS Supports 400 functions." 与正则 \d+ 匹配(查找数字)
"My Name is (John Smith)" 与正则 \(([\w ]+)\) 匹配(查找括号内容)
"Red" 与正则 [^red] 匹配,不区分大小写
E 列显示 REGEXTEST 函数的返回结果(TRUE 或 FALSE)
条件格式区域:TRUE 显示绿色背景,FALSE 显示粉色背景
数据校验区域:单元格左上角有校验标记
API 参考
REGEXTEST 函数
text(必填):要测试的文本,可以是字符串、单元格引用或单元格范围
pattern(必填):正则表达式模式
case_sensitivity(可选):是否区分大小写,0(默认)区分大小写,1 不区分大小写
addCellValueRule 方法
operator:比较运算符
value1、value2:比较值
style:满足条件时应用的样式
ranges:应用规则的范围数组
createFormulaValidator 方法
formula:验证公式,返回 TRUE 表示通过验证
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
spread.options.highlightInvalidData = true;
var sheet = spread.sheets[0];
var defaultStyle = new GC.Spread.Sheets.Style();
defaultStyle.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
defaultStyle.vAlign = GC.Spread.Sheets.VerticalAlign.center;
sheet.setDefaultStyle(defaultStyle);
sheet.setColumnWidth(0, 250);
sheet.setColumnWidth(1, 250);
sheet.setColumnWidth(2, 150);
sheet.setColumnWidth(3, 250);
sheet.setColumnWidth(4, 150);
sheet.addSpan(0, 0, 2, 5);
sheet.getCell(0, 0).value("条件格式").font("21px bold normal normal");
initRange(sheet, 2);
var EQUAL_TO = GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.equalsTo;
var CONDITION_RANGE = [new GC.Spread.Sheets.Range(4, 4, 4, 1)];
var true_style = new GC.Spread.Sheets.Style();
true_style.backColor = 'lightgreen';
sheet.conditionalFormats.addCellValueRule(EQUAL_TO, true, undefined, true_style, CONDITION_RANGE);
var false_style = new GC.Spread.Sheets.Style();
false_style.backColor = 'pink';
sheet.conditionalFormats.addCellValueRule(EQUAL_TO, false, undefined, false_style, CONDITION_RANGE);
sheet.addSpan(8, 0, 2, 5);
sheet.getCell(8, 0).value("数据校验").font("21px bold normal normal");
initRange(sheet, 10);
createDataValidations(sheet, 12);
createDataValidations(sheet, 13);
createDataValidations(sheet, 14);
spread.resumePaint();
}
function initRange(sheet, baseRow) {
sheet.addSpan(baseRow, 0, 2, 1);
sheet.addSpan(baseRow, 1, 2, 1);
sheet.addSpan(baseRow, 2, 2, 1);
sheet.addSpan(baseRow, 3, 2, 1);
sheet.addSpan(baseRow, 4, 2, 1);
sheet.getCell(baseRow, 0).value("文本").font("21px bold normal normal");
sheet.getCell(baseRow, 1).value("正则表达式").font("21px bold normal normal");
sheet.getCell(baseRow, 2).value("区分大小写").font("21px bold normal normal");
sheet.getCell(baseRow, 3).value("公式文本").font("21px bold normal normal");
sheet.getCell(baseRow, 4).value("结果").font("21px bold normal normal");
var dataArr = [
["SpreadJS Supports 400 functions.", "\\d+", null],
["My Name is (John Smith)", "\\(([\\w ]+)\\)", null],
["Red", "[^red]", 1]
];
sheet.setArray(2 + baseRow, 0, dataArr);
for (var i = baseRow, len = dataArr.length; i < len + baseRow; i++) {
var row = 3 + i;
sheet.setFormula(row - 1, 4, `=REGEXTEST(A${row}, B${row}, C${row})`);
sheet.setFormula(row - 1, 3, `=FORMULATEXT(E${row})`);
}
}
function createDataValidations (sheet, row) {
var false_dv = GC.Spread.Sheets.DataValidation.createFormulaValidator("IF(E" + (row + 1) + ",TRUE,FALSE)");
false_dv.highlightStyle({type: GC.Spread.Sheets.DataValidation.HighlightType.dogEar, color: "pink", position: GC.Spread.Sheets.DataValidation.HighlightPosition.topLeft});
sheet.setDataValidator(row, 4, 1, 1, false_dv, 3);
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="spreadjs culture" content="zh-cn" />
<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>
input[type="text"] {
width: 200px;
margin-right: 20px;
}
label {
display: inline-block;
width: 110px;
}
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: 100%;
height: 100%;
overflow: hidden;
float: left;
}
label {
display: block;
margin-bottom: 6px;
}
input {
padding: 4px 6px;
}
input[type=button] {
margin-top: 6px;
display: block;
width:216px;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
code {
border: 1px solid #000;
}