Source code for bokeh.models.ui.tooltips

#-----------------------------------------------------------------------------
# Copyright (c) Anaconda, Inc., and Bokeh Contributors.
# All rights reserved.
#
# The full license is in the file LICENSE.txt, distributed with this software.
#-----------------------------------------------------------------------------
"""

"""

#-----------------------------------------------------------------------------
# Boilerplate
#-----------------------------------------------------------------------------
from __future__ import annotations

import logging # isort:skip
log = logging.getLogger(__name__)

#-----------------------------------------------------------------------------
# Imports
#-----------------------------------------------------------------------------

# Bokeh imports
from ...core.enums import Anchor, TooltipAttachment
from ...core.properties import (
    Auto,
    Bool,
    Either,
    Enum,
    Float,
    Instance,
    Nullable,
    Override,
    Required,
    String,
    Tuple,
)
from ..dom import DOMNode
from ..nodes import Coordinate
from ..selectors import Selector
from .ui_element import UIElement

#-----------------------------------------------------------------------------
# Globals and constants
#-----------------------------------------------------------------------------

__all__ = (
    "Tooltip",
)

#-----------------------------------------------------------------------------
# General API
#-----------------------------------------------------------------------------

[docs] class Tooltip(UIElement): """ Render a tooltip. """ # explicit __init__ to support Init signatures def __init__(self, *args, **kwargs) -> None: super().__init__(*args, **kwargs) visible = Override(default=False) position = Nullable(Either(Enum(Anchor), Tuple(Float, Float), Instance(Coordinate)), default=None, help=""" The position of the tooltip with respect to its parent. It can be either an absolute position within the parent or an anchor point for symbolic positioning. """) target = Either(Instance(UIElement), Instance(Selector), Auto, default="auto", help=""" Tooltip can be manually attached to a target UI element or a DOM node (referred to by a selector, e.g. CSS selector or XPath), or its attachment can be inferred from its parent in ``"auto"`` mode. """) content = Required(Either(String, Instance(DOMNode), Instance(UIElement)), help=""" The tooltip's content. Can be a plaintext string or a :class:`~bokeh.models.HTML` object. """) attachment = Either(Enum(TooltipAttachment), Auto, default="auto", help=""" Whether the tooltip should be displayed to the left or right of the cursor position or above or below it, or if it should be automatically placed in the horizontal or vertical dimension. """) show_arrow = Bool(default=True, help=""" Whether tooltip's arrow should be shown. """) closable = Bool(default=False, help=""" Whether to allow dismissing a tooltip by clicking close (x) button. Useful when using this model for persistent tooltips. """) interactive = Bool(default=True, help=""" Whether to allow pointer events on the contents of this tooltip. Depending on the use case, it may be necessary to disable interactions for better user experience. This however will prevent the user from interacting with the contents of this tooltip, e.g. clicking links. """)
#----------------------------------------------------------------------------- # Dev API #----------------------------------------------------------------------------- #----------------------------------------------------------------------------- # Private API #----------------------------------------------------------------------------- #----------------------------------------------------------------------------- # Code #-----------------------------------------------------------------------------