Python Tkinter GUI输入验证
视觉智能 人气:0输入验证
在本文中，将介绍如何使用 Tkinter 验证来验证用户输入。
1、Tkinter 验证简介
Tkinter 验证依赖于可用于任何输入小部件（例如 Entry 小部件）的三个选项：
- validate：指定哪种类型的事件将触发验证。
- validatecommand：检查数据是否有效
- invalidcommand：当数据无效时执行。 换句话说，如果 validate 命令返回 False，它将执行。
1.1 validate命令
validate 命令可以是以下字符串值之一：
| 名称 | 描述 |
|---|---|
| ‘focus’ | 验证小部件何时获得或失去焦点 |
| ‘focusin’ | 每当小部件获得焦点时进行验证 |
| ‘focusout’ | 验证小部件何时失去焦点 |
| ‘key’ | 每当任何击键更改小部件的内容时进行验证 |
| ‘all’ | 在上述所有情况下验证聚焦、聚焦和关键 |
| ‘none’ | 关闭验证。 默认设置 |
1.2 validatecommand
validatecommand 是一个元组，包含：
- 对 Tcl/tk 函数的引用。
- 零个或多个替换代码指定触发要传递给函数的事件的信息。
要获取对 Tck/tk 函数的引用，请将可调用对象传递给 widget.register() 方法。 它返回一个可以与 validate 命令一起使用的字符串。
下表显示了可用于元组的替换代码：
| 名称 | 描述 |
|---|---|
%d' | 操作代码：0 表示尝试删除，1 表示尝试插入，或 -1 如果调用回调以聚焦、聚焦或更改“文本变量” |
'%i' | 当用户试图插入或删除文本时，此参数将是插入或删除开始的索引。 如果回调是由于聚焦、聚焦或更改“textvariable”，则参数将为“-1” |
'%P' | 如果允许更改，文本将具有的值 |
'%s' | 更改前Entry中的文本 |
'%S' | 如果调用是由于插入或删除，此参数将是被插入或删除的文本 |
'%v' | 小部件的 validate 选项的当前值 |
'%V' | 此回调的原因：如果 textvariable 被更改，则为 'focusin'、'focusout'、'key' 或 'forced' 之一 |
'%W' | 小部件的名称 |
以下示例构造一个使用 self.validate() 方法和 %P 替换代码的 validatecommand：
vcmd = (self.register(self.validate), '%P')
1.3 invalidcommand
与 validatecommand 一样，invalidcommand 也需要使用 widget.register() 方法和替换代码。
以下示例返回一个元组，您可以将其传递给 invalidcommand 选项：
ivcmd = (self.register(self.on_invalid),)
2、完整示例
下面将创建一个包含电子邮件输入的表单。 如果输入了无效的电子邮件地址，它将显示一条错误消息并将电子邮件输入的文本颜色更改为红色。 当焦点移出条目时，我们将触发验证事件。
import tkinter as tk
from tkinter import ttk
import re
class App(tk.Tk):
def __init__(self):
super().__init__()
self.title('Tkinter Validation Demo')
self.create_widgets()
def create_widgets(self):
self.columnconfigure(0, weight=1)
self.columnconfigure(1, weight=3)
self.columnconfigure(2, weight=1)
# label
ttk.Label(text='Email:').grid(row=0, column=0, padx=5, pady=5)
# email entry
vcmd = (self.register(self.validate), '%P')
ivcmd = (self.register(self.on_invalid),)
self.email_entry = ttk.Entry(self, width=50)
self.email_entry.config(validate='focusout', validatecommand=vcmd, invalidcommand=ivcmd)
self.email_entry.grid(row=0, column=1, columnspan=2, padx=5)
self.label_error = ttk.Label(self, foreground='red')
self.label_error.grid(row=1, column=1, sticky=tk.W, padx=5)
# button
self.send_button = ttk.Button(text='Send').grid(row=0, column=4, padx=5)
def show_message(self, error='', color='black'):
self.label_error['text'] = error
self.email_entry['foreground'] = color
def validate(self, value):
"""
Validat the email entry
:param value:
:return:
pattern = r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b'
if re.fullmatch(pattern, value) is None:
return False
self.show_message()
return True
def on_invalid(self):
Show the error message if the data is not valid
self.show_message('Please enter a valid email', 'red')
if __name__ == '__main__':
app = App()
app.mainloop()示例代码如何工作？
第一步，使用 self.validate() 方法和 %P 替换代码创建一个验证命令：
vcmd = (self.register(self.validate), '%P')
第二步，创建使用 self.on_invalid 方法的 invalidatecommand：
ivcmd = (self.register(self.on_invalid),)
第三步，配置使用validation、validatecommand和invalidatecommand的Entry小部件：
self.email_entry.config(validate='focusout', validatecommand=vcmd, invalidcommand=ivcmd)
第四步，定义改变 label_error 小部件的文本和 email_entry 小部件的文本颜色的 show_message() 方法：
def show_message(self, error='', color='black'):
self.label_error['text'] = error
self.email_entry['foreground'] = color第五步，定义验证 email_entry 值的 validate() 方法。
def validate(self, value):
"""
Validat the email entry
:param value:
:return:
"""
pattern = r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b'
if re.fullmatch(pattern, value) is None:
return False
self.show_message()
return True如果输入文本有效，则 validate() 方法返回 True，否则返回 False。 如果输入文本是有效的电子邮件地址，请调用 show_message() 隐藏错误消息并将文本颜色设置为黑色。
如果输入文本不是有效的电子邮件地址，Tkinter 将执行 on_invalid() 方法。
最后，定义显示错误消息的 on_invalid() 方法并将 email_entry 小部件的文本颜色设置为红色。
def on_invalid(self):
"""
Show the error message if the data is not valid
:return:
"""
self.show_message('Please enter a valid email', 'red')加载全部内容