包简介

A MDC Snackbar components integrated to Nette

README 文档

README

Material components SNACKBAR implementation to NETTE Framework.

Idea behind was inspired by Ipublikuj.

Install

The best way to get MDCNette dialog is via composer.

php composer.phar require mdcnette/snackbar

Add MDC Snackbar extensions to your config file

extensions:
    mdcsnackbar: MDCNette\Snackbar\DI\SnackbarExtension

Then in your presenter (typically in BasePresenter) add this.

use TSnackbar;

Add this to your @layout.latte.

{snippet snackbar} // if you want use ajax. wrap control to snippet
    {control snackbar}
{/snippet}

Client side (js/css)

And finally you need to setup javascript... The best approach is to install it with npm.

npm install @mdcnette/snackbar

or you can find it in this repo in client-side folder.

in dist folder you can find files to include.

material-components-web.min.css

(styles for snackbar) link this to your head in html layout.

material-components-web.min.js

(base js for snackbar) add this to your script load.

mdcnette.ajax.snackbar.js /or/ mdcnette.noajax.snackbar.js

(js for snackbar) add this to you script load.

@layout.latte preview

<!DOCTYPE html>
<html>
<head>
    <link rel="stylesheet" href="path/to/material-components-web.min.css" type="text/css">
</head>

<body>
    {include content}
    
    {snippet snackbar} // use snippet tag only if you want use ajax.
        {control snackbar}
    {/snippet snackbar}
    
    <script src="path/to/material-components-web.min.js" type="text/javascript"></script>
    
    <!--IF AJAX-->
    <script src="path/to/nette.ajax.js" type="text/javascript"></script>
    <script src="path/to/mdcnette.ajax.snackbar.js" type="text/javascript"></script>
    <script type="text/javascript">
    $(function () {
    	$.nette.init();
    });
    </script>
    <!--/ IF AJAX-->
    
    <!--IF NO AJAX-->
    <script src="path/to/mdcnette.noajax.snackbar.js" type="text/javascript"></script>
    <!--/IF NO AJAX-->

</body>
</html>

After this you can start using material snackbar!

Usage

$this->snackbar(
    "<message>",                //Message
    ["<template>"],             //Template -> viz template
    [array(<options>)]          //Options -> viz options table
    );

Options

For better understanding, look for official demo HERE

Name	Description	Default	type	Good to know
`wait`	Time for snackbar dismiss	2750 ms	integer
`ajax`	if action is fired with ajax	false	boolean
`action`	Url for action	false	String	Must be set `actionText` option
`actionText`	Text for action button	false	String	Must be set `action` option
`multiline`	Snackbar is taller to for longer message	false	boolean
`rtl`	Right to left	false	boolean
`actionDismiss`	On click action will dismiss (only with ajax)	true	boolean	OR wait for timeout
`alignStart`	Shows snackbar on the left side of page	false	boolean	works with rtl

You can set up default options in config file for all snackbars.

extensions:
    mdcsnackbar: MDCNette\Snackbar\DI\SnackbarExtension
    
mdcsnackbar:
    wait: 5000 # default 4000 (must be same or higher)
    ajax: true # default false
    alignStart: true # default false
    # etc...

Template

MDCNette Snackbar comes with possibility to add custom predefined options template.

In config you can add this template:

extensions:
    mdcsnackbar: MDCNette\Snackbar\DI\SnackbarExtension
    
mdcsnackbar:
    rtl: true # 'rtl' is now set for all templates
    error:
        wait: 7500
    left:
        alignStart: true
    right:
        alignStart: true
        rtl: true

And usage may look like this:

$this->snackbar('FATAL ERROR', 'error');
// You can add custom options to every template as well
$this->snackbar('VERY LOOOOOOOOOOOOOONG FATAL ERROR', 'error', ['multiline' => true]);

Examples

$this->snackbar('You are logged in as guest@example.com');

$this->snackbar('User added', NULL,
    [
        'wait'         => 5000,
        'action'       => $this->link('undo!'),
        'actionButton' => 'undo',
        'alignStart    => true
    ]);

mdcnette/snackbar 适用场景与选型建议

mdcnette/snackbar 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 123 次下载、GitHub Stars 达 0，最近一次更新时间为 2017 年 04 月 06 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「nette」「material design」「mdc」「components web」「snackbar」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 mdcnette/snackbar 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 mdcnette/snackbar 我们能提供哪些服务？

定制开发 / 二次开发

基于 mdcnette/snackbar 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发