jQuery UI Chinese Reference Manual /自动完成(Autocomplete)

自动完成(Autocomplete)


根据用户输入值进行搜索和过滤,让用户快速找到并从预设值列表中选择。

如需了解更多有关 autocomplete 部件的细节,请查看 API 文档 自动完成部件(Autocomplete Widget)。

默认功能

当您在输入域中输入时,自动完成(Autocomplete)部件提供相应的建议。在本实例中,提供了编程语言的建议选项,您可以输入 "ja" 尝试一下,可以得到 Java 或 JavaScript。

数据源是一个简单的 JavaScript 数组,使用 source 选项提供给部件。

实例

    jQuery UI 自动完成(Autocomplete) - 默认功能      

运行实例 »

点击 "运行实例" 按钮查看在线实例

包含重音

autocomplete 域使用自定义的 source 选项来匹配带有重音字符的结果项,即使文本域不包含重音字符也会匹配。但是如果您在文本域中键入了重音字符,则不会显示非重音的结果项。

尝试键入 "Jo",会看到 "John" 和 "Jörn",然后 键入 "Jö",只会看到 "Jörn"。

实例

    jQuery UI 自动完成(Autocomplete) - 包含重音      

运行实例 »

点击 "运行实例" 按钮查看在线实例

分类

分类的搜索结果。尝试键入 "a" 或 "n"。

实例

    jQuery UI 自动完成(Autocomplete) - 分类        

运行实例 »

点击 "运行实例" 按钮查看在线实例

组合框(Combobox)

一个由 Autocomplete 和 Button 创建的自定义部件。您可以键入一些字符,来获得基于您的输入过滤的结果,或者使用按钮从完整列表中选择。

该输入是从一个已有的 select 元素中读取,传递给带有自定义的 source 选项的 Autocomplete。

这是一个不被支持的不完美的部件。这里纯粹是为了演示 autocomplete 定制功能。如需了解更多有关该部件工作原理的细节,请点击这里查看相关的 jQuery 文章。

实例

    jQuery UI 自动完成(Autocomplete) - 组合框(Combobox)       

运行实例 »

点击 "运行实例" 按钮查看在线实例

自定义数据并显示

您可以使用自定义数据格式,并通过简单地重载默认的聚焦和选择行为来显示数据。

尝试键入 "j",或者按向下箭头按键,即可得到一个项目列表。

实例

    jQuery UI 自动完成(Autocomplete) - 自定义数据并显示       
选择一个项目(请键入 "j"):


运行实例 »

点击 "运行实例" 按钮查看在线实例

多个值

用法:键入一些字符,比如 "j",可以看到相关的编程语言结果。选择一个值,然后继续键入字符来添加其他的值。

本实例演示如何使用 source 选项和一些事件来实现在一个单一的文本域输入多个自动完成的值。

实例

    jQuery UI 自动完成(Autocomplete) - 多个值      

运行实例 »

点击 "运行实例" 按钮查看在线实例

多个值,远程

用法:键入至少两个字符来获取鸟的名称。选择一个值,然后继续键入字符来添加其他的值。

本实例演示如何使用 source 选项和一些事件来实现在一个单一的文本域输入多个自动完成的值。

实例

    jQuery UI 自动完成(Autocomplete) - 多个值,远程       

运行实例 »

点击 "运行实例" 按钮查看在线实例

远程 JSONP 数据源

当您在文本域中键入字符时,Autocomplete 部件给出建议结果。在本实例中,当您在文本域中至少键入两个字符时,将显示相关城市的名称。

在本实例中,数据源是 geonames.org webservice。虽然选择一个元素后文本域中是该城市名称,但是会显示更多的信息以便找到正确的条目。数据也可以回调,显示在下面的结果框中。

实例

    jQuery UI 自动完成(Autocomplete) - 远程 JSONP 数据源       
Powered by geonames.org
结果:

运行实例 »

点击 "运行实例" 按钮查看在线实例

远程数据源

当您在文本域中键入字符时,Autocomplete 部件给出建议结果。在本实例中,当您在文本域中至少键入两个字符时,将显示相关鸟的名称。

在本实例中,数据源是可返回 JSON 数据的服务器端脚本,通过一个简单的 source 选项来指定。另外,minLength 选项设置为 2,避免查询返回太多的结果,select 事件用于显示一些反馈。

实例

    jQuery UI 自动完成(Autocomplete) - 远程数据源       
结果:

运行实例 »

点击 "运行实例" 按钮查看在线实例

远程缓存

当您在文本域中键入字符时,Autocomplete 部件给出建议结果。在本实例中,当您在文本域中至少键入两个字符时,将显示相关鸟的名称。

为了提高性能,这里添加了一些本地缓存,其他与远程数据源实例相似。在这里,缓存只保存了一个查询,并可以扩展到缓存多个值,每个条目一个值。

实例

    jQuery UI 自动完成(Autocomplete) - 远程缓存       

运行实例 »

点击 "运行实例" 按钮查看在线实例

可滚动的结果

当显示一个长列表的选项时,您可以简单地为 autocomplete 菜单设置 max-height 来防止菜单显示太长。尝试键入 "a" 或 "s" 来获得一个可滚动的长列表的结果。

实例

    jQuery UI 自动完成(Autocomplete) - 可滚动的结果       

运行实例 »

点击 "运行实例" 按钮查看在线实例

XML 数据

本实例演示如何获取一些 XML 数据,并使用 jQuery 的方法解析它,然后把它提供给 autocomplete 作为数据源。

本实例也可作为解析远程 XML 数据源的参考 - 解析在每次 source 回调请求时发生。

实例

    jQuery UI 自动完成(Autocomplete) - XML 数据       
结果:

运行实例 »

点击 "运行实例" 按钮查看在线实例