Input Dialog
InputDialog 是一个模态对话框,旨在提示用户输入。该对话框会阻止应用程序执行,直到用户提供输入或关闭对话框。
用法
InputDialog 提示用户输入,例如文本、数字或其他数据。由于对话框是模态的,应用程序在继续之前会等待用户的响应:
显示代码
- Java
类型
输入类型
InputDialog 支持不同类型的输入字段,使您能够根据特定需求量身定制输入方法:
- 文本: 标准单行文本输入。
- 密码: 一个密码输入字段,隐藏用户的输入。
- 数字: 一个数字输入字段。
- 电子邮件: 一个用于电子邮件地址的输入字段。
- URL: 一个用于URL的输入字段。
- 搜索: 搜索文本输入字段。
- 日期: 选择日期的输入字段。
- 时间: 选择时间的输入字段。
- 本地日期时间: 选择本地日期和时间的输入字段。
- 颜色: 选择颜色的输入字段。
消息类型
InputDialog 支持 以下消息类型。当您配置一种类型时,对话框会在消息旁边显示一个图标,并且对话框的主题会根据 webforJ 设计系统规则进行更新。
普通: 不带图标地显示消息,使用默认主题。错误: 在消息旁边显示错误图标,并应用错误主题。问题: 在消息旁边显示问号图标,使用主要主题。警告: 在消息旁边显示警告图标,并应用警告主题。信息: 在消息旁边显示信息图标,使用信息主题。
在以下示例中,系统提示用户输入密码以访问应用程序。如果登录失败,用户将再次被提示。
显示代码
- Java
结果
InputDialog 将用户的输入返回为字符串。如果用户在没有提供输入的情况下关闭对话框,则结果将为 null。
important
返回的字符串将从 show() 方法或等效的 OptionDialog 方法中返回,如下所示。
String result = OptionDialog.showInputDialog(
"请输入您的年龄:", "年龄输入", "", InputDialog.InputType.NUMBER);
if (result != null) {
OptionDialog.showMessageDialog("您输入的年龄是: " + result, "输入已接收");
} else {
OptionDialog.showMessageDialog("未接收到输入", "输入已取消");
}
默认值
InputDialog 允许您指定一个默认值,该默认值在对话框显示时出现在输入字段中。这可以为用户提供建议或先前输入的值。
InputDialog dialog = new InputDialog(
"请输入您的姓名:", "姓名输入", "John Doe", InputDialog.InputType.TEXT);
String result = dialog.show();
超时
InputDialog 允许您设置超时持续时间,超时后对话框会自动关闭。此功能适用于非关键输入请求或不需要用户立即交互的操作。
您可以使用 setTimeout(int timeout) 方法为对话框配置超时。超时时间以秒为单位。如果在指定时间内没有用户交互,则对话框会自动关闭。
InputDialog dialog = new InputDialog(
"请输入您 的姓名:", "姓名输入", "John Doe");
dialog.setTimeout(5);
String result = dialog.show();
OptionDialog.showMessageDialog(
"您输入的姓名是: " + result, "输入已接收", "确定", MessageDialog.MessageType.INFO);
最佳实践
- 清晰简洁的提示: 确保提示消息清楚地说明用户需要提供什么信息。
- 适当的输入类型: 选择与所需数据匹配的输入类型,以确保用户输入准确且相关。
- 合乎逻辑的默认值: 设置提供有用建议或先前输入的默认值,以简化用户输入。
- 谨慎使用超时: 为非关键输入请求设置超时,确保用户有足够时间提供所需信息。
- 减少过度使用: 谨慎使用输入对话框,以避免用户沮丧。仅在需要特定用户输入的操作中使用它们。