数据验证是表格控件经常使用到的一个功能,可以使用定义的约束来表明一个单元格上可以或者应该设置什么样的数据的特性。你可以通过配置数据验证来阻止用户输入无效的数据,通常单元格输入数据的验证有验证输入是否是数字、日期、文本长度等,
SpreadJS提供了强大的数据验证功能,通过
SpreadJS你可以创建如下的六种验证器:
- createNumberValidator:创建基于数字的验证器。
- createDateValidator:创建基于数据的验证器。
- createTextLengthValidator: 创建基于文本长度的验证器。
- createFormulaValidator: 创建基于公式的验证器。
- createFormulaListValidator: 创建基于公式列表的验证器。
- createListValidator: 创建基于列表的验证器。
下面就简单介绍如何使用
SpreadJS进行单元格数据验证,具体如下:
1.要为工作表添加一个数据验证器,应该创建一个验证器然后将其添加到工作表上。例如:
var dv1 = new Gc
Spread.Sheets.DefaultDataValidator
.createListValidator('Fruit,Vegetable,Food');
dv1.inputTitle = 'Please choose a category:';
dv1.inputMessage = 'Fruit Vegetable Food';
sheet.setDataValidator(1,1, dv1);
2.在你为一个单元格设置验证器之后,你可以调用 getDataValidator 方法来获取单元格上的数据验证器。你也可以调用 isValid 方法来判定单元格的值是否是有效的。例如:
sheet.isValid(1, 1, 'Fruit'); // true
var validList = sheet.getDataValidator(1, 1);
validList.isValid(sheet, 1, 1, 'Fruit')
// clear the data validator
sheet.setDataValidator(1, 1, null);
3.你可以调用 highlightInvalidData 方法来获取或者设置是否要高亮显示无效的数据。如果它被设置为 true ,那么当单元格中的数据无效时,单元格中会显示一个红色的圆圈。
Spread.highlightInvalidData(true);