gocept.autocomplete 0.7

自动完成小部件

autocomplete为z3c.form提供了一个自动完成小部件。 如果您希望向用户提供建议列表，则该小部件非常有用 对于一个字段，但仍然希望接受输入的任何其他内容。

要使用小部件，请<；include package=“gocept.autocomplete”>；并提供 实现gocept.autocomplete.interfaces.isearchablesource的源代码。 这意味着两件事，一是源代码必须提供一个search（）方法，以便 查询值（包括查询时输入的值）和 第二，必须始终从包含的方法返回true，以便 用户可以自由输入不属于建议的值。

无需进一步配置，小部件将自动注册 所有带有isearchablesource的字段。

例如，我们使用 测试浏览器：

>>> import zope.app.testing.functional
>>> root = zope.app.testing.functional.getRootFolder()
>>> import gocept.autocomplete.tests.color
>>> house = gocept.autocomplete.tests.color.House()
>>> root['house'] = house

>>> import zope.testbrowser.testing
>>> b = zope.testbrowser.testing.Browser()
>>> b.handleErrors = False

AutoCompleteWidget是一个增强的文本小部件。因此，在显示模式下， 行为就像一个文本小部件：

>>> b.open('http://localhost/house')
>>> print b.contents
<?xml...
...<span id="form-widgets-color" class="text-widget autocomplete required choice-field"></span>...

但在编辑模式下，它会生成额外的javascript代码：

>>> b.addHeader('Authorization', 'Basic mgr:mgrpw')
>>> b.open('http://localhost/house')
>>> print b.contents
<?xml...
...<script src=".../autocomplete-min.js"...
...<input id="form-widgets-color"...
...<div id="form-widgets-color-container"...
...DS_XHR("http://localhost/house/@@index.html/++widget++color/@@autocomplete-search"...
...new YAHOO.widget.AutoComplete( "form-widgets-color", "form-widgets-color-container"...

通过在小部件上注册的视图填充自动完成功能：

>>> b.open('http://localhost/house/@@index.html/++widget++color/@@autocomplete-search')
>>> print b.contents
>>> b.open('http://localhost/house/@@index.html/++widget++color/@@autocomplete-search?q=r')
>>> print b.contents
red
ruby

但是我们仍然可以输入任何想要的值并保存它（有两部分 要使其工作，一个是源必须始终在其 _包含的方法，另一个是小部件使用 titledTokenIzedTerm，它使用所有内容的实际值）：

>>> b.open('http://localhost/house')
>>> b.getControl('Color').value = 'foo'
>>> b.getControl(name='form.buttons.apply').click()
>>> print b.contents
<?xml...
...foo...

分组窗体

特殊情况是组表单，它们在 他们的团体。为了这个特殊的场合，我们设置了一个 ApartmentGroup和表单：

>>> apartment = gocept.autocomplete.tests.color.Apartment()
>>> root['apartment'] = apartment

分组表单的小部件遍历返回正确的搜索 结果：

>>> b.open('http://localhost/apartment/@@grouped.html/++widget++color/@@autocomplete-search?q=r')
>>> print b.contents
red
ruby
>>> b.open('http://localhost/apartment/@@grouped.html/++widget++number/@@autocomplete-search?q=1')
>>> print b.contents
12A
12

开发gocept.autocomplete

构建配置

此包附带一个最小的buildout配置，该配置允许运行 测试：

$ python bootstrap.py
$ bin/buildout
$ bin/test

更改