支持String-、Lines-和ReferenceFields的Archetypes自动完成小部件
项目描述
概述
要使用此包，只需创建一个字段，例如
StringField('test_field',
default='',
searchable=0,
required=0,
vocabulary=DisplayList((('week', 'Week'), ('wedding','Wedding'),
('winona','Winona'), ('winter', 'Winter'),
('weather','Weather'), ('cow', 'Cow'))),
widget=AutocompleteWidget(label='Test Widget',
description='Test this',
),
enforceVocabulary=0,
),
您还可以使用LinesField代替StringField。小部件会自动适配。这有一个优点，即您可以在目录中索引字段（关键字索引）。结合小部件上的filter_bogus属性，小部件将准备输入的值。
没有词汇表就毫无用处，除非您使用LinesField，将enforceVocabulary设置为true实际上没有意义。
配置
有几个参数可以设置，以改变小部件的行为
- actb_timeout
自动完成框超时并消失前的时间（毫秒）。(默认：2500，-1表示禁用)
- actb_lim
每次在自动完成框中显示多少个选项。(默认：5)
- actb_firsttext
自动完成搜索是否应限制在关键字的开头（True），还是应在整个条目中搜索匹配（False）？(默认：0)
- actb_filter_bogus
删除不在词汇表中的关键字，并删除冗余关键字、前后空格等。
- actb_expand_onfocus
在获得焦点时展开下拉列表。
- actb_complete_on_tab
如果要将Tab键移动到下一个小部件，请设置为0。默认为1。
致谢
使用的JavaScript基于zichun在http://codeproject.com/jscript/jsactb.asp上的小部件，并经许可使用。
由Quadra Informatique <plone at quadra-informatique dot fr>启动的《improved_multivalued_fields_management》分支已成为此包的新主干。
感谢所有贡献者（姓名列于更改）。
更改
1.5.0 (2016-03-21)
使用png图标代替gif图标（与Plone 4.3兼容）。[thomasdesvenain]
我们可以将小部件上的一个参数设置为false：actb_multivalued_adding_is_required，这样如果用户未点击多值字段上的“添加”按钮，则当前输入被视为新值。当词汇表没有被强制执行时，这改善了用户体验。[thomasdesvenain]
在site_properties中添加了一个属性，用于定义自定义分隔符。“，”被设置为默认分隔符。“;”始终是分隔符。[thomasdesvenain]
已修复：默认sunburst主题下不可用。[thomasdesvenain]
默认情况下，将行字段视为多值字段。[thomasdesvenain]
1.4.0 (2011-10-24)
从主干合并，保留修复和功能[Quadra Informatique - jriboux]
从1.0原始主干
修复了safari键盘问题。添加了单选选项[dannyb]
更新为使用通用设置配置文件进行安装[wichert]
更改模板以使用基于div的下拉列表，提供合理的滚动体验[dannyb]
1.3 (15-03-2010)
添加了隐藏清除按钮的可能性
修复了一个错误，在多值字段为空时显示（）
添加了对参考字段的兼容性
对一些检查进行了泛化，使其与ReferenceFields兼容[davisagli]
内联筛选函数并使用范围而不是方法调用。字段词汇表被调用以针对每个存储在字段中的术语，关键字_from_value方法现在不再使用。也进行了通用的空白清理。(runyaga)
tabindex不再适用于archetypes小部件，并在plone4中破坏了编辑视图 - 修复http://plone.org/products/autocompletewidget/issues/5 (fRiSI)
将产品egg化(fRiSi)
将history.txt和HISTORY.txt合并到CHANGES.txt
将问题编号#3（与主干合并）添加到todo.txt
删除refres.txt，因为它不再受支持
使小部件与非ASCII字符的词汇表也能正常工作(fRiSi)
2008-03-14 - v1.2.1 : Quadra Informatique - Jonathan Riboux
集成了Ak Sorpa的修复，以防止在从下拉列表中选择值后在输入框中显示 &、< 和 >。
2008-03-12 - v1.2 : Quadra Informatique - Jonathan Riboux
更正了i18n属性，以便AutocompleteWidget可以用英语使用。
添加了工具提示和按钮标签
外观改进
为按钮添加了CSS类
2008-02-25 - v1.1 : Quadra Informatique - Nicolas Geissel
使用fieldName变量而不是field.getName以获得更好的灵活性（小部件现在可以用作搜索小部件）[thomasdesvenain]
添加了i18n
2008-02-07 - v1.0 : Quadra Informatique - Jonathan Riboux
改进了显示列表支持（显示值，但注册键）
对于多值字段，小部件在输入字段旁边显示当前值的列表。
菜单中的箭头导航现在在Internet Explorer上正常工作
清理了process_form代码
2005-02-09: Danny Bloemendaal
ESC显示下拉列表
onblur现在工作并隐藏列表
添加了在焦点时展开列表的属性
将filter_bogus重命名为actb_filter_bogus以保持命名一致性
2005-02-08: Danny Bloemendaal
将javascript工厂替换为原作者的最新版本
重新设计了样式，使小部件更接近标准小部件格式
移除了导致不良UI行为的某些配置项
添加了对LinesField的支持，以便字段现在可以正确索引
Products.AutocompleteWidget-1.5.0.tar.gz的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 3b909b8d9354cabe9ab0f7671975e01f84ff1d87f20469f99a1c05fce8b8574d |
|
| MD5 | 6e5c89ecc44615a8945b085df070c306 |
|
| BLAKE2b-256 | bc509f47332ab3941667cd2b561bc0e9b8dd86cc4782020c87e3c5638fa6b8c6 |