react-image-turntable

React Image Turntable

Display a set of images as a draggable 360 degree turntable.

👉   Try the demo  👈

Features

• Accessible
• Responsive & fluid with intrinsic sizing
• Supports keyboard navigation
• Teeny Tiny (less than 1kb gzipped)
• Zero dependencies
• Type safe

Install

npm i react-image-turntable
# Or
yarn add react-image-turntable
# Or
pnpm i react-image-turntable

Usage

Props

Props	Type	Required	Default Value	Description
images	string[]	✓	undefined	List of image src attributes.
initialImageIndex	number		0	Index of image to show first.
movementSensitivity	number		20	The amount a "drag" has to move before an image changes to next or previous.

Example

import React from 'react';
import { ReactImageTurntable } from 'react-image-turntable';

const images = [
  'https://via.placeholder.com/1200x800?text=1',
  'https://via.placeholder.com/1200x800?text=2',
  'https://via.placeholder.com/1200x800?text=3',
];

export const Turntable = () => <ReactImageTurntable images={images} />;

Also see the example code in the repo.

Custom Styling

The library uses the first image passed to intrinsically size the component, it also exports following classNames to apply custom styles when needed.

className	Purpose
CLASS_NAME_IMG	Base class for images.
CLASS_NAME_IMG_PRIMARY	Class of first rendered image (sets the size of the main component).
CLASS_NAME_IMG_SECONDARY	Class of subsequent images.

---

Contributing

See the contributing guide to get started.

---

Browser Support

The library is built for ES2021.

Notes

• It's recommended you use a minimum of 24-36 for a smooth experience
• Legacy v2.5.4 Demo
• Original version by @andrewmcoupe