概述
本 Demo 展示了三个文本操作函数的使用方法。TEXTBEFORE 用于提取分隔符之前的文本,TEXTAFTER 用于提取分隔符之后的文本,TEXTSPLIT 用于将文本按分隔符拆分成行或列。Demo 通过三个工作表分别演示了这三个函数的不同用法。
实现思路
创建三个工作表,分别命名为 TEXTBEFORE、TEXTAFTER 和 TEXTSPLIT
在每个工作表中设置测试数据和公式
TEXTBEFORE 和 TEXTAFTER 工作表演示如何提取分隔符前后的文本,包括指定实例编号、反向搜索和大小写匹配模式
TEXTSPLIT 工作表演示如何使用列分隔符和行分隔符拆分文本
启用动态数组功能(allowDynamicArray = true),让 TEXTSPLIT 的结果自动溢出到相邻单元格
代码解析
设置动态数组
Demo 启用了动态数组功能,使 TEXTSPLIT 函数能够将拆分后的文本自动溢出到相邻单元格。
TEXTBEFORE 函数示例
这段代码演示了 TEXTBEFORE 函数的不同用法:
TEXTBEFORE(A2,"Red") - 提取第一个"Red"之前的文本
TEXTBEFORE(A3,"red",2) - 提取第2个"red"之前的文本
TEXTBEFORE(A3,"red",-2) - 从右向左搜索,提取倒数第2个"red"之前的文本
TEXTBEFORE(A3,"Red") - 区分大小写匹配,找不到匹配返回错误
TEXTBEFORE(A3,"Red",,1) - 第四个参数 match_mode 设置为 1,表示不区分大小写
TEXTAFTER 函数示例
TEXTAFTER 的参数用法与 TEXTBEFORE 类似,只是提取的是分隔符之后的文本。
TEXTSPLIT 函数示例
这段代码演示了 TEXTSPLIT 使用空格作为列分隔符,将 "Dakota Lennon Sanchez" 拆分成三个单元格。
这个例子演示了同时使用列分隔符和行分隔符。逗号作为列分隔符,分号作为行分隔符,将 "1,2,3;4,5,6" 拆分成 2 行 3 列的矩阵。
运行效果
TEXTBEFORE 工作表:展示从 "Little Red Riding Hood's red hood" 中提取分隔符前文本的各种场景,包括指定第几个分隔符、反向搜索、大小写匹配等
TEXTAFTER 工作表:展示提取分隔符后文本的类似功能
TEXTSPLIT 工作表:演示三个文本拆分场景,分别是按空格拆分姓名、按空格拆分短语、按逗号和分号拆分成矩阵
所有公式结果都使用 FORMULATEXT 函数展示对应的公式文本,方便理解每个函数的用法
API 参考
TEXTBEFORE 函数
text:要搜索的文本
delimiter:分隔符文本
instance_num(可选):分隔符的实例编号,默认为 1
match_mode(可选):0 表示区分大小写,1 表示不区分大小写
match_end(可选):将文本末尾作为分隔符
if_not_found(可选):未找到分隔符时的返回值
TEXTAFTER 函数
参数与 TEXTBEFORE 相同,返回分隔符之后的文本。
TEXTSPLIT 函数
text:要拆分的文本
col_delimiter:列分隔符
row_delimiter(可选):行分隔符
ignore_empty(可选):是否忽略空单元格
match_mode(可选):0 表示区分大小写,1 表示不区分大小写
pad_with(可选):填充值
window.onload = function() {
var spread = new GC.Spread.Sheets.Workbook(_getElementById("ss"));
spread.options.allowDynamicArray = true;
initStyles(spread);
initSpread(spread);
};
var data = [
{
sheetName: 'TEXTBEFORE',
cells: [
[{v:"Data",s:"title"}],
["Little Red Riding Hood's red hood"],
["Little red Riding Hood's red hood"],
[{v:"Formulas",s:"title"}, {v:"Results",s:"title"}],
["=FORMULATEXT(B5)", '=TEXTBEFORE(A2,"Red")'],
["=FORMULATEXT(B6)", '=TEXTBEFORE(A3,"red",2)'],
["=FORMULATEXT(B7)", '=TEXTBEFORE(A3,"red",-2)'],
["=FORMULATEXT(B8)", '=TEXTBEFORE(A3,"Red")'],
["=FORMULATEXT(B9)", '=TEXTBEFORE(A3,"Red",,1)'],
["=FORMULATEXT(B10)", '=TEXTBEFORE(A3,"Riding")'],
],
columnsWidth: [226, 156]
},
{
sheetName: 'TEXTAFTER',
cells: [
[{v:"Data",s:"title"}],
["Little Red Riding Hood's red hood"],
["Little red Riding Hood's red hood"],
[{v:"Formulas",s:"title"}, {v:"Results",s:"title"}],
["=FORMULATEXT(B5)", '=TEXTAFTER(A2,"Red")'],
["=FORMULATEXT(B6)", '=TEXTAFTER(A3,"red",2)'],
["=FORMULATEXT(B7)", '=TEXTAFTER(A3,"red",-2)'],
["=FORMULATEXT(B8)", '=TEXTAFTER(A3,"Red")'],
["=FORMULATEXT(B9)", '=TEXTAFTER(A3,"Red",,1)'],
["=FORMULATEXT(B10)", '=TEXTAFTER(A3,"Riding")'],
],
columnsWidth: [226, 156]
},
{
sheetName: 'TEXTSPLIT',
cells: [
[{v:"Data",s:"title"}],
["Dakota Lennon Sanchez"],
["To be or not to be"],
["1,2,3;4,5,6"],
[],
[{v:"Formulas",s:"title"}, "=FORMULATEXT(B7)"],
[{v:"Results",s:"title"}, '=TEXTSPLIT(A2, " ")'],
[],
[{v:"Formulas",s:"title"}, "=FORMULATEXT(B10)"],
[{v:"Results",s:"title"}, '=TEXTSPLIT(A3, " ")'],
[],
[{v:"Formulas",s:"title"}, "=FORMULATEXT(B13)"],
[{v:"Results",s:"title"}, '=TEXTSPLIT(A4,",",";")'],
],
columnsWidth: [168]
}
];
function initSpread(workbook) {
workbook.suspendPaint();
workbook.suspendCalcService();
workbook.setSheetCount(data.length);
for (var i = 0; i < data.length; i++) {
var sheetData = data[i];
var sheet = workbook.sheets[i];
sheet.name(sheetData.sheetName);
setCells(sheet, sheetData.cells, 0, 0);
setColumnsWidth(sheet, sheetData.columnsWidth);
}
workbook.resumeCalcService();
workbook.resumePaint();
}
function initStyles(workbook) {
var style = new GC.Spread.Sheets.Style();
style.name = 'title';
style.font = 'normal bold 16px Segoe UI';
style.foreColor = "#172b4d";
workbook.addNamedStyle(style);
}
function setCells(sheet, cells, rowIndex, colIndex) {
for(var i = 0; i < cells.length; i++) {
var row = cells[i];
var r = rowIndex + i;
for (var j = 0; j < row.length; j++) {
var cell = row[j];
var c = colIndex + j;
if (typeof cell === "object") {
if (cell.v !== undefined) {
sheet.setValue(r, c, cell.v);
}
if (cell.s !== undefined) {
sheet.setStyle(r, c, cell.s)
}
} else if (cell[0] === '=') {
sheet.setFormula(r, c, cell);
} else {
sheet.setValue(r, c, cell);
}
}
}
}
function setColumnsWidth(sheet, columnsWidth) {
if (!columnsWidth) {
return;
}
for (var i = 0; i < columnsWidth.length; i++) {
sheet.setColumnWidth(i, columnsWidth[i]);
}
}
function _getElementById(id) {
return document.getElementById(id);
}
<!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;
}