README

一个通过给定模板实现简单且灵活语言切换的 Yii2 扩展

安装此扩展的首选方式是通过 composer。

运行以下命令之一：

composer require "kmergen/yii2-language-switcher": "*"

或者将以下内容添加到你的 composer.json 文件的 require 部分：

"kmergen/yii2-language-switcher": "*",

使用方法

简单列表

echo \kmergen\LanguageSwitcher::widget([

]);

Bootstrap 3 下拉菜单

echo \kmergen\LanguageSwitcher::widget([
                   'parentTemplate' => '<nav class="navbar-nav nav">
                    <li class="dropdown">{activeItem}
                        <ul class="dropdown-menu">{items}</ul>
                     </li>   
                 </nav>',
                 'activeItemTemplate' => '<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">{label} <span class="caret"></span></a>',
                 'itemTemplate' => '<li><a href="{url}">{label}</a></li>'
            ]);

带有旗帜的 Bootstrap 3 下拉菜单

echo \kmergen\LanguageSwitcher::widget([
                   'parentTemplate' => '<nav class="navbar-nav nav">
                    <li class="dropdown">{activeItem}
                        <ul class="dropdown-menu">{items}</ul>
                     </li>   
                 </nav>',
                 'activeItemTemplate' => '<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false"><i class="flag flag-{language}"></i> {label} <span class="caret"></span></a>',
                 'itemTemplate' => '<li><a href="{url}"><i class="flag flag-{language}"></i> {label}</a></li>'
            ]);

Bootstrap 4 下拉菜单

<?= \kmergen\LanguageSwitcher::widget([
                'parentTemplate' => '<li class="nav-item dropdown">{activeItem}                               
                    <div class="dropdown-menu" aria-labelledby="navbarDropdownLanguageMenuLink">{items}</div></li>',
                'activeItemTemplate' => '<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">{label}</a>',
                'itemTemplate' => '<a class="dropdown-item" href="{url}">{label}</a>'
                ]); ?>

带有旗帜的 Bootstrap 4 下拉菜单

<?= \kmergen\LanguageSwitcher::widget([
                'parentTemplate' => '<li class="nav-item dropdown">{activeItem}                               
                    <div class="dropdown-menu" aria-labelledby="navbarDropdownLanguageMenuLink">{items}</div></li>',
                'activeItemTemplate' => '<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">{label}</a>',
                'itemTemplate' => '<a class="dropdown-item" href="{url}"><i class="flag flag-{language}"></i> {label}</a>'
                ]); ?>

在此扩展的资产文件夹中有一个 flags.png 和一个 flags.css 文件，您可以将它们实现到您的项目模板中。我们不会直接将这些资产与扩展注册，以保持其尽可能灵活。

注意：此小部件从扩展 Yii2 LocaleUrls 获取语言。因此，在运行小部件之前，您可能需要先配置 localeUrls。