Python XlsxWriter - 数据验证

Excel 中的数据验证功能允许您控制用户可以在单元格中输入的内容。您可以使用它来确保单元格中的值是指定范围内的数字/日期、具有所需长度的文本，或者显示一个下拉菜单以从中选择值。

数据验证工具位于“数据”菜单中。第一个选项卡允许您设置验证标准。下图显示标准要求单元格应包含 1 到 25 之间的整数 -

数据验证

在第二个选项卡中，设置当用户光标位于所需单元格上时闪烁的消息，在本例中为“输入 1 到 25 之间的任何整数”。还可以设置消息标题；在这种情况下是年龄。

数据验证1

第三个选项卡允许您定义在验证标准失败时要显示的任何错误消息。

数据验证2

当用户将光标置于 I10（已设置验证）时，可以看到输入消息。

年龄1

当输入的数字不在范围内时，错误信息将会闪烁。

年龄2

使用 XlsxWriter 数据验证

您可以使用data_validation()方法以编程方式设置验证标准、输入和错误消息。

worksheet.data_validation(
   'I10',
   {
      'validate': 'integer','criteria': 'between',
      'minimum': 1,'maximum': 25,
      'input_title': 'Enter an integer:',
      'input_message': 'between 1 and 25',
      'error_title': 'Input value is not valid!',
      'error_message': 'It  should be an integer between 1 and 25'
   }
)

data_validation ()方法接受选项参数作为具有以下参数的字典 -

  • validate - 用于设置您希望验证的数据类型。允许的值为整数、小数、列表、日期、时间、长度等。

  • criteria - 用于设置验证标准。它可以设置为任何逻辑运算符，包括Between / not Between、==、!=、<、>、<=、>=等。

  • value - 设置应用标准的限制值。它始终是必需的。使用列表验证时，它以逗号分隔的变量字符串形式给出。

  • input_title - 用于设置当光标放置在目标单元格时输入消息的标题。

  • input_message - 输入单元格时显示的消息。

  • error_title - 不满足验证标准时显示的错误消息的标题。

  • error_message - 设置错误消息。默认错误消息是“您输入的值无效。用户可以在单元格中输入的值受到限制。”

例子

以下使用data_validation()方法会导致数据验证功能的Behave如上图所示。

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
worksheet = wb.add_worksheet()

worksheet.data_validation(
   'I10',
   {
      'validate': 'integer','criteria': 'between',
      'minimum': 1,'maximum': 25,
      'input_title': 'Enter an integer:',
      'input_message': 'between 1 and 25',
      'error_title': 'Input value is not valid!',
      'error_message':'It should be an integer between 1 and 25'
   }
)
wb.close()

作为另一个示例，单元格 I10 设置了验证标准，以便强制用户从下拉列表中的字符串列表中选择其值。

worksheet.data_validation(
   'I10',
   {
      'validate': 'list',
      'source': ['Mumbai', 'Delhi', 'Chennai', 'Kolkata'],
      'input_title': 'Choose one:',
      'input_message': 'Select a value from th list',
   }
)

例子

修改后的下拉列表验证程序如下 -

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
worksheet = wb.add_worksheet()

worksheet.data_validation(
   'I10',
   {
      'validate': 'list',
      'source': ['Mumbai', 'Delhi', 'Chennai', 'Kolkata'],
      'input_title': 'Choose one:',
      'input_message': 'Select a value from the list',
   }
)
wb.close()

输出

当光标置于 I10 单元格中时，会出现下拉列表 -

下拉列表

例子

如果要让用户输入长度大于 5 的字符串，请使用>=作为条件并将值设置为 5。

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
worksheet = wb.add_worksheet()

worksheet.data_validation(
   'I10',{
      'validate': 'length',
      'criteria': '>=','value': 5,'input_title': 'Enter name:',
      'input_message': 'Minimum length 5 character',
      'error_message':'Name should have at least 5 characters'
   }
)

wb.close()

输出

如果字符串少于 5 个字符，则会弹出错误消息，如下所示 -

细绳