Slider component

src/components/sliders/attributes.js

@@ -0,0 +1,266 @@
+/**
+* Copyright 2012-2016, Plotly, Inc.
+* All rights reserved.
+*
+* This source code is licensed under the MIT license found in the
+* LICENSE file in the root directory of this source tree.
+*/
+
+'use strict';
+
+var fontAttrs = require('../../plots/font_attributes');
+var padAttrs = require('../../plots/pad_attributes');
+var extendFlat = require('../../lib/extend').extendFlat;
+var animationAttrs = require('../../plots/animation_attributes');
+var constants = require('./constants');
+
+var stepsAttrs = {
+    _isLinkedToArray: true,
+
+    method: {
+        valType: 'enumerated',
+        values: ['restyle', 'relayout', 'animate', 'update'],
+        dflt: 'restyle',
+        role: 'info',
+        description: [
+            'Sets the Plotly method to be called when the slider value is changed.'
+        ].join(' ')
+    },
+    args: {
+        valType: 'info_array',
+        role: 'info',
+        freeLength: true,
+        items: [
+            { valType: 'any' },
+            { valType: 'any' },
+            { valType: 'any' }
+        ],
+        description: [
+            'Sets the arguments values to be passed to the Plotly',
+            'method set in `method` on slide.'
+        ].join(' ')
+    },
+    label: {
+        valType: 'string',
+        role: 'info',
+        description: 'Sets the text label to appear on the slider'
+    },
+    value: {
+        valType: 'string',
+        role: 'info',
+        description: [
+            'Sets the value of the slider step, used to refer to the step programatically.',
+            'Defaults to the slider label if not provided.'
+        ].join(' ')
+    }
+};
+
+module.exports = {
+    visible: {
+        valType: 'boolean',
+        role: 'info',
+        dflt: true,
+        description: [
+            'Determines whether or not the slider is visible.'
+        ].join(' ')
+    },
+
+    active: {
+        valType: 'number',
+        role: 'info',
+        min: -10,
+        dflt: 0,
+        description: [
+            'Determines which button (by index starting from 0) is',
+            'considered active.'
+        ].join(' ')
+    },
+
+    steps: stepsAttrs,
+
+    lenmode: {
+        valType: 'enumerated',
+        values: ['fraction', 'pixels'],
+        role: 'info',
+        dflt: 'fraction',
+        description: [
+            'Determines whether this slider length',
+            'is set in units of plot *fraction* or in *pixels.',
+            'Use `len` to set the value.'
+        ].join(' ')
+    },
+    len: {
+        valType: 'number',
+        min: 0,
+        dflt: 1,
+        role: 'style',
+        description: [
+            'Sets the length of the slider',
+            'This measure excludes the padding of both ends.',
+            'That is, the slider\'s length is this length minus the',
+            'padding on both ends.'
+        ].join(' ')
+    },
+    x: {
+        valType: 'number',
+        min: -2,
+        max: 3,
+        dflt: -0.05,
+        role: 'style',
+        description: 'Sets the x position (in normalized coordinates) of the slider.'
+    },
+    pad: extendFlat({}, padAttrs, {
+        description: 'Set the padding of the slider component along each side.'
+    }),
+    xanchor: {
+        valType: 'enumerated',
+        values: ['auto', 'left', 'center', 'right'],
+        dflt: 'left',
+        role: 'info',
+        description: [
+            'Sets the slider\'s horizontal position anchor.',
+            'This anchor binds the `x` position to the *left*, *center*',
+            'or *right* of the range selector.'
+        ].join(' ')
+    },
+    y: {
+        valType: 'number',
+        min: -2,
+        max: 3,
+        dflt: 1,
+        role: 'style',
+        description: 'Sets the y position (in normalized coordinates) of the slider.'
+    },
+    yanchor: {
+        valType: 'enumerated',
+        values: ['auto', 'top', 'middle', 'bottom'],
+        dflt: 'bottom',
+        role: 'info',
+        description: [
+            'Sets the slider\'s vertical position anchor',
+            'This anchor binds the `y` position to the *top*, *middle*',
+            'or *bottom* of the range selector.'
+        ].join(' ')
+    },
+
+    transition: {
+        duration: {
+            valType: 'number',
+            role: 'info',
+            min: 0,
+            dflt: 150,
+            description: 'Sets the duration of the slider transition'
+        },
+        easing: {
+            valType: 'enumerated',
+            values: animationAttrs.transition.easing.values,
+            role: 'info',
+            dflt: 'cubic-in-out',
+            description: 'Sets the easing function of the slider transition'
+        },
+    },
+
+    currentvalue: {
+        visible: {
+            valType: 'boolean',
+            role: 'info',
+            dflt: true,
+            description: [
+                'Shows the currently-selected value above the slider.'
+            ].join(' ')
+        },
+
+        xanchor: {
+            valType: 'enumerated',
+            values: ['left', 'center', 'right'],
+            dflt: 'left',
+            role: 'info',
+            description: [
+                'The alignment of the value readout relative to the length of the slider.'
+            ].join(' ')
+        },
+
+        offset: {
+            valType: 'number',
+            dflt: 10,
+            role: 'info',
+            description: [
+                'The amount of space, in pixels, between the current value label',
+                'and the slider.'
+            ].join(' ')
+        },
+
+        prefix: {
+            valType: 'string',
+            role: 'info',
+            description: [
+                'When currentvalue.visible is true, this sets the prefix of the lable. If provided,',
+                'it will be joined to the current value with a single space between.'
+            ].join(' ')
+        },
+
+        font: extendFlat({}, fontAttrs, {
+            description: 'Sets the font of the current value lable text.'
+        }),
+    },
+
+    font: extendFlat({}, fontAttrs, {
+        description: 'Sets the font of the slider step labels.'
+    }),
+
+    activebgcolor: {
+        valType: 'color',
+        role: 'style',
+        dflt: constants.gripBgActiveColor,
+        description: [
+            'Sets the background color of the slider grip',
+            'while dragging.'
+        ].join(' ')
+    },
+    bgcolor: {
+        valType: 'color',
+        role: 'style',
+        dflt: constants.railBgColor,
+        description: 'Sets the background color of the slider.'
+    },
+    bordercolor: {
+        valType: 'color',
+        dflt: constants.railBorderColor,
+        role: 'style',
+        description: 'Sets the color of the border enclosing the slider.'
+    },
+    borderwidth: {
+        valType: 'number',
+        min: 0,
+        dflt: constants.railBorderWidth,
+        role: 'style',
+        description: 'Sets the width (in px) of the border enclosing the slider.'
+    },
+    ticklen: {
+        valType: 'number',
+        min: 0,
+        dflt: constants.tickLength,
+        role: 'style',
+        description: 'Sets the length in pixels of step tick marks'
+    },
+    tickcolor: {
+        valType: 'color',
+        dflt: constants.tickColor,
+        role: 'style',
+        description: 'Sets the color of the border enclosing the slider.'
+    },
+    tickwidth: {
+        valType: 'number',
+        min: 0,
+        dflt: 1,
+        role: 'style',
+        description: 'Sets the tick width (in px).'
+    },
+    minorticklen: {
+        valType: 'number',
+        min: 0,
+        dflt: constants.minorTickLength,
+        role: 'style',
+        description: 'Sets the length in pixels of minor step tick marks'
+    },
+};

src/components/sliders/constants.js

@@ -0,0 +1,96 @@
+/**
+* Copyright 2012-2016, Plotly, Inc.
+* All rights reserved.
+*
+* This source code is licensed under the MIT license found in the
+* LICENSE file in the root directory of this source tree.
+*/
+
+
+'use strict';
+
+
+module.exports = {
+
+    // layout attribute names
+    name: 'sliders',
+    itemName: 'slider',
+
+    // class names
+    containerClassName: 'slider-container',
+    groupClassName: 'slider-group',
+    inputAreaClass: 'slider-input-area',
+    railRectClass: 'slider-rail-rect',
+    railTouchRectClass: 'slider-rail-touch-rect',
+    gripRectClass: 'slider-grip-rect',
+    tickRectClass: 'slider-tick-rect',
+    inputProxyClass: 'slider-input-proxy',
+    labelsClass: 'slider-labels',
+    labelGroupClass: 'slider-label-group',
+    labelClass: 'slider-label',
+    currentValueClass: 'slider-current-value',
+
+    railHeight: 5,
+
+    // DOM attribute name in button group keeping track
+    // of active update menu
+    menuIndexAttrName: 'slider-active-index',
+
+    // id root pass to Plots.autoMargin
+    autoMarginIdRoot: 'slider-',
+
+    // min item width / height
+    minWidth: 30,
+    minHeight: 30,
+
+    // padding around item text
+    textPadX: 40,
+
+    // font size to height scale
+    fontSizeToHeight: 1.3,
+
+    // arrow offset off right edge
+    arrowOffsetX: 4,
+
+    railRadius: 2,
+    railWidth: 5,
+    railBorder: 4,
+    railBorderWidth: 1,
+    railBorderColor: '#bec8d9',
+    railBgColor: '#f8fafc',
+
+    // The distance of the rail from the edge of the touchable area
+    // Slightly less than the step inset because of the curved edges
+    // of the rail
+    railInset: 8,
+
+    // The distance from the extremal tick marks to the edge of the
+    // touchable area. This is basically the same as the grip radius,
+    // but for other styles it wouldn't really need to be.
+    stepInset: 10,
+
+    gripRadius: 10,
+    gripWidth: 20,
+    gripHeight: 20,
+    gripBorder: 20,
+    gripBorderWidth: 1,
+    gripBorderColor: '#bec8d9',
+    gripBgColor: '#f6f8fa',
+    gripBgActiveColor: '#dbdde0',
+
+    labelPadding: 8,
+    labelOffset: 0,
+
+    tickWidth: 1,
+    tickColor: '#333',
+    tickOffset: 25,
+    tickLength: 7,
+
+    minorTickOffset: 25,
+    minorTickColor: '#333',
+    minorTickLength: 4,
+
+    // Extra space below the current value label:
+    currentValuePadding: 8,
+    currentValueInset: 0,
+};