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

@@ -151,8 +151,8 @@
     }
 
     &-inner {
-      padding: 6px 0;
-      width: 24px;
+      padding: 6px 2px;
+      min-width: 24px;
       height: 24px;
       font-size: 12px;
       line-height: 1;

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.1.0",
+  "version": "2.3.2",
   "description": "slider ui component for react",
   "keywords": [
     "react",

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 + '%' };
@@ -42,7 +42,7 @@ export default class Handle extends React.Component {
               prefixCls={className.replace('handle', 'tooltip')}
               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

@@ -25,24 +25,32 @@ function pauseEvent(e) {
   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 {
   constructor(props) {
     super(props);
 
     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;
@@ -80,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));
     }
   }
 
@@ -114,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());
+      });
     }
   }
 
@@ -179,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) {
@@ -204,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) {
@@ -268,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;
@@ -285,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 {
@@ -318,15 +323,15 @@ class Slider extends React.Component {
 
   end(type) {
     this.removeEventons(type);
-    this.triggerEvents('onAfterChange');
+    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 = classSet({
@@ -345,20 +350,20 @@ class Slider extends React.Component {
     }
 
     const handleClassName = prefixCls + '-handle';
-    const isNoTip = marksLen > 0;
-    const upper = (<Handle className={handleClassName} tipTransitionName={tipTransitionName} noTip={isNoTip}
-                           offset={upperOffset} value={upperBound} dragging={handle === 'upperBound'}/>);
+    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}
-                       offset={lowerOffset} value={lowerBound} dragging={handle === 'lowerBound'}/>);
+      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}
@@ -396,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,
@@ -413,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,
 };
@@ -430,7 +441,6 @@ Slider.defaultProps = {
   prefixCls: 'rc-slider',
   disabled: false,
   tipTransitionName: '',
-  withDots: false, // @Deprecated
   dots: false,
   range: false,
 };