API Reference
Props
| Prop (* required) | type | default | description |
|---|---|---|---|
| leftImage * | string | null | left image's url |
| rightImage * | string | null | right image's url |
| vertical | boolean | false | Compare images vertically or horizontally |
| keyboard | boolean | true | Allow Keyboard navigation for accessibility |
| keyboardStep | number | 0.01 | By what percentage should the slider move on keyboard press. between 0 and 1 |
| aspectRatio | 'taller' or 'wider' | 'taller' | Which to choose if the aspect ratios of the images are different |
| handle | element | null | Custom handle element. Just pass and empty <div /> if you want to remove the handle. |
| handleSize | number (px) | 40 | diameter of slider handle (by pixel) |
| hover | boolean | false | Whether to slide at hover |
| slideOnClick | boolean | true | Whether to slide on click and drag or just drag. |
| leftImageAlt | string | '' | alt props for left image |
| leftImageCss | object | {} | Additional css for left image |
| leftImageLabel | string | null | Label for the image (e.g. before) |
| onSliderPositionChange | function | null | Callback function called each time the slider changes. The position (0 to 1) of the slider is passed as arg |
| rightImageAlt | string | '' | alt props for right image |
| rightImageCss | object | {} | Additional css for right image |
| rightImageLabel | string | null | Label for the image (e.g. after) |
| skeleton | element | null | Element displayed while image is loading |
| sliderLineColor | string | '#ffffff' | line color of slider |
| sliderLineWidth | number (px) | 2 | line width of slider (by pixel). set 0 to hide slider line. |
| sliderPositionPercentage | number (float) | 0.5 | Default slider line position (from 0 to 1) |
Events
| Name | Description |
|---|---|
| slideStart | When sliding has starts |
| slideEnd | When sliding ends |
| isSliding | true when sliding |
Vue3 Compare Image