菜单

工具提示是针对图形元素的小型、交互式、文本提示。当使用图标进行操作时,可以使用工具提示来阐明其功能。

将 Tooltipped 类添加到元素中,并在 data-tooltip 中添加顶部、底部、左侧、右侧以控制位置。


  <!-- data-position can be : bottom, top, left, or right -->
  <!-- data-tooltip defines the tooltip text -->
  <a class="btn tooltipped" data-position="bottom" data-tooltip="I am a tooltip">Hover me!</a>
        

初始化


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

  // Or with jQuery

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

选项

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

方法

由于 jQuery 不再是依赖项,因此所有方法都在插件实例上调用。你可以像这样获取插件实例


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

  /* jQuery Method Calls
    You can still use the old jQuery plugin method calls.
    But you won't be able to access instance properties.

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

显示工具提示。


instance.open();
        

.close();

隐藏工具提示。


instance.close();
        

.destroy();

销毁插件实例并拆除


instance.destroy();
        

属性

名称 类型 说明
el 元素 用于初始化插件的 DOM 元素。
options 对象 实例初始化时使用的选项。
isOpen 布尔值 如果工具提示已打开。
isHovered 布尔值 如果工具提示已悬停。