文本操作函数

SpreadJS 提供了三个强大的文本操作函数,用于灵活地拆分和提取文本内容。TEXTBEFORE 函数可以提取分隔符之前的文本,TEXTAFTER 函数可以提取分隔符之后的文本,TEXTSPLIT 函数可以将文本按分隔符拆分成多行或多列。这些函数支持指定分隔符出现的位置、大小写匹配模式等参数,能够满足各种复杂的文本处理需求。

概述 本 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; }