README

Yii2 的 Materialize

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

转到 1.x 版本

转到 2.x 版本

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

请参阅官方文档获取详细信息。

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

当前实现 Materialize 版本：1.0.0。

安装

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

您还应安装 Composer Asset 插件以处理 NPM 和 Bower 资产

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

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

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

"require": {
    "globalmikebracas/yii2-materializecss": "~3.0.0"
},

用法

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

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

\macgyer\yii2materializecss\assets\MaterializeAsset::register($this);
// further code

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

// @app/assets/AppAsset.php

public $depends = [
    'macgyer\yii2materializecss\assets\MaterializeAsset',
    // more dependencies
];

小部件

以下小部件目前可用

ActiveField
ActiveForm
Alert
Breadcrumbs
Button
Carousel
ChipInput
Collapsible
DatePicker
DetailView
Dropdown
FloatingActionButton
GridView with ActionColumn
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
                'materializecss' => '@vendor/macgyer/yii2-materializecss/src/gii-templates/generators/crud/materializecss', 
            ]
        ]
    ],
];

您可以将这些模板复制到任何您希望的位置以进行进一步定制。确保您根据配置文件中的路径进行相应调整。

已知问题

在正常参数上运行的系统 :)

示例布局

该包中包含一个示例布局文件。您可以使用此文件获取灵感和设计您自己的布局，或者用提供的文件替换相应的 views/layouts/main.php。

您可以在 src/layout/main.php 中找到示例布局文件。

变更日志

3.0.0 - 2018-11-16

实现 Materialize v1.0.0
包含破坏性变更

2.0.0 - 2017-07-30

请注意：此版本包含破坏性变更
将 Breadcrumbs、Dropdown、FixedActionButton、Nav、NavBar 和 SideNav 移动到专用命名空间（破坏性更新）
弃用 chingyawhao/materialize-clockpicker，改用 Materialize 的原生时间选择器实现（破坏性更新）
添加了 Collapsible
更新 Materialize 至 v0.100.1

1.5.0 - 2017-07-03

添加了 Carousel
添加了 MaterialBox
添加了 Parallax
添加了 Slider
改进了示例布局

1.4.0 - 2017-06-05

添加了 RangeInput
更新 Materialize 至 v0.98.2
添加了一些缺失的 PHPDoc 注释

1.3.0 - 2017-03-02

添加了 LinkPager
GridView：将 LinkPager 设置为默认分页类

1.2.1 - 2017-02-05

Select：添加了 multiple 属性
将 Yii 的 Composer 依赖限制为 ~2.0.0
将 PHP 的 Composer 依赖设置为 >= 5.6.0

1.2.0 - 2017-02-01

更新 Materialize 至 v0.98.0
添加了 Select
ActiveField：添加了 dropDownList() 方法
ActiveField：将 characterCounter() 方法改为与 Materialize v0.98.0 兼容
Modal：修复了模态插件调用
FixedActionButton：添加了工具栏支持

1.1.0 - 2017-01-05

添加了 SideNav
Nav：添加了 SideNav 支持
NavBar：将移动切换按钮移动到 Nav
ActiveField：添加了 Materialize 自动完成支持
ActiveField：添加了 Materialize 字符计数支持
ActiveField：默认情况下，复选框和单选按钮不会被标签包裹

1.0.9 - 2016-09-01

添加了 TimePicker

1.0.8 - 2016-08-08

Button：修复了标签渲染问题
SwitchButton：修复了未选中属性
Alert：添加了 default 上下文类
Button：添加了 type 属性
Button：添加了 large 属性
Button：添加了 disabled 属性
Spinner：添加了 size 属性
Spinner：添加了 color 属性
SwitchButton：添加了对图标/HTML标签的支持
添加了 SubmitButton

1.0.7 - 2016-07-27

完整源代码文档
将 Materialize 版本固定为 0.97.6，以便在集成前监视 0.97.7 版本的发布

1.0.6 - 2016-05-16

添加了示例布局
修复了行分隔符问题
从“已知问题”部分移除了 Datepicker 问题

1.0.5 - 2016-04-24

更新了 README，以包含修复的 Datepicker 问题
重构了 Breadcrumbs

1.0.3 - 2016-03-10

修复了多次使用 MaterializeWidgetTrait 导致的 bug
更新了 NavBar 中的 PHPDoc

1.0.2 - 2016-03-09

添加了 Spinner
添加了 Progress

1.0.1 - 2016-03-09

更新了 README
添加了 Packagist 支持

1.0.0 - 2016-03-09

初始版本发布

globalmikebracas / yii2-materialize

维护者

详细信息