2.3.2

feat: make range and marks props to work together

README.md

@@ -148,6 +148,12 @@ ReactDOM.render(<Rcslider />, container);
           <td>''</td>
           <td>Set the animation for tooltip if it shows.</td>
         </tr>
+        <tr>
+          <td>tipFormatter</td>
+          <td>func</td>
+          <td></td>
+          <td>Format the value of the tooltip if it shows.</td>
+        </tr>
         <tr>
           <td>dots</td>
           <td>bool</td>

assets/index.less

@@ -146,13 +146,13 @@
       display: none;
     }
 
-    &-placement-points-bc-tc {
+    &-placement-top {
       padding: @tooltip-arrow-width 0 @tooltip-distance 0;
     }
 
     &-inner {
-      padding: 6px 0;
-      width: 24px;
+      padding: 6px 2px;
+      min-width: 24px;
       height: 24px;
       font-size: 12px;
       line-height: 1;
@@ -172,7 +172,7 @@
       border-style: solid;
     }
 
-    &-placement-points-bc-tc &-arrow {
+    &-placement-top &-arrow {
       bottom: @tooltip-distance - @tooltip-arrow-width;
       left: 50%;
       margin-left: -@tooltip-arrow-width;

examples/simple.js

@@ -7,39 +7,52 @@ var ReactDOM = require('react-dom');
 var Slider = require('rc-slider');
 var style = {width:400,margin:50};
 
-function onChange(v) {
-  console.log(v);
+var log = console.log.bind(console);
+
+
+var marks = ["状态1","状态2","状态3","状态4"];
+
+function percentFormatter(v) {
+  return v + " %";
 }
 
 ReactDOM.render(
   <div>
     <div style={style}>
       <p>基础滑块</p>
-      <Slider onChange={onChange} tipTransitionName='rc-slider-tooltip-zoom-down' />
+      <Slider onChange={log} tipTransitionName='rc-slider-tooltip-zoom-down' />
     </div>
     <div style={style}>
       <p>基础滑块，step=20</p>
       <Slider step={20} />
     </div>
     <div style={style}>
-      <p>基础滑块，step=20 带原点</p>
+      <p>基础滑块，step=20 带圆点</p>
       <Slider dots step={20} />
     </div>
     <div style={style}>
       <p>双滑块</p>
-      <Slider range min={10} max={90} defaultValue={[0, 30]} onChange={onChange} />
+      <Slider range min={10} max={90} defaultValue={[0, 30]} onChange={log} />
     </div>
     <div style={style}>
       <p>双滑块，step=20 </p>
-      <Slider range dots step={20} defaultValue={[0, 30]} onChange={onChange} included={false} />
+      <Slider range dots step={20} defaultValue={[0, 30]} onAfterChange={log} included={false} />
     </div>
     <div style={style}>
       <p>分段式滑块（包含关系）</p>
-      <Slider marks={["状态1","状态2","状态3","状态4"]} defaultIndex={1} />
+      <Slider marks={marks} defaultIndex={1} />
+    </div>
+    <div style={style}>
+      <p>分段式滑块 (双)</p>
+      <Slider range marks={marks} onChange={log} defaultIndex={[1,2]} />
     </div>
     <div style={style}>
       <p>分段式滑块（并列关系）</p>
-      <Slider marks={["状态1","状态2","状态3","状态4"]} included={false} defaultIndex={1} />
+      <Slider marks={marks} included={false} defaultIndex={1} />
+    </div>
+    <div style={style}>
+      <p>基础滑块</p>
+      <Slider onChange={log} tipFormatter={percentFormatter} tipTransitionName='rc-slider-tooltip-zoom-down' />
     </div>
   </div>
   , document.getElementById('__react-content'));

package.json

@@ -1,6 +1,6 @@
 {
   "name": "rc-slider",
-  "version": "2.0.1",
+  "version": "2.3.2",
   "description": "slider ui component for react",
   "keywords": [
     "react",
@@ -40,18 +40,18 @@
   "devDependencies": {
     "expect.js": "0.3.x",
     "jquery": "^1.11.2",
-    "precommit-hook": "^1.0.7",
+    "pre-commit": "1.x",
     "rc-server": "3.x",
     "rc-tools": "4.x",
     "react": "~0.14.0",
     "react-addons-test-utils": "^0.14.0",
     "react-dom": "~0.14.0"
   },
-  "precommit": [
+  "pre-commit": [
     "lint"
   ],
   "dependencies": {
-    "rc-tooltip": "~3.0.4",
-    "rc-util": "2.x"
+    "rc-tooltip": "3.x",
+    "rc-util": "3.x"
   }
 }

src/Handle.jsx

@@ -24,7 +24,7 @@ export default class Handle extends React.Component {
 
   render() {
     const props = this.props;
-    const {className, tipTransitionName, offset, value} = props;
+    const {className, tipTransitionName, tipFormatter, offset, value} = props;
     const {dragging, noTip} = props;
 
     const style = { left: offset + '%' };
@@ -40,9 +40,9 @@ export default class Handle extends React.Component {
     const isTooltipVisible = dragging || this.state.isTooltipVisible;
     return (<Tooltip
               prefixCls={className.replace('handle', 'tooltip')}
-              placement={{points: ['bc', 'tc']}}
+              placement="top"
               visible={isTooltipVisible}
-              overlay={<span>{value}</span>}
+              overlay={<span>{tipFormatter ? tipFormatter(value) : value}</span>}
               delay={0}
               transitionName={tipTransitionName}>
               {handle}
@@ -54,6 +54,7 @@ Handle.propTypes = {
   className: React.PropTypes.string,
   offset: React.PropTypes.number,
   tipTransitionName: React.PropTypes.string,
+  tipFormatter: React.PropTypes.func,
   value: React.PropTypes.number,
   dragging: React.PropTypes.bool,
   noTip: React.PropTypes.bool,

src/Slider.jsx

@@ -1,11 +1,12 @@
 import React from 'react';
-import rcUtil, {Dom as DomUtils} from 'rc-util';
+import {Dom as DomUtils, classSet} from 'rc-util';
 import Track from './Track';
 import Handle from './Handle';
 import Steps from './Steps';
 import Marks from './Marks';
 
-function noop() {}
+function noop() {
+}
 
 function isNotTouchEvent(e) {
   return e.touches.length > 1 || (e.type.toLowerCase() === 'touchend' && e.touches.length > 0);
@@ -16,18 +17,20 @@ function getTouchPosition(e) {
 }
 
 function getMousePosition(e) {
-  return e.pageX || (e.clientX + document.documentElement.scrollLeft); // to compat ie8
+  return e.pageX;
 }
 
 function pauseEvent(e) {
-  e.cancelBubble = true;
-  e.returnValue = false;
-  if (e.stopPropagation) {
-    e.stopPropagation();
-  }
-  if (e.preventDefault) {
-    e.preventDefault();
-  }
+  e.stopPropagation();
+  e.preventDefault();
+}
+
+// This is an utility method, tries to get property, then defaultPropery with
+// special check using 'in', because propery can be '0'
+function propOrDefault(props, name, fallback) {
+  const defaultName = 'default' + name.charAt(0).toUpperCase() + name.substring(1);
+  const defaultValue = (defaultName in props ? props[defaultName] : fallback);
+  return (name in props ? props[name] : defaultValue);
 }
 
 class Slider extends React.Component {
@@ -36,18 +39,18 @@ class Slider extends React.Component {
 
     let upperBound;
     let lowerBound;
-    if (props.range) {
-      const value = (props.value || props.defaultValue || [0, 0]);
-      upperBound = this.trimAlignValue(value[1]);
-      lowerBound = this.trimAlignValue(value[0]);
-    } else if (props.marks.length > 0) {
-      upperBound = this.calcValueFromProps(props);
+    const initialValue = props.range ? [0, 0] : 0;
+    if (props.marks.length > 0) {
+      const index = propOrDefault(props, 'index', initialValue);
+      ({lowerBound, upperBound} = this.getBoundsFromIndex(index, props));
     } else {
-      // Note: Maybe `value` is `0`.
-      //       So, check the existence of `value` with `in`.
-      const defaultValue = ('defaultValue' in props ? props.defaultValue : 0);
-      const value = ('value' in props ? props.value : defaultValue);
-      upperBound = this.trimAlignValue(value);
+      const value = propOrDefault(props, 'value', initialValue);
+      if (props.range) {
+        lowerBound = this.trimAlignValue(value[0]);
+        upperBound = this.trimAlignValue(value[1]);
+      } else {
+        upperBound = this.trimAlignValue(value);
+      }
     }
 
     let recent;
@@ -85,9 +88,8 @@ class Slider extends React.Component {
         upperBound: nextProps.value,
       });
     } else if ('index' in nextProps) {
-      this.setState({
-        upperBound: this.calcValueFromProps(nextProps),
-      });
+      const index = ('index' in nextProps ? nextProps.index : nextProps.defaultIndex);
+      this.setState(this.getBoundsFromIndex(index, nextProps));
     }
   }
 
@@ -119,21 +121,9 @@ class Slider extends React.Component {
     if (value === oldValue) return;
 
     if (!('value' in props) && !('index' in props)) {
-      this.setState({[state.handle]: value});
-    }
-
-    if (props.range) {
-      // `this.state` will not be updated immediately after `this.setState`.
-      // So, create a similar object.
-      // const data = Object.assign({}, state, {[state.handle]: value});
-      const data = {
-        upperBound: state.upperBound,
-        lowerBound: state.lowerBound,
-      };
-      data[state.handle] = value;
-      this.triggerEvents('onChange', [data.lowerBound, data.upperBound]);
-    } else {
-      this.triggerEvents('onChange', value);
+      this.setState({[state.handle]: value}, () => {
+        this.triggerEvents('onChange', this.getValue());
+      });
     }
   }
 
@@ -184,19 +174,14 @@ class Slider extends React.Component {
       handle: valueNeedChanging,
       recent: valueNeedChanging,
       [valueNeedChanging]: value,
+    }, () => {
+      this.triggerEvents('onChange', this.getValue());
     });
+  }
 
-    if (this.props.range) {
-      // const data = Object.assign({}, state, {[valueNeedChanging]: value});
-      const data = {
-        upperBound: state.upperBound,
-        lowerBound: state.lowerBound,
-      };
-      data[valueNeedChanging] = value;
-      this.triggerEvents('onChange', [data.lowerBound, data.upperBound]);
-    } else {
-      this.triggerEvents('onChange', value);
-    }
+  getValue() {
+    const {lowerBound, upperBound} = this.state;
+    return this.props.range ? [lowerBound, upperBound] : upperBound;
   }
 
   getIndex(value) {
@@ -209,6 +194,18 @@ class Slider extends React.Component {
     return Math.round(value / unit);
   }
 
+  getBoundsFromIndex(value, props) {
+    if (props.range) {
+      return {
+        lowerBound: this.calcValueFromIndex(value[0], props),
+        upperBound: this.calcValueFromIndex(value[1], props),
+      };
+    }
+    return {
+      upperBound: this.calcValueFromIndex(value, props),
+    };
+  }
+
   getSliderLength() {
     const slider = this.refs.slider;
     if (!slider) {
@@ -273,10 +270,9 @@ class Slider extends React.Component {
     return nextValue;
   }
 
-  calcValueFromProps(props) {
+  calcValueFromIndex(index, props) {
     const marksLen = props.marks.length;
     if (marksLen > 0) {
-      const index = ('index' in props ? props.index : props.defaultIndex);
       const value = ((props.max - props.min) / (marksLen - 1)) * (index);
       // `'1' / 1 => 1`, to make sure that the returned value is a `Number`.
       return value.toFixed(5) / 1;
@@ -290,7 +286,11 @@ class Slider extends React.Component {
     if (props[event]) {
       let data;
       if (hasMarks) {
-        data = this.getIndex(v);
+        if (props.range) {
+          data = v.map(bound => this.getIndex(bound));
+        } else {
+          data = this.getIndex(v);
+        }
       } else if (v === undefined) {
         data = this.state.value;
       } else {
@@ -323,18 +323,18 @@ class Slider extends React.Component {
 
   end(type) {
     this.removeEventons(type);
-    this.triggerEvents('onAfterChange');
-    this.setState({ handle: null });
+    this.triggerEvents('onAfterChange', this.getValue());
+    this.setState({handle: null});
   }
 
   render() {
     const {handle, upperBound, lowerBound} = this.state;
     const props = this.props;
-    const {className, prefixCls, disabled, included, isIncluded, dots, withDots, range} = props;
-    const {marks, step, max, min, tipTransitionName, children} = props;
+    const {className, prefixCls, disabled, included, isIncluded, dots, range} = props;
+    const {marks, step, max, min, tipTransitionName, tipFormatter, children} = props;
     const marksLen = marks.length;
 
-    const sliderClassName = rcUtil.classSet({
+    const sliderClassName = classSet({
       [prefixCls]: true,
       [prefixCls + '-disabled']: disabled,
       [className]: !!className,
@@ -346,42 +346,42 @@ class Slider extends React.Component {
     let track = null;
     if ((included && isIncluded) || range) {
       const trackClassName = prefixCls + '-track';
-      track = <Track className={trackClassName} offset={lowerOffset} length={upperOffset - lowerOffset} />;
+      track = <Track className={trackClassName} offset={lowerOffset} length={upperOffset - lowerOffset}/>;
     }
 
     const handleClassName = prefixCls + '-handle';
-    const isNoTip = marksLen > 0;
-    const upper = (<Handle className={handleClassName} tipTransitionName={tipTransitionName} noTip={isNoTip}
+    const isNoTip = (marksLen > 0) && !tipFormatter;
+    const upper = (<Handle className={handleClassName} tipTransitionName={tipTransitionName} noTip={isNoTip} tipFormatter={tipFormatter}
                      offset={upperOffset} value={upperBound} dragging={handle === 'upperBound'} />);
 
     let lower = null;
     if (range) {
-      lower = (<Handle className={handleClassName} tipTransitionName={tipTransitionName} noTip={isNoTip}
+      lower = (<Handle className={handleClassName} tipTransitionName={tipTransitionName} noTip={isNoTip} tipFormatter={tipFormatter}
                  offset={lowerOffset} value={lowerBound} dragging={handle === 'lowerBound'} />);
     }
 
     const upperIndex = this.getIndex(upperBound);
 
     let steps = null;
-    if (marksLen > 0 || (step > 1 && (dots || withDots))) {
+    if (marksLen > 0 || (step > 1 && dots)) {
       const stepsClassName = prefixCls + '-step';
       const stepNum = marksLen > 0 ? marksLen : Math.floor((max - min) / step) + 1;
       steps = (<Steps className={stepsClassName} stepNum={stepNum}
-                 lowerIndex={this.getIndex(lowerBound)} upperIndex={upperIndex}
-                 included={(included && isIncluded) || range} />);
+                      lowerIndex={this.getIndex(lowerBound)} upperIndex={upperIndex}
+                      included={(included && isIncluded) || range}/>);
     }
 
     let mark = null;
     if (marksLen > 0) {
       const markClassName = prefixCls + '-mark';
       mark = (<Marks className={markClassName} marks={marks}
-                index={upperIndex} included={(included && isIncluded)} />);
+                     index={upperIndex} included={(included && isIncluded)}/>);
     }
 
     return (
       <div ref="slider" className={sliderClassName}
-        onTouchStart={disabled ? noop : this.onTouchStart.bind(this)}
-        onMouseDown={disabled ? noop : this.onSliderMouseDown.bind(this)}>
+           onTouchStart={disabled ? noop : this.onTouchStart.bind(this)}
+           onMouseDown={disabled ? noop : this.onSliderMouseDown.bind(this)}>
         {track}
         {upper}
         {lower}
@@ -401,12 +401,18 @@ Slider.propTypes = {
     React.PropTypes.number,
     React.PropTypes.arrayOf(React.PropTypes.number),
   ]),
-  defaultIndex: React.PropTypes.number,
+  defaultIndex: React.PropTypes.oneOfType([
+    React.PropTypes.number,
+    React.PropTypes.arrayOf(React.PropTypes.number),
+  ]),
   value: React.PropTypes.oneOfType([
     React.PropTypes.number,
     React.PropTypes.arrayOf(React.PropTypes.number),
   ]),
-  index: React.PropTypes.number,
+  index: React.PropTypes.oneOfType([
+    React.PropTypes.number,
+    React.PropTypes.arrayOf(React.PropTypes.number),
+  ]),
   marks: React.PropTypes.array,
   isIncluded: React.PropTypes.bool, // @Deprecated
   included: React.PropTypes.bool,
@@ -418,7 +424,7 @@ Slider.propTypes = {
   onChange: React.PropTypes.func,
   onAfterChange: React.PropTypes.func,
   tipTransitionName: React.PropTypes.string,
-  withDots: React.PropTypes.bool, // @Deprecated
+  tipFormatter: React.PropTypes.func,
   dots: React.PropTypes.bool,
   range: React.PropTypes.bool,
 };
@@ -435,7 +441,6 @@ Slider.defaultProps = {
   prefixCls: 'rc-slider',
   disabled: false,
   tipTransitionName: '',
-  withDots: false, // @Deprecated
   dots: false,
   range: false,
 };