README

Helthe TurbolinksBundle 将 Helthe Turbolinks 组件集成到您的 Symfony 应用程序中。

安装

步骤 1：在 Composer 中添加包需求

手动

在您的 composer.json 中添加以下内容：

{
    "require": {
        // ...
        "helthe/turbolinks-bundle": "~1.3"
    }
}

使用命令行

$ composer require 'helthe/turbolinks-bundle=~1.3'

步骤 2：在内核中注册扩展包

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Helthe\Bundle\TurbolinksBundle\HeltheTurbolinksBundle(),
    );
}

步骤 3：添加 Composer 脚本以自动安装资源

{
   "scripts": {
       "post-install-cmd": [
           "Helthe\\Bundle\\TurbolinksBundle\\Composer\\ScriptHandler::installAssets"
       ],
       "post-update-cmd": [
           "Helthe\\Bundle\\TurbolinksBundle\\Composer\\ScriptHandler::installAssets"
       ]
   }
}

使用方法

要开始使用 Turbolinks，您只需将 Turbolinks JavaScript 添加到布局中。

每个脚本的原始 coffeescript 版本和编译版本均可使用。

在布局中插入 JavaScript

直接

<script src="{{ asset('bundles/heltheturbolinks/js/turbolinks.js') }}"></script>

使用 Assetic

{% javascripts '@HeltheTurbolinksBundle/Resources/public/js/turbolinks.js' %}
    <script type="text/javascript" src="{{ asset_url }}"></script>
{% endjavascripts %}

使用 jquery.turbolinks

如果您需要使用 jquery.turbolinks，则需要在 turbolinks.js 之前添加它

兼容性

Turbolinks 设计用于与完全支持 pushState 和所有相关 API 的任何浏览器一起工作。这包括 Safari 6.0+（但不包括 Safari 5.1.x！）、IE10 以及最新的 Chrome 和 Firefox。

请注意，由于实例化周期发生变化，现有的 JavaScript 库可能并非全部与 Turbolinks 兼容。您可能需要修改它们以与 Turbolinks 的新事件集一起工作。有关此方面的帮助，请参阅 Turbolinks 兼容性项目。

附加资源

如果您需要有关 JavaScript 库的更多信息，请参阅 turbolinks 和 jquery.turbolinks 项目。

您可以在 Turbolinks 组件的 文档 中找到更多文档。

错误

有关错误或功能请求，请 创建一个问题。