Как встроить асинхронное содержание с помощью hinclude.js

Контроллеры могут быть встроены асинхронно, используя библиотеку Java-скрипта hinclude.js_. Так как встроенное содержание поступает с другой страницы (или, если на то пошло, контроллера), Symfony использует версию стандартной функции render(), чтобы сконфигурировать теги hinclude:

Twig
PHP

        1
2
        {{ render_hinclude(controller('...')) }}
{{ render_hinclude(url('...')) }}
    

Note

hinclude.js_ должен быть включён в вашу страницу, чтобы он работад.

Note

При использовании контроллера вместо URL, вы должны активировать конфигурацию Symfony fragments:

YAML
XML
PHP

        1
2
3
4
        # app/config/config.yml
framework:
    # ...
    fragments: { path: /_fragment }
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
        <!-- app/config/config.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <!-- ... -->
    <framework:config>
        <framework:fragment path="/_fragment" />
    </framework:config>
</container>
    

        1
2
3
4
5
        // app/config/config.php
$container->loadFromExtension('framework', array(
    // ...
    'fragments' => array('path' => '/_fragment'),
));
    

Содержание по умолчанию (во время загрузки или если Java-скрипт отключен) может быть установлено глобально в конфигурации вашего приложения:

YAML
XML
PHP

        1
2
3
4
5
        # app/config/config.yml
framework:
    # ...
    templating:
        hinclude_default_template: hinclude.html.twig
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
        <!-- app/config/config.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <!-- ... -->
    <framework:config>
        <framework:templating hinclude-default-template="hinclude.html.twig" />
    </framework:config>
</container>
    

        1
2
3
4
5
6
7
8
9
        // app/config/config.php
$container->loadFromExtension('framework', array(
    // ...
    'templating' => array(
        'hinclude_default_template' => array(
            'hinclude.html.twig',
        ),
    ),
));
    

Вы можете определять шаблоны по умолчанию для каждой функции render() (что переопределит любой определённый глобальный шаблон по умолчанию):

Twig
PHP

        1
2
3
        {{ render_hinclude(controller('...'),  {
    'default': 'default/content.html.twig'
}) }}
    

Или вы также можете указать строку для отображения в качестве содержания по умолчанию:

Twig
PHP

        1
        {{ render_hinclude(controller('...'), {'default': 'Loading...'}) }}
    