diff --git a/IPython/html/widgets/widget_bool.py b/IPython/html/widgets/widget_bool.py index 87f1efd53..e21ad3d99 100644 --- a/IPython/html/widgets/widget_bool.py +++ b/IPython/html/widgets/widget_bool.py @@ -29,13 +29,29 @@ class _Bool(DOMWidget): @register('IPython.Checkbox') class Checkbox(_Bool): - """Displays a boolean `value`.""" + """Displays a boolean `value` in the form of a checkbox. + + Parameters + ---------- + value : {True,False} + value of the checkbox: True-checked, False-unchecked + description : str + description displayed next to the checkbox +""" _view_name = Unicode('CheckboxView', sync=True) @register('IPython.ToggleButton') class ToggleButton(_Bool): - """Displays a boolean `value`.""" + """Displays a boolean `value` in the form of a toggle button. + + Parameters + ---------- + value : {True,False} + value of the toggle button: True-pressed, False-unpressed + description : str + description displayed next to the button +""" _view_name = Unicode('ToggleButtonView', sync=True) tooltip = Unicode(help="Tooltip caption of the toggle button.", sync=True) diff --git a/IPython/html/widgets/widget_float.py b/IPython/html/widgets/widget_float.py index 01395ec4c..eab4f6663 100644 --- a/IPython/html/widgets/widget_float.py +++ b/IPython/html/widgets/widget_float.py @@ -45,16 +45,67 @@ class _BoundedFloat(_Float): @register('IPython.FloatText') class FloatText(_Float): + """ Displays a float value within a textbox. For a textbox in + which the value must be within a specific range, use BoundedFloatText. + + Parameters + ---------- + value : float + value displayed + description : str + description displayed next to the textbox + color : str Unicode color code (eg. '#C13535'), optional + color of the value displayed + """ _view_name = Unicode('FloatTextView', sync=True) @register('IPython.BoundedFloatText') class BoundedFloatText(_BoundedFloat): + """ Displays a float value within a textbox. Value must be within the range specified. + For a textbox in which the value doesn't need to be within a specific range, use FloatText. + + Parameters + ---------- + value : float + value displayed + min : float + minimal value of the range of possible values displayed + max : float + maximal value of the range of possible values displayed + description : str + description displayed next to the textbox + color : str Unicode color code (eg. '#C13535'), optional + color of the value displayed + """ _view_name = Unicode('FloatTextView', sync=True) @register('IPython.FloatSlider') class FloatSlider(_BoundedFloat): + """ Slider/trackbar of floating values with the specified range. + + Parameters + ---------- + value : float + position of the slider + min : float + minimal position of the slider + max : float + maximal position of the slider + step : float + step of the trackbar + description : str + name of the slider + orientation : {'vertical', 'horizontal}, optional + default is horizontal + readout : {True, False}, optional + default is True, display the current value of the slider next to it + slider_color : str Unicode color code (eg. '#C13535'), optional + color of the slider + color : str Unicode color code (eg. '#C13535'), optional + color of the value displayed (if readout == True) + """ _view_name = Unicode('FloatSliderView', sync=True) orientation = CaselessStrEnum(values=['horizontal', 'vertical'], default_value='horizontal', @@ -66,6 +117,24 @@ class FloatSlider(_BoundedFloat): @register('IPython.FloatProgress') class FloatProgress(_BoundedFloat): + """ Displays a progress bar. + + Parameters + ----------- + value : float + position within the range of the progress bar + min : float + minimal position of the slider + max : float + maximal position of the slider + step : float + step of the progress bar + description : str + name of the progress bar + bar_style: {'success', 'info', 'warning', 'danger', ''}, optional + color of the progress bar, default is '' (blue) + colors are: 'success'-green, 'info'-light blue, 'warning'-orange, 'danger'-red +""" _view_name = Unicode('ProgressView', sync=True) bar_style = CaselessStrEnum( @@ -169,6 +238,29 @@ class _BoundedFloatRange(_FloatRange): @register('IPython.FloatRangeSlider') class FloatRangeSlider(_BoundedFloatRange): + """ Slider/trackbar for displaying a floating value range (within the specified range of values). + + Parameters + ---------- + value : float tuple + range of the slider displayed + min : float + minimal position of the slider + max : float + maximal position of the slider + step : float + step of the trackbar + description : str + name of the slider + orientation : {'vertical', 'horizontal}, optional + default is horizontal + readout : {True, False}, optional + default is True, display the current value of the slider next to it + slider_color : str Unicode color code (eg. '#C13535'), optional + color of the slider + color : str Unicode color code (eg. '#C13535'), optional + color of the value displayed (if readout == True) + """ _view_name = Unicode('FloatSliderView', sync=True) orientation = CaselessStrEnum(values=['horizontal', 'vertical'], default_value='horizontal', allow_none=False,