README

此包提供了将Pulsar集成到Symfony中的功能。

安装

确保全局已安装Composer，具体请参阅Composer文档中的安装章节。

步骤1：下载包

打开命令行，进入项目目录，并执行以下命令以下载此包的最新稳定版本

$ composer require jadu/pulsar-symfony

步骤2：启用包

然后，将包添加到项目中的注册包列表中，修改app/AppKernel.php文件

// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            // ...
            new \Jadu\Bundle\PulsarBundle\JaduPulsarBundle(),
        ];

        // ...
    }

    // ...
}

用法

Twig 辅助函数

Pulsar的Twig辅助函数自动注册在@JaduPulsar命名空间下。

有关如何使用twig辅助函数的信息，请参阅Pulsar文档。

示例

{% import '@JaduPulsar/v2/helpers/html.html.twig' as html %}

{{
    html.panel({
        'title': 'In West Philadelphia born and raised',
        'body': 'In the playground was where I spent most of my days.',
        'icon': 'info-sign'
    })
}}

Twig 扩展

Pulsar的Twig扩展自动注册到twig。

其中一些辅助函数是使用twig辅助函数或Symfony表单主题所必需的。

示例

Created {{ product.createdAt|time_ago }}

Symfony 表单主题

此包提供了必要的twig，以便将Symfony内置表单类型主题化为Pulsar。

建议将主题设置为默认

# app/config/config.yml

twig:
    form_themes:
        - '@JaduPulsar/forms.html.twig'

注册后，使用Symfony内置表单类型生成的表单将被Pulsar样式化。

额外的Symfony 表单类型

此包为Pulsar提供的表单组件提供了额外的表单类型，这些类型不是Symfony内置的。

这些可以在Jadu\Bundle\PulsarBundle\Form命名空间中找到。

示例

use Jadu\Bundle\PulsarBundle\Form\ToggleSwitchType;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;

class MyType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            ->add(
                'enabled',
                ToggleSwitchType::class,
                [
                    'required' => false,
                ]
            );

        // ...
    }

    // ...
}