menu

工具提示是主要用于图形元素的小型交互式文本提示。使用图标执行操作时,您可以使用工具提示向人们说明其功能。

将带工具提示的类添加到元素中,并在data-tooltip上添加top、bottom、left和right以控制位置。


  <!-- data-position可以是 : bottom, top, left, or right -->
  <!-- data-tooltip 定义提示文本 -->
  <a class="btn tooltipped" data-position="bottom" data-tooltip="I am a tooltip">悬浮显示</a>
        

初始化


  document.addEventListener('DOMContentLoaded', function() {
    var elems = document.querySelectorAll('.tooltipped');
    var instances = M.Tooltip.init(elems, options);
  });

  // 或用JQuery

  $(document).ready(function(){
    $('.tooltipped').tooltip();
  });
        

选项

名称 类型 默认 描述
exitDelay Number 200 工具提示消失之前的延迟时间。
enterDelay Number 0 工具提示出现之前的延迟时间。
html String null 可以采用常规文本或HTML字符串。
margin Number 5 设置工具提示显示距离其激活器位置的距离,不包括过渡移动。
inDuration Number 300 进入过渡持续时间。
outDuration Number 250 退出过渡持续时间
position String 'bottom' 设置工具提示的位置,可选值: 'top', 'right', 'bottom', 'left'.
transitionMovement Number 10 工具提示在过渡过程中移动的像素数。

方法

因为jQuery不再是一个依赖项,所以所有的方法都是在插件实例上调用的。你可以获得插件实例如下:


  var instance = M.Tooltip.getInstance(elem);

  /* JQuery方法调用
          您仍然可以使用旧的jQuery插件方法调用。
      但您将无法访问实例属性。

    $('.tooltip').tooltip('methodName');
    $('.tooltip').tooltip('methodName', paramName);
  */
          
.open();

显示工具提示


instance.open();
        

.close();

隐藏工具提示


instance.close();
        

.destroy();

销毁插件实例并回收


instance.destroy();
        

属性

名称 类型 描述
el Element 插件初始化时使用的DOM元素。
options Object 初始化实例时使用的选项。
isOpen Boolean 工具提示是否显示
isHovered Boolean 工具提示是否悬停