#-----------------------------------------------------------------------------
# Copyright (c) Anaconda, Inc., and Bokeh Contributors.
# All rights reserved.
#
# The full license is in the file LICENSE.txt, distributed with this software.
#-----------------------------------------------------------------------------
""" Base classes for the various kinds of renderer types.
"""
#-----------------------------------------------------------------------------
# Boilerplate
#-----------------------------------------------------------------------------
from __future__ import annotations
import logging # isort:skip
log = logging.getLogger(__name__)
#-----------------------------------------------------------------------------
# Imports
#-----------------------------------------------------------------------------
# Standard library imports
from typing import Any
# Bokeh imports
from ...core.enums import RenderLevel
from ...core.has_props import abstract
from ...core.properties import (
Bool,
Either,
Enum,
Instance,
List,
Nullable,
Override,
String,
)
from ...model import Model
from ..coordinates import CoordinateMapping
from ..ui.ui_element import StyledElement
#-----------------------------------------------------------------------------
# Globals and constants
#-----------------------------------------------------------------------------
__all__ = (
"CompositeRenderer",
"DataRenderer",
"GuideRenderer",
"Renderer",
"RendererGroup",
)
#-----------------------------------------------------------------------------
# General API
#-----------------------------------------------------------------------------
[docs]
class RendererGroup(Model):
"""A collection of renderers.
"""
# explicit __init__ to support Init signatures
def __init__(self, *args, **kwargs) -> None:
super().__init__(*args, **kwargs)
visible = Bool(default=True, help="""
Makes all grouped renderers visible or not.
""")
#-----------------------------------------------------------------------------
# Dev API
#-----------------------------------------------------------------------------
[docs]
@abstract
class Renderer(StyledElement):
"""An abstract base class for renderer types.
"""
# explicit __init__ to support Init signatures
def __init__(self, *args, **kwargs) -> None:
super().__init__(*args, **kwargs)
level = Enum(RenderLevel, help="""
Specifies the level in which to paint this renderer.
""")
visible = Bool(default=True, help="""
Is the renderer visible.
""")
coordinates = Nullable(Instance(CoordinateMapping))
x_range_name = String("default", help="""
A particular (named) x-range to use for computing screen locations when
rendering glyphs on the plot. If unset, use the default x-range.
""")
y_range_name = String("default", help="""
A particular (named) y-range to use for computing screen locations when
rendering glyphs on the plot. If unset, use the default y-range.
""")
group = Nullable(Instance(RendererGroup), help="""
.. note::
This property is experimental and may change at any point.
""")
propagate_hover = Bool(default=False, help="""
Allows to propagate hover events to the parent renderer, frame or canvas.
.. note::
This property is experimental and may change at any point.
""")
context_menu = Nullable(Instance(".models.ui.Menu"), default=None, help="""
A menu to display when user right clicks on the component.
.. note::
Use shift key when right clicking to display the native context menu.
""")
[docs]
@abstract
class CompositeRenderer(Renderer):
""" A renderer that allows attaching other renderers and DOM-based UIs.
"""
# explicit __init__ to support Init signatures
def __init__(self, *args: Any, **kwargs: Any) -> None:
super().__init__(*args, **kwargs)
renderers = List(Instance(Renderer), default=[], help="""
A collection of renderers attached to this renderer.
.. note::
This property is experimental and may change at any point.
""")
elements = List(
Either(
Instance(".models.ui.UIElement"),
Instance(".models.dom.DOMNode"),
),
)(default=[], help="""
A collection of DOM-based UI elements attached to this renderer.
This can include floating elements like tooltips, allowing to establish
a parent-child relationship between this renderer and its UI elements.
.. note::
This property is an equivalent of ``Pane.elements`` in DOM-based UIs.
""")
[docs]
@abstract
class DataRenderer(Renderer):
""" An abstract base class for data renderer types (e.g. ``GlyphRenderer``, ``GraphRenderer``).
"""
# explicit __init__ to support Init signatures
def __init__(self, *args, **kwargs) -> None:
super().__init__(*args, **kwargs)
level = Override(default="glyph")
[docs]
@abstract
class GuideRenderer(Renderer):
""" A base class for all guide renderer types. ``GuideRenderer`` is
not generally useful to instantiate on its own.
"""
# explicit __init__ to support Init signatures
def __init__(self, *args, **kwargs) -> None:
super().__init__(*args, **kwargs)
level = Override(default="guide")
#-----------------------------------------------------------------------------
# Private API
#-----------------------------------------------------------------------------
#-----------------------------------------------------------------------------
# Code
#-----------------------------------------------------------------------------