❤
npm
Sign UpSign In

akido-electron-tooltip

1.2.6 • Public • Published

Akido Electron tooltip

Introduction

This module is a fork of Electron tooltip, with improved support for the lastest version of electron (>5).

The documentation is the same. The name has changed.

Description

This module is intended to be used in Electron applications. It allows for tooltips to flow outside the window bounds they're called from.

Installation

npm i akido-electron-tooltip

Usage

After importing the module, it will search for elements that have the data-tooltip attribute attached. A configuration object can be passed in when calling the tooltip function.

// in the render process..
const tt = require('akido-electron-tooltip')
tt({
  // config properties
})

Position, width and offset options can be overriden on a per element basis by using the data-tooltip-{option} attribute.

<!-- basic example: -->
<a href="http://www.facebook.com" data-tooltip="Go to Facebook" data-tooltip-position="bottom"></a>

Configuration options

option description default values
position Tooltip direction top left, top, right, bottom
width Width of the tooltip. If width is set to auto, the tooltip will not wrap content auto > 0
offset Offset from the element to the tooltip 0 > 0
style Object for overwriting default styles {}
customContent Function that will be called each time the tooltip is shown. Takes two arguments: the element on which it was called, and the current value of data-tooltip. It should return a string which will be used instead of the data-tooltip value undefined
level It's possible to specify the level of the tooltip (check: https://electronjs.org/docs/api/browser-window#winsetalwaysontopflag-level-relativelevel) 'floating' 'normal' | 'floating' | 'torn-off-menu' | 'modal-panel' | 'main-menu' | 'status' | 'pop-up-menu' | 'screen-saver'
relativeLevel It's possible to specify the relative level of the tooltip (check: https://electronjs.org/docs/api/browser-window#winsetalwaysontopflag-level-relativelevel) 0 integer 
// example
// in the render process..
const tt = require('akido-electron-tooltip')
tt({
  position: 'bottom',
  width: 200,
  style: {
    backgroundColor: '#f2f3f4',
    borderRadius: '4px'
  },
  level: 'pop-up-menu',
  relativeLevel: 2 
})

Readme

Keywords

none

Package Sidebar

Install

npm i akido-electron-tooltip

Repository

github.com/oltreseba/akido-electron-tooltip

Homepage

github.com/oltreseba/akido-electron-tooltip

Weekly Downloads

1

Version

1.2.6

License

ISC

Unpacked Size

445 kB

Total Files

10

Last publish

Collaborators

  • akiflowdevelopers
Try on RunKit
Report malware