fix: handle edge cases for disabled array feature

- Fix README.md wording for disabled prop description
- Remove empty div in disabled-handle example
- Fix triggerChange to correctly handle duplicate values when syncing disabled array
- Fix useOffset to prevent pushing disabled handles in pushable mode

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: 刘欢

README.md

@@ -108,7 +108,7 @@ The following APIs are shared by Slider and Range.
 | handle | (props) => React.ReactNode | | A handle generator which could be used to customized handle. |
 | included | boolean | `true` | If the value is `true`, it means a continuous value interval, otherwise, it is a independent value. |
 | reverse | boolean | `false` | If the value is `true`, it means the component is rendered reverse. |
-| disabled | boolean \| boolean[] | `false` | If `true`, handles can't be moved. Can also be an array to disable specific handles in range mode, e.g. `[true, false, true]` disables first and third handles. |
+| disabled | boolean \| boolean[] | `false` | If `true`, handles can't be moved. This prop can also be an array to disable specific handles in range mode, e.g. `[true, false, true]` disables first and third handles. |
 | keyboard | boolean | `true` | Support using keyboard to move handlers. |
 | dots | boolean | `false` | When the `step` value is greater than 1, you can set the `dots` to  `true` if you want to render the slider with dots. |
 | onBeforeChange | Function | NOOP | `onBeforeChange` will be triggered when `ontouchstart` or `onmousedown` is triggered. |

docs/examples/disabled-handle.tsx

@@ -111,9 +111,6 @@ export default () => (
     <div>
       single handle disabled
       <SingleSlider />
-    </div>
-    <div>
-
     </div>
     <div style={style}>
       <h3>Disabled Handle + Draggable Track</h3>

src/Slider.tsx

@@ -329,12 +329,32 @@ const Slider = React.forwardRef<SliderRef, SliderProps<number | number[]>>((prop
     ) {
       const newDisabled = [...rawDisabled];
 
+      // Find the first index where arrays differ (handles duplicate values correctly)
+      const findDiffIndex = (arr1: number[], arr2: number[]) => {
+        const maxLen = Math.max(arr1.length, arr2.length);
+        for (let i = 0; i < maxLen; i++) {
+          // Count occurrences up to current index
+          const count1 = arr1.slice(0, i + 1).filter((v) => v === arr1[i]).length;
+          const count2 = arr2.filter((v) => v === arr1[i]).length;
+          if (count1 > count2) {
+            return i;
+          }
+        }
+        return -1;
+      };
+
       if (cloneNextValues.length > rawValues.length) {
-        const index = cloneNextValues.findIndex((item) => !rawValues.includes(item));
-        newDisabled.splice(index, 0, false);
+        // Handle added
+        const index = findDiffIndex(cloneNextValues, rawValues);
+        if (index !== -1) {
+          newDisabled.splice(index, 0, false);
+        }
       } else if (cloneNextValues.length < rawValues.length) {
-        const index = rawValues.findIndex((item) => !cloneNextValues.includes(item));
-        newDisabled.splice(index, 1);
+        // Handle removed
+        const index = findDiffIndex(rawValues, cloneNextValues);
+        if (index !== -1) {
+          newDisabled.splice(index, 1);
+        }
       }
 
       onDisabledChange?.(newDisabled);

src/hooks/useOffset.ts

@@ -244,33 +244,45 @@ export default function useOffset(
       // =============== Push ==================
 
       // >>>>>> Basic push
-      // End values
+      // End values (skip disabled handles)
       for (let i = valueIndex + 1; i < nextValues.length; i += 1) {
+        if (isHandleDisabled?.(i)) {
+          break; // Stop pushing when hitting a disabled handle
+        }
         let changed = true;
         while (needPush(nextValues[i] - nextValues[i - 1]) && changed) {
           ({ value: nextValues[i], changed } = offsetChangedValue(nextValues, 1, i));
         }
       }
 
-      // Start values
+      // Start values (skip disabled handles)
       for (let i = valueIndex; i > 0; i -= 1) {
+        if (isHandleDisabled?.(i - 1)) {
+          break; // Stop pushing when hitting a disabled handle
+        }
         let changed = true;
         while (needPush(nextValues[i] - nextValues[i - 1]) && changed) {
           ({ value: nextValues[i - 1], changed } = offsetChangedValue(nextValues, -1, i - 1));
         }
       }
 
       // >>>>> Revert back to safe push range
-      // End to Start
+      // End to Start (skip disabled handles)
       for (let i = nextValues.length - 1; i > 0; i -= 1) {
+        if (isHandleDisabled?.(i) || isHandleDisabled?.(i - 1)) {
+          continue; // Skip if either handle is disabled
+        }
         let changed = true;
         while (needPush(nextValues[i] - nextValues[i - 1]) && changed) {
           ({ value: nextValues[i - 1], changed } = offsetChangedValue(nextValues, -1, i - 1));
         }
       }
 
-      // Start to End
+      // Start to End (skip disabled handles)
       for (let i = 0; i < nextValues.length - 1; i += 1) {
+        if (isHandleDisabled?.(i) || isHandleDisabled?.(i + 1)) {
+          continue; // Skip if either handle is disabled
+        }
         let changed = true;
         while (needPush(nextValues[i + 1] - nextValues[i]) && changed) {
           ({ value: nextValues[i + 1], changed } = offsetChangedValue(nextValues, 1, i + 1));