shane / jquery-bundle
jQuery 的简易版本管理和 Twig 支持
Requires
- guzzlehttp/guzzle: 4.0.x
- symfony/console: 2.4.x
- symfony/framework-bundle: ~2.3
Requires (Dev)
- mockery/mockery: 0.9.x
This package is not auto-updated.
Last update: 2024-09-24 05:31:03 UTC
README
指定您想要的 jQuery 版本,并由包处理获取它并显示压缩版或开发版本。
您可能想查看 bower,看看它是否比此包更适合您的需求。
通过 Composer 安装
使用 composer 获取此包的最佳方式。
{ "require": { "guzzlehttp/guzzle": "~4.0" } }
然后注册您的 app/AppKernel.php
中的包。
public function registerBundles() { $bundles = array( // .., new Shane\JqueryBundle\ShaneJqueryBundle(), ); }
为了使 twig 文件能够工作,您需要允许它们访问 assetic。您可以通过在 app/config/config.yml
中的 assetic.bundles
配置中添加 ShaneJqueryBundle
来实现这一点。
使用方法
更改版本
默认情况下,您将获得 jQuery 版本 2.1.0(撰写时的最新稳定版本),但您可以通过在 app/config/config.yml
中设置它来更改您想要获取的版本。
shane_jquery: version: 1.9.1
此版本号需要看起来像 jQuery 下载 URL 中的那样:"X.Y.Z"。版本号没有复杂的设置,所以没有通配符。它只是一个被放入 URL 的字符串。
下载 jQuery
下载您想要的 jQuery 版本不是自动的;您需要运行一个命令来下载它。
app/console jquery:download
输出到 twig
下载了两个 jQuery 文件:压缩版和开发版本。您可以使用简写语法 "@ShaneJqueryBundle/Resources/public/js/jquery.js" 或 "jquery.min.js"(用于压缩版)来访问这些文件。
如果您喜欢,可以将这些文件路径放入 {% javascripts %}
中。这将为您在文件上运行过滤器提供灵活性。
然而,建议您直接输出包含的 twig 文件,它将根据开发或生产环境决定显示哪个文件。
{% include 'ShaneJqueryBundle::jquery.html.twig' %}
贡献
如果您正在使用此包,那么您可能想查看这个项目的 issue。由于这是一个我迅速拼凑的包,所以有一些 issue。