nobitagit/material-floating-button: Vanilla Js Material design floating menu wit ...

原作者: [db:作者] 来自: 网络收藏邀请

开源软件名称（OpenSource Name）：

nobitagit/material-floating-button

开源软件地址(OpenSource Url)：

https://github.com/nobitagit/material-floating-button

开源编程语言(OpenSource Language)：

JavaScript 100.0%

开源软件介绍(OpenSource Introduction)：

Material Floating Button

Material design floating button action implementation.

Made to be semantic, fast and easy to customize. ~~Shamelessly~~ inspired by action buttons from Google Inbox, Evernote and Path.

See a demo here to see it in action or just take a look at this awesome gif:

Test all the available effects to date in the demo.

##Other versions## Also available as:

##How to use## ###Basic usage### Clone/download the repo from Github or just use npm:

npm install mfb --save

(Optionally) run npm install to have access to the configured Grunt tasks if you use them, then reference the basic css styles in your <head> like so:

<link href="path/to/css/mfb.css" rel="stylesheet">

Use the appropriate html structure (better explained later), for example:

<ul class="mfb-component--tl mfb-slidein" data-mfb-hover>
  <!-- the menu content -->
</ul>

Everything should already work fine.

You may or may not want to include the provided mfb.js script depending on the need to support click/touch.

<script src="path/to/js/mfb.js"></script>

For a breakdown on why and when you need to include the script please refer to Toggling options and touch devices support.

###Customising the component### ####HTML#### The basic structure of the component is the following (the customisable classes/attributes are in curly braces):

<ul class="{{placement-class}} {{effect-class}}" {{hover/click-to-open}} {{menu-state}}>
  <li class="mfb-component__wrap">
    <!-- the main menu button -->
    <a data-mfb-label="{{the label text of the main button}}" class="mfb-component__button--main">
      <!-- the main button icon visibile by default -->
      <i class="mfb-component__main-icon--resting {{icon-class}}"></i>
      <!-- the main button icon visibile when the user is hovering/interacting with the menu -->
      <i class="mfb-component__main-icon--active {{active-icon-class}}"></i>
    </a>
    <ul class="mfb-component__list">
      <!-- a child button, repeat as many times as needed -->
      <li>
        <a href="link.html" data-mfb-label="{{the label text of the a child button}}" class="mfb-component__button--child">
          <i class="mfb-component__child-icon {{icon-class}}"></i>
        </a>
      </li>
    </ul>
  </li>
</ul>

####SCSS/CSS####

Although you can use the provided css as is, it's highly likely that you will want to customise the looks and behavior of the component by changing its underlying css. A number of variables is provided for your convenience in the SASS file.

The best way to tweak them is leave the src/mfb.scss source as is, import it in your own style sheet and define your custom variables before the @import statement right there. For example:

// your .scss working file
$main-color: #4991EF;

@import "path/to/src/mfb.scss";

This will leave the core files unchanged from the source. You will then be able to keep this repo as upstream and pull in any future changes without having to worry about overwriting your changes.

Here below is a breakdown of all the variables currently available, along with their defaults.

#####Basic#####

Variable name	Default value	Explanation
$main-color	#E40A5D	main/primary color of the component
$bright-text	rgba(255, 255, 255, 0.8)	color of icons and text
$number-of-child-buttons	4	how many child buttons the component supports

#####Effects##### n.b. - set to true to include the effect styles in the compiled .css file. To actually activate the desired effect you need to reference the corresponding class in the markup (see here)

Variable name	Default value
$effects-zoomin	true
$effects-slidein	true
$effects-slidein-spring	true
$effects-fountain	true

As a suggestion, try to only include the animation you're using in production in order to have a much lighter css.

#####Speeds#####

Variable name	Default value	Explanation
$delay-staggering-inflate	0.1s	each child button can appear with a slight, more natural delay (set to 0 for no-delay)
$slide-speed	0.5s	the child buttons animate at this speed
$label-hover-off	0.5s	the child buttons labels fade in at this speed
$label-hover-on	0.3s	the child buttons labels fade out at this speed

#####Sizes#####

Variable name	Default value	Explanation
$main_button_size	25px	the distance of the main button from the closest corners of the screen
$labels-font-size	13px	font-size for all labels
$labels-padding-vertical	4px	top & bottom padding for the labels
$labels-padding-horizontal	10px	left & right padding for the labels

You can compile the final css on your own or use the provided, pre-configured Grunt tasks for it. After installing all dependencies (by running npm install from the terminal) type grunt sass (on time compilation) or grunt watch-css (live reload triggered after the scss files are changed).

####Toggling options and touch devices support#### The menu can be customised to be activated either on hover or on click/tap. To assign the desired toggling method the component provides some attributes to add this functionality in a declarative way right from the markup.

#####Hover toggling#####

If you're only interested in desktop support and want the menu to be activated on hover you won't need to include any scripts as that animation is CSS-based and included in the stylesheet provided. Just set the data-mfb-toggle attribute to hover like so:

<ul class="mfb-component--tl mfb-slidein" data-mfb-toggle="hover">

#####Click toggling#####

To add click and touch support (and to support the open/close animation programmatically, more on this later) include the mfb.js file and reference it in the page. Finally set the data-mfb-toggle attribute to click, along with the initial state you want the menu to appear at load time, using the data-mfb-state attribute. An example:

<ul class="mfb-component--tl mfb-slidein" data-mfb-toggle="click" data-mfb-state="closed">

If you want the menu to appear open at load time, do this instead:

<ul class="mfb-component--tl mfb-slidein" data-mfb-toggle="click" data-mfb-state="open">

#####Hover toggling along with touch support#####

If you want the menu to work on hover but need support for touch devices you first need to include Modernizr to detect touch support. If you are alreay using it in your project just make sure that the touch detection is enabled.

If you're not using Modernizr already, just include the provided modernizr.touch.js script (look in the src/lib/ folder) in your <head> or get the latest version of this very script right from here. Note that this is a custom build and will only detect for touch support, it's not the full library.

Then include the mfb.js file, ideally at the bottom of your page. Once the scripts are in place just set up a normal button with hover toggling like so:

<ul class="mfb-component--tl mfb-slidein" data-mfb-toggle="hover">

The script will take care of changing the behavior when the page is viewed from a touch enabled device.

#####Opening/closing the menu programmatically#####

If you need to close the menu after a certain event (or open it without user interaction) you can easily do so just by setting its state to closed or open. Once you have selected the menu in your desired way just close it like so:

menu.setAttribute('data-mfb-state', 'closed');

Or open it with:

menu.setAttribute('data-mfb-state', 'open');

##Contributions?## Yes please! If you submit a PR please add the relative documentation in this README (if needed) and don't forget to add you name and/or email to the contributors list in the package.json file.

##Credits##

Andrey Sitnik's Easings.net for visualizing animations.
Demo icons courtesy of Ionicons.
All the contributors to this project.

##Todos##

provide minified script and stylesheet
replace @extends as much as possible from the SCSS to optimize output
more animations
add to bower
provide more variables/get rid of currently hard-coded values

鲜花

握手

雷人

路过

鸡蛋

该文章已有0人参与评论

请发表评论

全部评论

专题导读

More+

10-27 六六分期app的软件客服如何联系？(六六分期

11-06 可心卡盟:win10系统火狐flash插件崩溃怎么

11-06 亲亲特价:怎么删除回收站图标

11-06 济南大学虚拟社区:鲁大师节能降温的具体办

11-06 xlueops.exe:无线网络安装向导

11-06 女斗合众国:win7系统cf与主机连接不稳定怎

11-06 0xc000022-[cf烟雾头]cf怎么调烟雾头

11-06 qizideyouhuo:应用程序无法正常启动0xc0000

11-06 ipz-185:win7系统vcf文件怎么打开

11-06 傻哥蹦迪:win10系统s4怎么打开usb调试

11-06 八神浩树gtaste:回收站清空了怎么恢复

11-06 妖尾之黑色守护:win10系统电脑没有1440x900

11-06 校园至尊魔王小说:win7系统浏览网页时字体

11-06 女斗合众国:win10系统访问共享文件夹提示请

11-06 tokyo hot n0654:恢复win7系统默认字体一招

11-06 雨酷仙境:设置win7系统转移临时文件夹腾出

11-06 阿穆纳伊之杖:win7系统开始菜单在右边还原

11-06 tunespotting:win10系统火狐flash插件总是

11-06 甘尔葛分析师：计谋网站seo关键词暴涨有什

11-06 蔡贵霖: 计谋网站seo关键词暴涨有什么秘密

11-06 博益网首页:ao3网页版进入不了解决方法

11-06 漏斗子专栏: 网站数据分析小白易懂精华篇

11-06 见证双虹怎么做:win7系统开启telnet命令的

11-06 颾狐蝶蜋:系统资源不足无法完成请求的服务

11-06 国光中学校歌:提交网站到alexa查询详细步骤

11-06 西安有情天:静态网页和动态网页的区别

11-06 红木雅尚斋:外部链接构造对网站的好处

11-06 前官礼遇：防止域名劫持–增强域安全性的10

11-06 密传二转答案: 中文分词算法有哪些

11-06 金泉家园邮编:百度快照劫持的表现及应对方

HotBitmapGG/MoeQuest: The meizi of a material design style welfare App.发布时间：2022-08-17

krishnakapil/MaterialSeachView: Android Material Design Style Custom Search View发布时间：2022-08-17

剪的笔顺,诠释剪的笔画,认识剪的部首

1 六六分期app的软件客服如何联系？(六六分期

六六分期app的软件客服如何联系？不知道吗？加qq群【895510560】即可！标题：六六分期

阅读：18819|2023-10-27

2 可心卡盟:win10系统火狐flash插件崩溃怎么

今天小编告诉大家如何处理win10系统火狐flash插件总是崩溃的问题，可能很多用户都不知

阅读：9873|2022-11-06

3 亲亲特价:怎么删除回收站图标

今天小编告诉大家如何对win10系统删除桌面回收站图标进行设置，可能很多用户都不知道

阅读：8283|2022-11-06

4 济南大学虚拟社区:鲁大师节能降温的具体办

今天小编告诉大家如何对win10系统电脑设置节能降温的设置方法，想必大家都遇到过需要

阅读：8640|2022-11-06

5 xlueops.exe:无线网络安装向导

我们在使用xp系统的过程中,经常需要对xp系统无线网络安装向导设置进行设置，可能很多

阅读：8570|2022-11-06

6 女斗合众国:win7系统cf与主机连接不稳定怎

今天小编告诉大家如何处理win7系统玩cf老是与主机连接不稳定的问题，可能很多用户都不

阅读：9573|2022-11-06

7 0xc000022-[cf烟雾头]cf怎么调烟雾头

电脑对日常生活的重要性小编就不多说了，可是一旦碰到win7系统设置cf烟雾头的问题，很

阅读：8565|2022-11-06

8 qizideyouhuo:应用程序无法正常启动0xc0000

我们在日常使用电脑的时候，有的小伙伴们可能在打开应用的时候会遇见提示应用程序无法

阅读：7959|2022-11-06

9 ipz-185:win7系统vcf文件怎么打开

今天小编告诉大家如何对win7系统打开vcf文件进行设置，可能很多用户都不知道怎么对win

阅读：8567|2022-11-06

10 傻哥蹦迪:win10系统s4怎么打开usb调试

今天小编告诉大家如何对win10系统s4开启USB调试模式进行设置，可能很多用户都不知道怎

阅读：7497|2022-11-06

客服电话

电子邮件

nobitagit/material-floating-button: Vanilla Js Material design floating menu wit ...

开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Material Floating Button

请发表评论

全部评论

上一篇：

下一篇：

CVE-2022-34251

Wandmalfarbe/pandoc-latex-template: A pa

learnlatex/learnlatex.github.io: Learn L

win7系统备份网络设置的操作方法-宝宝做平

sungwool/CFA_for_anomaly_localization

剪的笔顺,诠释剪的笔画,认识剪的部首

六六分期app的软件客服如何联系？(六六分期

florent37/ViewAnimator: A fluent Android

florent37/Shrine-MaterialDesign2: implem

CVE-2020-36276

SimpleSoftwareIO/simple-sms: Send and re

关于我们

产品与服务

解决方案

139-2527-9053