jquery.widget 0.1.0c1

本软件包包含一组基于jQuery的控件。

* Rest Editor Widget

详细文档
**********************

==================
Rest Editor Widget
==================

jquery.resteditorre软件包提供了一个可以渲染
在测试区域控件上方的工具栏的javascript。此工具栏提供
按钮，可用于将reStructuredText格式化器应用于textarea中的文本。

我们无法在此处展示，因为这全部是用javascript完成的。reStructuredText
编辑器textarea看起来与正常的z3c.form textarea一样。顺便说一下，任何
textarea都可以使用此软件包，无需使用实现的RESTEditorWidget。但不管怎样，
这样的textarea控件看起来像这样

>>> import zope.schema
>>> from z3c.form import widget
>>> from z3c.form import testing
>>> from jquery.widget.resteditor.browser import RESTEditorFieldWidget

我们必须定义一个文本字段和一个测试请求来实例化控件

>>> text = zope.schema.Text(
... title=u'Text',
... description=u'Text field'
... )
>>> widget = RESTEditorFieldWidget(text, testing.TestRequest())
>>> widget
<RESTEditorWidget ''>

在我们渲染控件之前，我们需要注册一个模板。这个模板通常由z3c.form框架
注册。在这里做，因为我们没有使用真实的站点设置。
>>> from zope.configuration import xmlconfig

>>> import zope.component
>>> import z3c.form
>>> xmlconfig.XMLConfig('meta.zcml', zope.component)()
>>> xmlconfig.XMLConfig('meta.zcml', z3c.form)()
>>> xmlconfig.XMLConfig('configure.zcml', z3c.form)()
>>> xmlconfig.XMLConfig('configure.zcml', z3c.form)()

现在我们可以渲染控件了

>>> widget.update()
>>> print widget.render()
<textarea id="" name="" class="restEditorWidget"></textarea>

如你所见，reStructuredText编辑器小部件使用了一个名为
``restEditorWidget``的CSS类。这个类可以用来应用JQuery XPath规则
并加载restEditor方法。

这可以通过以下方式实现：

$('.restEditorWidget').restEditor();

当然，你可以在全局JQuery dom onload事件处理程序调用中这样做。
如果是这样，你可以使用类似以下的方法

$(document).ready(function() {
$('.restEditorWidget').restEditor();
});

注意，还有一个示例位于http://www.z3c.org/samples