README

Yii2 的 Materialize

这是当前正在积极开发的分支，实现了 Materialize 版本 1.0，因此破坏了向后兼容性。

此包将 Materialize CSS 框架集成到 Yii2 中。Materialize 是基于 Material Design 的现代响应式前端框架。

查看官方文档获取详细信息。

请查看官方演示页面以查看仓库的实际操作（需要适配 v3）

当前实现的 Materialize 版本：1.0.0。

安装

首选的安装方式是通过 Composer。如果您没有 Composer，您可以从这里获取它： https://getcomposer.org.cn/

您还应该安装 Composer Asset Plugin 以处理 NPM 和 Bower 资产

$ composer global require "fxp/composer-asset-plugin:~1.4"

或者，您可以利用 Asset Packagist： https://asset-packagist.org/

要安装包，请将以下内容添加到您的 composer.json 中的 require 部分

composer require alvarolordelo/yii2-materialize: "dev-master"

"require": {
    "alvarolordelo/yii2-materialize": "dev-master"
},

使用方法

要加载 Materialize CSS 文件，将 MaterializeAsset 集成到您的应用中。有两种方法可以实现这一点：在主布局中注册资产

// @app/views/layouts/main.php

\alvarolordelo\yii2materialize\assets\MaterializeAsset::register($this);

// further code

或在您的全局 AppAsset.php 中作为依赖项

// @app/assets/AppAsset.php

public $depends = [
    'alvarolordelo\yii2materialize\assets\MaterializeAsset',
    // more dependencies
];

示例布局

包中包含两个示例布局文件。您可以使用此文件获取灵感和替换相应的 views/layouts/main.php。

您可以在 src/layout/main-starter.php 和 src/layout/main-parallax.php 中找到布局文件的示例，这些文件是从 materialize 网站DEMOb编码的。

小部件

目前有以下小部件可用

ActiveField
ActiveForm
Alert
Breadcrumbs
Button
Carousel
ChipInput
Collapsible
DatePicker
DetailView
Dropdown
FloatingActionButton
带有 ActionColumn 的 GridView
Icon
LinkPager
MaterialBox
Modal
Nav
NavBar
Parallax
Progress
RangeInput
Select
SideNav
Slider
Spinner
StaticChip
SubmitButton
SwitchButton
TimePicker

Gii 支持

如果您正在使用 Gii 创建 CRUD 控制器和视图文件，可以通过集成修改后的 Gii 模板来获取 materialized 视图文件。

// @app/config/main-local.php

$config['modules']['gii'] = [
    'class' => 'yii\gii\Module',      
    'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'],  
    'generators' => [
        'crud' => [
            'class' => 'yii\gii\generators\crud\Generator',
            'templates' => [ // setting materializecss templates
                'materialize' => '@vendor/alvarolordelo/yii2-materialize/src/gii-templates/generators/crud/materialize',
            ]
        ]
    ],
];

您可以将这些模板复制到您想要的任何位置进行进一步自定义。确保在您的配置中相应地调整路径。

已知问题

正常参数运行的系统 :)

变更日志

2019.1 - 2019-05-28

初始发布

alvarolordelo / yii2-materialize

维护者

详细信息