jquery.pyproxy 0.5

安装

将jquery.pyproxy添加到buildout egs并运行buildout，如果 不要使用buildout，您可以轻松地安装jquery.pyproxy（或者 通常与其他产品一起使用）。

在plone中，转到quickinstaller并安装jquery.pyproxy。那是 所有，快乐的plone用户现在可以跳到"简单示例"。

在django中，您还应该将django appmedia添加到构建鸡蛋中 以及appmedia的已安装应用程序列表。先建完，然后跑 Bin/Django SymlinkMedia公司。 现在在您的模板中，添加：

<script type="text/javascript" src="{{MEDIA_URL}}/pyproxy/jquery.pyproxy.min.js"></script>

如果希望在请求 完成后，您还可以添加标题：

<script type="text/javascript" src="{{MEDIA_URL}}/pyproxy/jquery.pyproxy.spinner.min.js"></script>
<link rel="stylesheet" href="{{MEDIA_URL}}/pyproxy/jquery.pyproxy.spinner.css" type="text/css" media="screen">

您需要在 网站。如果不是（或者如果您的媒体文件托管在不同的 子域），您应该声明一个名为 指向文件url的pyproxy微调器位置。这个 声明应在包含 jquery.pyproxy.spinner.js 文件。

如果不想使用app_media，可以下载javascript 来自github的库 （ https://github.com/vincent psarga/jquery.pyproxy/blob/master/jquery/pyproxy/media/jquery.pyproxy.min.js -请确保匹配egg版本和js版本）并安装 放到你的媒体文件夹里。然后你可以把它包含到你的 模板。

简单示例

一个简单的例子应该更容易解释背后的想法 jquery.pyproxy。您不希望用户必须重新加载整个页面 向博客提交评论时，将使用ajax调用。 下面是使用jquery.pyproxy执行此操作的方法。

首先，创建一个视图来管理用户发送的信息 （这里是django，但原理与plone相同）：

from jquery.pyproxy.jq_django import JQueryProxy, jquery

# The @jquery decorator handles the transformation of your results
# into JSON so we can decode it on client side.

@jquery
def ajax_add_comment(request):
    # The JQuery proxy object helps us to manipulate the page the user sees.
    jq = JQueryProxy()
    # The data/form sent with Ajax just apear like a classical POST form.
    form = request.POST

    #we do some validation of the form.
    ...

    if errors:
        # We display an error message.
        jq('#my_error_message').show()
        return jq
    ...
    # We display a success message.
    jq('#my_success_message').show()

    # If the JQueryProxy object is not returned, nothing happens.
    return jq

最后，将jquery.pyproxy操作绑定到按钮 用于提交表单：

$(document).ready(function() {
  $('#submit_comment').pyproxy('click',
                               '/ajax_add_comment',
                               '#comment_form');
});

使用jQueryProxy对象

首先，您需要导入正确的jqueryproxy对象：

• 如果使用plone:from jquery.pyproxy.plone import jqueryproxy
• 如果使用django:from jquery.pyproxy.jq_django import jqueryproxy

两者都基于相同的对象，在base.py模块中定义：

>>> from jquery.pyproxy.base import JQueryProxy

这个项目背后的主要思想是能够使用相同的 语法比jquery好，所以您可以或多或少地复制粘贴一些 web上的示例或一些现有代码。 当然，由于我们使用的是python，因此不能将美元符号用作 标识符：

>>> $ = JQueryPyproxy()
Traceback (most recent call last):
...
SyntaxError: invalid syntax

因此，在我们的示例中，我们将对象声明为 jq ，这是经典的 plone命名jquery对象的方式：

>>> jq = JQueryProxy()

目前，jqueryproxy支持jquery 1.4的所有操作api 效果api。

>>> sorted(jq.grammar.keys())
['addClass', 'after', 'animate', 'append', 'appendTo',
 'attr', 'before', 'css', 'detach', 'empty', 'fadeIn',
 'fadeOut', 'fadeTo', 'find', 'hide', 'html', 'insertAfter',
 'insertBefore', 'parent', 'prepend', 'prependTo', 'remove',
 'removeAttr', 'removeClass', 'replaceAll', 'replaceWith',
 'show', 'slideDown', 'slideToggle', 'slideUp', 'text',
 'toggle', 'toggleClass', 'unwrap', 'wrap', 'wrapAll', 'wrapInner']

所以如果你知道如何在jquery中使用它们，你就知道如何使用它们 使用pyproxy，例如：

>>> jq('#error_msg').html('Errors have been found, please correct them')
>>> jq('#error_email').show()

jquery方法的声明方式与 jquery（除了回调之外，请参阅"限制"部分）。所以如果 如果使用不正确的参数，则python代码中会出现错误 （这在调试时应该有很大帮助，至少应该有 服务器日志）：

<script type="text/javascript" src="{{MEDIA_URL}}/pyproxy/jquery.pyproxy.min.js"></script>

如果你需要处理选择器，您可以使用 批处理 jQueryObject的方法。它需要五个参数：

<script type="text/javascript" src="{{MEDIA_URL}}/pyproxy/jquery.pyproxy.min.js"></script>

<script type="text/javascript" src="{{MEDIA_URL}}/pyproxy/jquery.pyproxy.min.js"></script>

<script type="text/javascript" src="{{MEDIA_URL}}/pyproxy/jquery.pyproxy.min.js"></script>

<script type="text/javascript" src="{{MEDIA_URL}}/pyproxy/jquery.pyproxy.min.js"></script>