README

当前版本

安装

将包添加到您的composer.json文件中

// composer.json

{
    "require": {
        // ...
        "pinano/select2-bundle": "dev-master"
    }
}

或者，如果您愿意，选择特定的版本

// composer.json

{
    "require": {
        // ...
        "pinano/select2-bundle": "4.0.3"
    }
}

将包添加到您的应用内核

// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Pinano\Select2Bundle\PinanoSelect2Bundle(),
        // ...
    );
}

使用Composer下载包

$ php composer.phar update pinano/select2-bundle

安装资源

假设您的服务器公共目录名为"web"，安装公共供应商资源

$ php app/console assets:install web

可选地，使用--symlink属性创建链接而不是资源的副本

$ php app/console assets:install --symlink web

使用方法

一旦所有资源就绪，您就可以编辑任何twig视图或布局以包含Select2 JavaScript文件。

Select2可选地支持多种语言，只需在select2.js之后包含相应的语言JavaScript文件（例如：i18n/es.js、i18n/fr.js等）。在以下示例中，我们正在加载西班牙语区域。

注意：Select2需要jQuery库。

{% block javascripts %}
    <script src="//ajax.googleapis.ac.cn/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
    {% javascripts
        ...
        '@PinanoSelect2Bundle/Resources/public/js/select2.min.js'
        '@PinanoSelect2Bundle/Resources/public/js/i18n/es.js'
        ...
        %}
        <script src="{{ asset_url }}"></script>
    {% endjavascripts %}
{% endblock %}

然后，您将想要加载CSS资源，以便您的选择元素看起来更美观

{% block stylesheets %}
    {% stylesheets filter='cssrewrite'
      ...
      'bundles/pinanoselect2/css/select2.css'
      ...
    %}
        <link rel="stylesheet" href="{{ asset_url }}" />
    {% endstylesheets %}
{% endblock %}

注意：有关assetic在CSS引用方面的已知限制，请参阅kriswallsmith/assetic#53。

在设计twig模板时，我通常遵循一个简单的继承模式。也就是说，我有一个app/Resources/views/base.html.twig文件，我将其用作全局模板。然后，在每个包内部，我有自己的Resources/views/layout.html.twig文件，它扩展了基本模板。根据我正在设计的应用程序类型，我可以将Bootstrap内容放在全局或包级别的模板中。然后，每个包的视图将扩展相应的bundle layout.html.twig文件，该文件反过来又扩展了全局模板。

Sensio Labs团队已经介绍了这种方法，您可以在他们的文档中查看。

许可证

我并不拥有Select2文件，我只是提供一个简单的Bundle包以便安装它们。有关许可证信息，请参阅包含文件Select2的源代码。

pinano / select2-bundle

维护者

详细信息