`
a137268431
  • 浏览: 157592 次
文章分类
社区版块
存档分类
最新评论

让JTextField添加“自动完成”功能

 
阅读更多
在越来越重视“用户体验”的今天,一个简单的文本框也演进的越来越智能了。比如Google的搜索,当我们输入搜索关键字的过程中,文本框就会动态的下拉列出最常输入的近似文字,以便我们快速输入要查询的内容。当然一直抄袭Google的百度自然也是一样。类似的例子还有很多,例如一般的邮件客户端,在敲入地址时,也会动态列出符合要求的地址,方便快速录入,也会减少出错。


那么,Swing的文本框要做到这一点是否容易呢?网上的例子也能搜索到一些,不过要么功能做的太简单,要么实现的代码太繁琐罗嗦。还有一些商业的Swing组件,则完全是要付费的。本文结合了2BizBox免费ERP软件开发中的实践,尝试了一种非常简单、有效的方法来制作这一效果。

首先仔细观察这种效果:它外观上、本质上,都完全是一个文本框,而不是下拉框。所以,我们不想把它做成下拉框,也就是不想从JComboBox继承。另外,下拉列表提示的出现,是完全异步、动态的,它仅仅作为提示,不能干预正常的文本框的输入。最后,那个下拉列表的外观和行为则完全是一个JComboBox的下拉列表行为。所以,这个“可自动完成的JTextField”应当是一个JTextField和JComboBox下拉列表部分的结合体。
经过以上分析,思路基本确定:它本质是一个JTextField,但是又结合利用了一个JComboBox的下拉列表。二者合而为一即可。那么是从谁继承呢?JTextField吗?
仔细想想,继承并不是最好的方法。俗话说:继承是混蛋。能不继承就不要继承。为啥呢?继承,意味着别人只能继承你的类,才能使用这一功能。假如你的项目已经写了一万多个界面,想给这里面的一些文本框增加这种智能提示功能,难道要对所有代码进行修改,让那些东西重新继承你的类吗?这无疑是个烂主意。所以,那些刚学会OO的童鞋,总是喜欢动不动就要继承的思路,并不妥当。如果我们只是提供一个Util方法,对已经存在的普通JTextField实例处理一下,就可以具有智能提示,岂不是更好?
要做到JTextField和JComboBox这两个组件的结合,这里使用了非常“怪异”的一个绝招,你绝对想不到:把一个JComboBox塞到JTextField的身体里面,并让它看不见。看一下代码:
1JTextFieldtxtInput=newJTextField();
2JComboBoxcbInput=newJComboBox();
3txtInput.setLayout(newBorderLayout());
4txtInput.add(cbInput,BorderLayout.SOUTH);

什么?把JTextField设置一个layout?并且还add一个JComboBox且放在SOUTH?我相信你绝对闻所未闻这种事情。怎么看都是怪胎啊。不要紧,把JComboBox的高度变成0,别人就看不出破绽了:
1JComboBoxcbInput=newJComboBox(model){
2publicDimensiongetPreferredSize(){
3returnnewDimension(super.getPreferredSize().width,0);
4}
5};

虽然combo看不见,但是它实实在在存在于文本框的身体里,且位于其下方。我们的思路是:当文本框输入内容时,我们判断下拉框中是否有符合要求的列表,如果有,就马上主动弹出下拉;否则就让下拉消失。
监控文本框输入并不难:给它的document增加listener就行了。这里我们使用了“不区分大小写”、“和输入字符串开头相同的项”的规则进行过滤。将所有备选字符串置于单独一个数组中,每次用户输入后,动态过滤出符合条件的字符串,动态添加到JComboBox中,并将其下拉列表Popup出来即可:
1txtInput.getDocument().addDocumentListener(newDocumentListener(){
2publicvoidinsertUpdate(DocumentEvente){
3updateList();
4}
5
6publicvoidremoveUpdate(DocumentEvente){
7updateList();
8}
9
10publicvoidchangedUpdate(DocumentEvente){
11updateList();
12}
13
14privatevoidupdateList(){
15setAdjusting(cbInput,true);
16model.removeAllElements();
17Stringinput=txtInput.getText();
18if(!input.isEmpty()){
19for(Stringitem:items){
20if(item.toLowerCase().startsWith(input.toLowerCase())){
21model.addElement(item);
22}
23}
24}
25cbInput.setPopupVisible(model.getSize()>0);
26setAdjusting(cbInput,false);
27}
28});

此外,为了更方便操作,我们再增加几个快捷键:当输入ESC,主动关掉下拉列表;当输入回车或空格,直接把第一项符合要求的字符串输入文本框:
1txtInput.addKeyListener(newKeyAdapter(){
2
3@Override
4publicvoidkeyPressed(KeyEvente){
5setAdjusting(cbInput,true);
6if(e.getKeyCode()==KeyEvent.VK_SPACE){
7if(cbInput.isPopupVisible()){
8e.setKeyCode(KeyEvent.VK_ENTER);
9}
10}
11if(e.getKeyCode()==KeyEvent.VK_ENTER||e.getKeyCode()==KeyEvent.VK_UP||e.getKeyCode()==KeyEvent.VK_DOWN){
12e.setSource(cbInput);
13cbInput.dispatchEvent(e);
14if(e.getKeyCode()==KeyEvent.VK_ENTER){
15txtInput.setText(cbInput.getSelectedItem().toString());
16cbInput.setPopupVisible(false);
17}
18}
19if(e.getKeyCode()==KeyEvent.VK_ESCAPE){
20cbInput.setPopupVisible(false);
21}
22setAdjusting(cbInput,false);
23}
24});

还有一个非常重要的技术要点要进行说明。在popup列表弹出的时候,我们希望用箭头能够上下移动选择条目,但是又同时希望当前的光标和焦点不要离开文本框。这个好像非常难实现啊!请看我们是如何做到的:在监控到上下箭头输入时候,把当前的键盘事件的source动态修改为JComboBox,然后派发给JComboBox。也就是说,本来事件是输入到文本框的,我们把邮递员拦截下来,把收件人改一下,继续交给邮递员进行派发。这样,就做到“移花接木”了:
1if(e.getKeyCode()==KeyEvent.VK_ENTER||e.getKeyCode()==KeyEvent.VK_UP||e.getKeyCode()==KeyEvent.VK_DOWN){
2e.setSource(cbInput);
3cbInput.dispatchEvent(e);
4if(e.getKeyCode()==KeyEvent.VK_ENTER){
5txtInput.setText(cbInput.getSelectedItem().toString());
6cbInput.setPopupVisible(false);
7}
8}

最后,为了演示效果,我们放一些数据到下拉列表中。放什么呢?自己造假数据太麻烦了,干脆用Java中的“所有国家”的数据吧,简单省事:
1Locale[]locales=Locale.getAvailableLocales();
2for(inti=0;i<locales.length;i++){
3Stringitem=locales[i].getDisplayName();
4items.add(item);
5}

最后看一下效果,完全符合我们的预期:
以下是完整代码:
1importjava.awt.*;
2importjava.awt.event.*;
3importjava.util.*;
4
5importjavax.swing.*;
6importjavax.swing.event.*;
7
8importtwaver.*;
9
10publicclassTest{
11
12publicstaticvoidmain(String[]args)throwsException{
13UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
14JFrameframe=newJFrame();
15frame.setTitle("AutoCompletionTest");
16frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
17frame.setBounds(200,200,500,400);
18
19ArrayList<String>items=newArrayList<String>();
20Locale[]locales=Locale.getAvailableLocales();
21for(inti=0;i<locales.length;i++){
22Stringitem=locales[i].getDisplayName();
23items.add(item);
24}
25JTextFieldtxtInput=newJTextField();
26setupAutoComplete(txtInput,items);
27txtInput.setColumns(30);
28frame.getContentPane().setLayout(newFlowLayout());
29frame.getContentPane().add(txtInput,BorderLayout.NORTH);
30frame.setVisible(true);
31}
32
33privatestaticbooleanisAdjusting(JComboBoxcbInput){
34if(cbInput.getClientProperty("is_adjusting")instanceofBoolean){
35return(Boolean)cbInput.getClientProperty("is_adjusting");
36}
37returnfalse;
38}
39
40privatestaticvoidsetAdjusting(JComboBoxcbInput,booleanadjusting){
41cbInput.putClientProperty("is_adjusting",adjusting);
42}
43
44publicstaticvoidsetupAutoComplete(finalJTextFieldtxtInput,finalArrayList<String>items){
45finalDefaultComboBoxModelmodel=newDefaultComboBoxModel();
46finalJComboBoxcbInput=newJComboBox(model){
47publicDimensiongetPreferredSize(){
48returnnewDimension(super.getPreferredSize().width,0);
49}
50};
51setAdjusting(cbInput,false);
52for(Stringitem:items){
53model.addElement(item);
54}
55cbInput.setSelectedItem(null);
56cbInput.addActionListener(newActionListener(){
57@Override
58publicvoidactionPerformed(ActionEvente){
59if(!isAdjusting(cbInput)){
60if(cbInput.getSelectedItem()!=null){
61txtInput.setText(cbInput.getSelectedItem().toString());
62}
63}
64}
65});
66
67txtInput.addKeyListener(newKeyAdapter(){
68
69@Override
70publicvoidkeyPressed(KeyEvente){
71setAdjusting(cbInput,true);
72if(e.getKeyCode()==KeyEvent.VK_SPACE){
73if(cbInput.isPopupVisible()){
74e.setKeyCode(KeyEvent.VK_ENTER);
75}
76}
77if(e.getKeyCode()==KeyEvent.VK_ENTER||e.getKeyCode()==KeyEvent.VK_UP||e.getKeyCode()==KeyEvent.VK_DOWN){
78e.setSource(cbInput);
79cbInput.dispatchEvent(e);
80if(e.getKeyCode()==KeyEvent.VK_ENTER){
81txtInput.setText(cbInput.getSelectedItem().toString());
82cbInput.setPopupVisible(false);
83}
84}
85if(e.getKeyCode()==KeyEvent.VK_ESCAPE){
86cbInput.setPopupVisible(false);
87}
88setAdjusting(cbInput,false);
89}
90});
91txtInput.getDocument().addDocumentListener(newDocumentListener(){
92publicvoidinsertUpdate(DocumentEvente){
93updateList();
94}
95
96publicvoidremoveUpdate(DocumentEvente){
97updateList();
98}
99
100publicvoidchangedUpdate(DocumentEvente){
101updateList();
102}
103
104privatevoidupdateList(){
105setAdjusting(cbInput,true);
106model.removeAllElements();
107Stringinput=txtInput.getText();
108if(!input.isEmpty()){
109for(Stringitem:items){
110if(item.toLowerCase().startsWith(input.toLowerCase())){
111model.addElement(item);
112}
113}
114}
115cbInput.setPopupVisible(model.getSize()>0);
116setAdjusting(cbInput,false);
117}
118});
119txtInput.setLayout(newBorderLayout());
120txtInput.add(cbInput,BorderLayout.SOUTH);
121}
122}
分享到:
评论

相关推荐

    JTextField添加“自动完成”

    在Java Swing应用中,为了提升用户体验,经常需要为`JTextField`添加“自动完成”(Auto-Completion)功能。这个功能允许用户在输入文本时,系统能够自动匹配并显示可能的建议,类似于搜索引擎或邮件客户端的地址...

    AutoText:Java Swing 库,允许将自动完成的可能性添加到文本组件(JTextComponent - JTextField - JFormattedTextField 等)

    通过集成AutoText库,开发者可以让JTextField具备自动完成的功能。 3. **JFormattedTextField**: 这个组件在JTextField的基础上增加了对输入格式的控制,比如日期、数字等。AutoText库的集成使得用户在输入格式化...

    swing效果点击下拉框自动填充文本框

    在Java的Swing库中,实现“点击下拉框自动填充文本框”的功能,涉及到Swing组件的交互、事件监听以及数据绑定的概念。这个功能在许多GUI应用中都非常常见,例如用户选择一个选项后,相应的文本框会自动更新为所选...

    netbean的使用方法

    - 单击“完成”后,IDE会在GUI Builder中自动创建一个`NumberAdditionUI`窗体。 - 接下来需要在窗体中添加组件: - 从“组件面板”中拖拽一个JPanel到JFrame中。 - 为JPanel设置标题,例如“Number Addition”。 ...

    酒店管理系统实现代码.pdf

    同时,还创建了对应的`JTextField`对象,让用户可以输入这些信息。例如,`nameField`用于输入客户姓名,`idtifyField`用于输入身份证号,`roomField`用于输入房号,`moneyField`用于输入应付金额。 `...

    韩顺平学生管理系统源代码

    完成后,系统会自动更新表格中的数据。 - **修改功能**:选择表格中的一行后点击“修改”按钮,同样会弹出一个对话框让用户修改选中行的信息。修改完成后,表格数据也会随之更新。 - **删除功能**:用户可以选择表格...

    Swing做的高仿QQ登陆界面

    最后,项目提供的"可运行jar文件"表明,开发者已经将程序打包成可独立运行的Java应用程序,这通常通过使用jar命令或集成开发环境(IDE)的打包功能完成。用户只需双击jar文件,无需安装任何额外的环境,就能启动这个...

    Java Swing例题

    它属于Java Foundation Classes (JFC) 的一部分,提供了丰富的组件库,让开发者能够创建出功能完备、交互性强的用户界面。本例题“Java Swing例题”旨在通过一个具体的实例来深入理解和实践Swing的相关知识。 在...

    java swing计算器程序idea编程环境

    至于IntelliJ IDEA,它是JetBrains公司推出的Java开发工具,具有代码提示、自动完成、重构等多种功能,极大地提高了开发效率。在IDEA中,我们可以方便地创建Swing项目,添加所需的库,以及组织和管理源代码。 总的...

    java-课程设计-超市管理系统-报告含代码.pdf

    - 系统使用Java Swing库创建GUI组件,如JFrame、JButton、JTextField等,不少于5种,确保界面直观且功能丰富。主窗口由EventDemo类负责,提供了“物品消费”、“会员添加”、“会员信息”和“账务管理”四个主要...

    gui登陆界面

    【GUI登录界面】是计算机应用中的一个重要组成部分,它为用户提供了一个友好的图形化交互方式来登录系统或应用程序。...同时,为了提高用户体验,还可以考虑添加错误提示、记住密码、自动填充等功能。

    南邮Java实验报告1-综合图形界面程序设计.doc

    - 使用JTextField让用户输入金额。 - 使用JComboBox提供货币种类的选择。 - 使用JButton实现货币兑换的功能和清除输入的操作。 #### 实验关键代码解析 下面是部分关键代码的解析: ```java public class ...

    Java仿Vista界面风格的登录窗口.zip

    为了增强用户体验,可以添加一些额外的功能,比如错误提示(如果输入无效或登录失败)、记住密码选项、自动填充用户名等功能。这通常涉及到更多的Swing组件,如JCheckBox和JOptionPane,以及对用户输入的处理逻辑。 ...

    Java开发之使用Myeclipse SwingMatisse开发swing程序

    在Java开发领域,Swing库提供了丰富的组件和功能,用于构建桌面应用程序的用户界面。...无论你是初学者还是经验丰富的开发者,SwingMatisse都能提高你的开发效率,让创建美观且功能丰富的Java桌面应用变得更加轻松。

    Java程序设计大作业题目与要求.docx

    3. **弹出备忘功能**:用户能够通过图形化界面添加特定日期的备忘录,这些备忘应在对应日期上显示或提醒。 4. **程序运行与退出**:保证程序能够稳定运行,同时提供一个明确的退出选项,让使用者能够安全地关闭程序...

    基于Java+Swing实现计算器

    完成初步实现后,进行单元测试确保每个功能都能正常工作。使用JUnit等测试框架可以帮助自动化测试过程。同时,使用调试工具进行问题定位,确保程序的稳定运行。 总的来说,实现“基于Java+Swing实现计算器”的项目...

    在线考试系统 考务管理 swing java 源代码

    4. **自动组卷**:系统应具备智能组卷功能,可以根据预设规则(如试题类型、难度等)随机选取试题生成试卷,确保每次考试的公平性。 5. **在线答题**:考生在规定的考试时间内登录系统,完成选择题、填空题、简答题...

    Java实现文件批量重命名具体实例

    这个实例展示了如何使用Java实现这一功能,让用户能够根据特定的模板一次性重命名大量文件。以下是对这个实例的详细解释: 1. **用户界面**: 用户界面是与用户交互的部分,包括各种组件如JLabel、JTextField、...

    My-calculator.zip_Java编程_Java_

    2. **设计GUI**:在“源代码”视图中,切换到“设计”视图,添加必要的组件,如JButton(表示数字和运算符)和JTextField(显示计算结果)。 3. **绑定事件**:为每个按钮添加事件监听器,这可以通过右键点击组件,...

    java GUI编程

    让我们深入探讨Java GUI编程中的关键知识点,以及如何在实际应用中实现定时关机功能。 1. **Swing和AWT**: Java的GUI库主要由AWT(Abstract Window Toolkit)和Swing两个部分组成。AWT是Java早期的GUI库,它直接...

Global site tag (gtag.js) - Google Analytics