ZToolTip

Forked from pyqttooltip by Niklas Henning

A modern and fully customizable tooltip library for PyQt and PySide

Features

• Fixed and automatic placement
• Customizable triangle
• Customizable animations and delays
• Fully customizable and modern UI
• Works with PyQt5, PyQt6, PySide2, and PySide6

Installation

pip install ztooltip

Usage

from PyQt6.QtWidgets import QMainWindow, QPushButton
from ztooltip import Tooltip, TooltipPlacement


class Window(QMainWindow):
    def __init__(self):
        super().__init__(parent=None)

        # Add button
        self.button = QPushButton('Button', self)
        
        # Add tooltip to button
        self.tooltip = Tooltip(self.button, 'This is a tooltip')

The tooltip will automatically be shown while hovering the widget. If you want to manually show and hide the tooltip, you can use the show() and hide() methods:

tooltip.show()
tooltip.hide()

To delete a tooltip, you can use the deleteLater() method:

tooltip.deleteLater()

To get notified when a tooltip gets shown or hidden, you can subscribe to the shown and hidden signals:

tooltip.shown.connect(lambda: print('shown'))
tooltip.hidden.connect(lambda: print('hidden'))

Customization

• Setting the widget:

tooltip.setWidget(widget)  # Default: None

• Setting the text:

tooltip.setText('Text of the tooltip')  # Default: ''

• Setting the placement:

tooltip.setPlacement(TooltipPlacement.RIGHT)  # Default: TooltipPlacement.AUTO

AVAILABLE PLACEMENTS:
AUTO, LEFT, RIGHT, TOP, BOTTOM

• Enabling or disabling the triangle:

tooltip.setTriangleEnabled(False)  # Default: True

• Setting the size of the triangle:

tooltip.setTriangleSize(7)  # Default: 5

• Setting a duration:

tooltip.setDuration(1000)  # Default: 0

The duration is the time in milliseconds after which the tooltip will start fading out again. If the duration is set to 0, the tooltip will stay visible for as long as the widget is hovered.

• Adding delays to the fade in / out animations after hovering the widget:

tooltip.setShowDelay(500)  # Default: 50
tooltip.setHideDelay(500)  # Default: 50

• Setting the durations of the fade in / out animations:

tooltip.setFadeInDuration(250)   # Default: 150
tooltip.setFadeOutDuration(250)  # Default: 150

• Setting the refresh rate in Hz:

tooltip.setRefreshRate(30)  # Default: 60

• Setting the border radius:

tooltip.setBorderRadius(0)   # Default: 8

• Enabling or disabling the border:

tooltip.setBorderEnabled(False)   # Default: True

• Setting custom colors:

tooltip.setBackgroundColor(QColor('#FCBA03'))   # Default: QColor('#FFFFFF')
tooltip.setTextColor(QColor('#000000'))         # Default: QColor('#373737')
tooltip.setBorderColor(QColor('#A38329'))       # Default: QColor('#CDCFD6')

• Setting a custom font:

tooltip.setFont(QFont('Consolas', 10))  # Default: QFont('Arial', 9, QFont.Weight.Bold)

• Applying margins to the content of the tooltip:

tooltip.setMargins(QMargins(10, 8, 10, 8))  # Default: QMargins(12, 8, 12, 7)

• Setting a maximum width:

tooltip.setMaximumWidth(150)  # Default: 16777215 (QWIDGETSIZE_MAX)

• Enabling or disabling text centering for wrapped text:

tooltip.setTextCenteringEnabled(False)  # Default: True

• Enabling or disabling the drop shadow:

tooltip.setDropShadowEnabled(False)  # Default: True

• Changing the drop shadow strength:

tooltip.setDropShadowStrength(3.5)  # Default: 2.0

• Making the tooltip translucent:

tooltip.setOpacity(0.8)  # Default: 1.0

Other customization options:

Option	Description	Default
setShowingOnDisabled()	Whether the tooltips should also be shown on disabled widgets	False
setFadeInEasingCurve()	The easing curve of the fade in animation	QEasingCurve.Type.Linear
setFadeOutEasingCurve()	The easing curve of the fade out animation	QEasingCurve.Type.Linear
setMarginLeft()	Set left margin individually	12
setMarginRight()	Set right margin individually	12
setMarginTop()	Set top margin individually	8
setMarginBottom()	Set bottom margin individually	7

Demo

ztooltip_demo.mp4

The demos for PyQt5, PyQt6, and PySide6 can be found in the demo folder.

To keep the demo simple, only the most important features are included. To get an overview of all the customization options, check out the documentation above.

Tests

Installing the required test dependencies PyQt6, pytest, and coveragepy:

pip install PyQt6 pytest coverage

To run the tests with coverage, clone this repository, go into the main directory and run:

coverage run -m pytest
coverage report --ignore-errors -m

License

This software is licensed under the MIT license.