1.1.0 • Published 9 months ago

react-slider-image-js v1.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
9 months ago

react-slider-image-js

Install

npm install --save react-slider-image-js

React Image Slider js - User Manual and Updates

Welcome to React Image Slider js! This library empowers you with the flexibility to seamlessly integrate image slider functionality into your React applications, allowing for manual management and customization based on your unique requirements.

Key Features:

  • Manual Control: Take charge of your slider interactions and tailor them to your needs.
  • Ease of Use: Effortlessly integrate and configure slider with minimal setup.

Getting Started:

To begin using React Image Slider js, follow these simple steps:

  1. Install the package via npm or yarn:

    npm install react-slider-image-js

React Image Slider js - CodeSandbox Example

Welcome to the React Image Slider js CodeSandbox example! In this sandbox, you can explore and interact with a live implementation of React Image Slider js. This example showcases how to integrate and customize slider functionality into a React application.

Live Example:

Check out the live example on CodeSandbox: Live Example

How to Use:

  1. Open the Live Example on CodeSandbox.
  2. Explore the implemented React components and code in the src directory.
  3. Observe how the slider functionality is integrated and how the imageBackgroundColor option is used.
  4. Make changes and experiment with the code to see how it affects the slider behavior and appearance.
  5. Feel free to modify and adapt the example to your own projects.

react-slider-image-js - Latest Update

We're thrilled to announce the release of the latest version of react-slider-image-js! This update brings a set of significant user interface enhancements to elevate your experience with the package.

What's New:

  1. Autoslider Feature: We've added an exciting new feature – automatic image slides. Now, you can enjoy images that slide automatically.

Getting Started:

To take advantage of these improvements, make sure to update your react-slider-image-js to the latest version. You can do this by running the following command in your terminal:

npm update react-slider-image-js

How to Use:

import React, { Component } from 'react'

import { ReactSlider } from 'react-slider-image-js'
import 'react-slider-image-js/dist/index.css'

const imagesArr = [{ src: '1.png' }, { src: '2.png' }]

const Example = () => {
  return (
    <ReactSlider images={imagesArr} imageSrcKey={'src'} imageAltKey={'src'} />
  )
}

Options

OptionTypeDefault valueDescription
sliderIndexnumber0Selected index of slider
imagesarray[]Array of images
imageSrcKeystring'src'key of image in array object. Provide empty eg. '' if it is simple array
imageAltKeystring'src'image alt key
slideAnimationDurationstring'600ms'Slider animation duration.
objectFitstringfillImage object property style. i.e. cover,contain,fill etc.
imageBackgroundColorstring'rgba(0, 0, 0, 0.5)'Background color of image container.
isAutoSlideboolean'false'If this value is true, It'll enable autoslide feature
autoSlideDurationnumber4000Duration after auto next slider image should display. Values should in number and in ms i.e. 4000 ms is equivalent to 4 sec

Example first: images having keys in array

const Example = () => {
  return (
    <ReactSlider
      sliderIndex={0}
      images={[{ src: '1.png' }, { src: '2.png' }]}
      imageSrcKey={'src'}
      imageAltKey={'src'}
      slideAnimationDuration={'600ms'}
      imageBackgroundColor={'rgba(0, 0, 0, 0.9)'}
      objectFit={`fill`}
      isAutoSlide={true}
      autoSlideDuration={3000}
    />
  )
}

Example two: images having simple array

const Example = () => {
  return (
    <ReactSlider
      sliderIndex={0}
      images={['1.png', '2.png']}
      imageSrcKey={''}
      imageAltKey={''}
      slideAnimationDuration={'600ms'}
      imageBackgroundColor={'rgba(0, 0, 0, 0.9)'}
      objectFit={`fill`}
      isAutoSlide={true}
      autoSlideDuration={3000}
    />
  )
}

License

MIT © Harsh Nahta