README

此扩展添加了对 Chaldene Admin Template 标记的支持。

此扩展包括易于应用的资源包、HTML 布局和基本小部件。

安装

您的最佳 CLI 朋友将帮助您完成此操作

composer require mikbox74/yii2-chl

开始派对

开始之前，您必须配置 view 组件

return [
    //...
    'components' => [
        'view' => [
            'class'   => \mikbox74\Chaldene\ChaldeneView::class,
            //...
        ],
    ],
    //...
];

mikbox74\Chaldene\ChaldeneView 重写了系统布局路径并实现了一些酷炫的功能。要获取更多酷炫功能，您可以使用以下属性：

• layout (字符串) - 三种布局类型之一：topnav（主菜单在顶部）、sidenav、sidenavhf（主菜单在左侧）。强烈建议使用 mikbox74\Chaldene\ChaldeneLayouts 中的合适常量。
• fixPage (布尔值) - 使 app heading 和 app footer 在滚动页面时固定。
• fixSide (布尔值) - 使 side heading、side footer、app heading 和 app footer 在滚动页面时固定。
• fixMain (布尔值) - 使 main heading、main footer、app heading 和 app footer 在滚动页面时固定。
• boxed (布尔值) - 限制页面宽度。
• showTitle (布尔值) - 在 main heading 面板内显示页面标题。
• rtl (布尔值) - 从右到左的内容方向。
• widgets (数组) - 配置数组，您可以在其中说明如何在视图中放置某些小部件。

主题化

自 1.1.6 以来

查看 mikbox74\Chaldene\ChaldeneThemes 以使用其常量

return [
    //...
    'components' => [
        'view' => [
            'class'   => \mikbox74\Chaldene\ChaldeneView::class,
            'colorTheme' => \mikbox74\Chaldene\ChaldeneThemes::PETER_RIVER,
            //...
        ],
    ],
    //...
];

在 1.1.6 之前

您可以通过配置 assetManager 组件来设置以下之一。示例

return [
    //...
    'components' => [
        'view' => [
            'class'   => \mikbox74\Chaldene\ChaldeneView::class,
            //...
        ],
        'assetManager' => [
            'class' => \yii\web\AssetManager::class,
            'bundles' => [
                \mikbox74\Chaldene\Assets\ChaldeneAsset::class => [
                    'theme' => \mikbox74\Chaldene\ChaldeneThemes::PETER_RIVER,
                ],
            ],
        ],
    ],
    //...
];

主题之间没有太大区别，但您可能喜欢这个功能 ;)

更多关于小部件位置的信息

我建议在特殊文件中设置小部件

return [
    //...
    'components' => [
        'view' => [
            'class'   => \mikbox74\Chaldene\ChaldeneView::class,
            'widgets' => require 'widgets.php',
        ],
    ],
    //...
];

widgets.php

return [
    'app-logo' => [
        'widget1',
        'widget2',
        'widget3',
        //...
    ],
    'mainmenu' => [
        'widget1',
        'widget2',
        'widget3',
        //...
    ],
    'app-search' => [
        //...
    ],
    //...
];

第一级是一个关联数组，具有 'place name' => '此位置的小部件列表' 的对。

该模板有以下位置：

• app-logo
• mainmenu
• app-search
• app-nav
• dashhead-subtitle
• dashhead-toolbar
• before-content
• after-content
• main-footer
• app-footer
• side-heading（仅适用于 sidenav 和 sidenavhf 布局）
• side-footer（仅适用于 sidenav 和 sidenavhf 布局）
• mobile-search（在点击搜索按钮后在小型屏幕上可见）

下一级是纯文本小部件列表。每个小部件都可以通过三种方式配置：

1. 纯文本字符串。它将直接放置而不进行任何更改。
2. 具有 'class' 元素和指定类的任何属性的配置数组（Yii 方式）。
3. 匿名函数返回一个类配置数组（如上所述）。

关于小部件的简要介绍：

• mikbox74\Chaldene\Widgets\AlertNavitem - 用于以图标、徽章和消息下拉列表的形式查看重要信息。将其添加到 UL 菜单中的适当位置并享受吧。
• mikbox74\Chaldene\Widgets\Box - 在漂亮的结构块中查看内容（与 TWBS 选项卡类似，但稍微先进一些）。
• mikbox74\Chaldene\Widgets\Breadcrumbs - 在您的网站上到处都有面包屑。
• mikbox74\Chaldene\Widgets\Logo - 以两种方式显示您的（或我们的）logo 图像：小号用于手机和其他屏幕的较大号。
• mikbox74\Chaldene\Widgets\Message - 这是 Yii2-advanced 应用骨架中 \common\widgets\Alert 的孪生兄弟。它将自动显示，无需在任何地方添加。
• mikbox74\Chaldene\Widgets\MetisMenu - 这是城镇中的流行之王。您可以在任何想要看到出色的自适应多级菜单的地方添加它。
• mikbox74\Chaldene\Widgets\SearchForm - 一个简单的搜索表单，包含输入和旋钮。
• mikbox74\Chaldene\Widgets\UserNavitem - 可以查看带有用户头像、用户名和下拉用户菜单的导航项。在 UL 标签内运行良好（与 AlertNavitem 相同）

更多信息请参阅 DocComments。

并且...杀手级功能：装饰器！

从 1.1.0 版本开始，该包中的每个小部件都有一个字符串属性 decorator。您可以使用它来指定您想要的任何装饰器文件的路径（了解有关 ContentDecorator 的信息以获取其工作方式）。例如，您可以创建文件 @common/views/decorators/example.php

<div style="border: 1px solid red; background: pink;">
    <?= $content?>
</div>

并将路径设置为任何小部件的 decorator。

精美的快捷表

顶部导航

侧导航

移动搜索