#-----------------------------------------------------------------------------
# Copyright (c) 2012 - 2019, Anaconda, Inc., and Bokeh Contributors.
# All rights reserved.
#
# The full license is in the file LICENSE.txt, distributed with this software.
#-----------------------------------------------------------------------------
''' Various kinds of button widgets.
'''
#-----------------------------------------------------------------------------
# Boilerplate
#-----------------------------------------------------------------------------
from __future__ import absolute_import, division, print_function, unicode_literals
import logging
log = logging.getLogger(__name__)
#-----------------------------------------------------------------------------
# Imports
#-----------------------------------------------------------------------------
# Standard library imports
# External imports
# Bokeh imports
from ...core.enums import ButtonType
from ...core.has_props import abstract, HasProps
from ...core.properties import Bool, Enum, Instance, List, Override, String, Tuple, Either, Int
from ...events import ButtonClick, MenuItemClick
from ..callbacks import Callback
from .icons import AbstractIcon
from .widget import Widget
#-----------------------------------------------------------------------------
# Globals and constants
#-----------------------------------------------------------------------------
__all__ = (
'AbstractButton',
'Button',
'ButtonLike',
'Dropdown',
'Toggle',
)
#-----------------------------------------------------------------------------
# Dev API
#-----------------------------------------------------------------------------
#-----------------------------------------------------------------------------
# General API
#-----------------------------------------------------------------------------
[docs]class Toggle(AbstractButton):
''' A two-state toggle button.
'''
label = Override(default="Toggle")
active = Bool(False, help="""
The initial state of a button. Also used to trigger ``on_click`` event
handler.
""")
[docs] def on_click(self, handler):
""" Set up a handler for button state changes (clicks).
Args:
handler (func) : handler function to call when button is toggled.
Returns:
None
"""
self.on_change('active', lambda attr, old, new: handler(new))
[docs] def js_on_click(self, handler):
""" Set up a JavaScript handler for button state changes (clicks). """
self.js_on_change('active', handler)
[docs]class Dropdown(AbstractButton):
''' A dropdown button.
'''
label = Override(default="Dropdown")
split = Bool(default=False, help="""
""")
menu = List(Either(String, Tuple(String, Either(String, Instance(Callback)))), help="""
Button's dropdown menu consisting of entries containing item's text and
value name. Use ``None`` as a menu separator.
""")
[docs] def on_click(self, handler):
''' Set up a handler for button or menu item clicks.
Args:
handler (func) : handler function to call when button is activated.
Returns:
None
'''
self.on_event(ButtonClick, handler)
self.on_event(MenuItemClick, handler)
[docs] def js_on_click(self, handler):
''' Set up a JavaScript handler for button or menu item clicks. '''
self.js_on_event(ButtonClick, handler)
self.js_on_event(MenuItemClick, handler)
value = String(help="""
A private property that used to trigger ``on_click`` event handler.
.. note:
This property is deprecated and left for backwards compatibility. Use
``dropdown.on_click()`` or ``dropdown.js_on_click()`` methods in new code.
""")
default_value = String(help="""
A default value to set when a split Dropdown's top button is clicked.
Setting this property will cause the Dropdown to be rendered as split.
.. note:
This property is deprecated and left for backwards compatibility. Use
``dropdown.on_click()`` or ``dropdown.js_on_click()`` methods in new code.
""")
#-----------------------------------------------------------------------------
# Private API
#-----------------------------------------------------------------------------
#-----------------------------------------------------------------------------
# Code
#-----------------------------------------------------------------------------