Skip to content

Commit 5303584

Browse files
刘欢claude
andcommitted
docs: update README and example for disabled array feature
- Update README.md with disabled array and onDisabledChange documentation - Fix BasicDisabledHandle example to handle sparse disabled array Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 52c7208 commit 5303584

2 files changed

Lines changed: 7 additions & 4 deletions

File tree

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,12 +108,13 @@ The following APIs are shared by Slider and Range.
108108
| handle | (props) => React.ReactNode | | A handle generator which could be used to customized handle. |
109109
| included | boolean | `true` | If the value is `true`, it means a continuous value interval, otherwise, it is a independent value. |
110110
| reverse | boolean | `false` | If the value is `true`, it means the component is rendered reverse. |
111-
| disabled | boolean | `false` | If `true`, handles can't be moved. |
111+
| 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. |
112112
| keyboard | boolean | `true` | Support using keyboard to move handlers. |
113113
| 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. |
114114
| onBeforeChange | Function | NOOP | `onBeforeChange` will be triggered when `ontouchstart` or `onmousedown` is triggered. |
115115
| onChange | Function | NOOP | `onChange` will be triggered while the value of Slider changing. |
116116
| onChangeComplete | Function | NOOP | `onChangeComplete` will be triggered when `ontouchend` or `onmouseup` is triggered. |
117+
| onDisabledChange | (disabled: boolean[]) => void | - | Callback when disabled array needs to be updated (e.g., when handles are added/removed in editable mode). Use with `disabled` as array to keep disabled states in sync. |
117118
| minimumTrackStyle | Object | | please use `trackStyle` instead. (`only used for slider, just for compatibility , will be deprecate at rc-slider@9.x `) |
118119
| maximumTrackStyle | Object | | please use `railStyle` instead (`only used for slider, just for compatibility , will be deprecate at rc-slider@9.x`) |
119120
| handleStyle | Array[Object] \| Object | `[{}]` | The style used for handle. (`both for slider(`Object`) and range(`Array of Object`), the array will be used for multi handle following element order`) |

docs/examples/disabled-handle.tsx

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,12 +26,13 @@ const EditableWithDisabled = () => {
2626
disabled={disabled}
2727
onDisabledChange={setDisabled}
2828
/>
29+
Slider disabled {JSON.stringify(disabled)}
2930
<div style={{ marginTop: 16 }}>
3031
{value.map((val, index) => (
3132
<label key={index} style={{ marginRight: 16 }}>
3233
<input
3334
type="checkbox"
34-
checked={disabled[index]}
35+
checked={!!disabled[index]}
3536
onChange={() => {
3637
const newDisabled = [...disabled];
3738
newDisabled[index] = !newDisabled[index];
@@ -56,12 +57,13 @@ const BasicDisabledHandle = () => {
5657
return (
5758
<div>
5859
<Slider range={{ draggableTrack: true }} value={value} onChange={(v) => setValue(v as number[])} disabled={disabled} />
60+
Slider disabled {JSON.stringify(disabled)}
5961
<div style={{ marginTop: 16 }}>
6062
{value.map((val, index) => (
6163
<label key={index} style={{ marginRight: 16 }}>
6264
<input
6365
type="checkbox"
64-
checked={disabled[index]}
66+
checked={!!disabled[index]}
6567
onChange={() => {
6668
const newDisabled = [...disabled];
6769
newDisabled[index] = !newDisabled[index];
@@ -98,7 +100,7 @@ const SingleSlider = () => {
98100
return (
99101
<div>
100102
<Slider value={value1} onChange={(v) => setValue1(v as number)} disabled />
101-
<br/>
103+
<br />
102104
<Slider value={value2} onChange={(v) => setValue2(v as number)} disabled={false} />
103105
</div>
104106
);

0 commit comments

Comments
 (0)