Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

simple image slider component for react

License

NotificationsYou must be signed in to change notification settings

kimcoder/react-simple-image-slider

Repository files navigation

ReactJsDownload CountGitHub license

Simple ImageSlider Component for ReactJS v17

  • Just Two Elements will be used. (for display images)
  • Support GPU Render, by default.
  • Support Image Preload.
  • Support SSR. ( server-side-rendering )
  • Selectable Navigation Styles.

Live demo

Install

// npmnpm install react-simple-image-slider --save// yarnyarn add react-simple-image-slider

Usage

import SimpleImageSlider from "react-simple-image-slider";const images = [  { url: "images/1.jpg" },  { url: "images/2.jpg" },  { url: "images/3.jpg" },  { url: "images/4.jpg" },  { url: "images/5.jpg" },  { url: "images/6.jpg" },  { url: "images/7.jpg" },];const App = () => {  return (    <div>      <SimpleImageSlider        width={896}        height={504}        images={images}        showBullets={true}        showNavs={true}      />    </div>  );}

If You want to see more detail source,

Props

NameTypeRequiredDescriptionDefault
widthNumberRequiredImage Slider Width
heightNumberRequiredImage Slider Height
imagesArrayRequiredImages,
Array Elements should be like this structure,
{ url: "" } or string[]
styleStringOptionalcss object
slideDurationNumberOptionalcss transition-duration property0.5
navStyleNumberOptionalArrow Navgation Style,
1 or 2
1
navSizeNumberOptionalArrow Size50
navMarginNumberOptionalArrow Margin30
showNavsBooleanRequiredToggle Arrow
startIndexNumberOptionalstart Index of Slide0
showBulletsBooleanRequiredToggle Bulletstrue
loopBooleanOptionallooping slidertrue
autoPlayBooleanOptionalauto playfalse
autoPlayDelayBooleanOptionalauto play delay2.0
useGPURenderBooleanOptionalToggle GPU Rendertrue
bgColorStringOptionalslider container's css background-color property#000000
onClickFunctionOptionalImage Click Callback function,
onClick = (idx, event) => { }
idx : number : clicked bullet index (begin from 0)
onClickNavFunctionOptionalArrow Navigation Callback function,
onClickNav = (toRight) => { }
toRight : Boolean : slide direction
onClickBulletsFunctionOptionalBullets Callback function,
onClickBullets = (idx) => { }
idx : Number : clicked bullet index (begin from 0)
onStartSlideFunctionOptionalSlide Transition Start function,
onStartSlide = (idx, length) => { }
idx : Number : start index (begin from 1)
length : Number : image length
onCompleteSlideFunctionOptionalSlide TransitionEnd Callback function,
onCompleteSlide = (idx, length) => { }
idx : Number : start index (begin from 1)
length : Number : image length

If You want to see more detail,

Style customize

  • can customize by className with!important;
.your-app {  .rsis-container {    // do something  }}.your-app {  .rsis-image {    background-size: contain !important;  }}

Development

directory & source

  • ./example/ : demo site souce for testing component
  • ./src/ : image slider component source
  • ./dist/ : image slider component distribution
  • ./babelrc : babel configure. (version 7.x)
  • ./webpack.config.js : webpack configure. (version 4.x)
  • ./rollup.config.js : rollup configure.

scripts

// npmnpm run example         // run a test app(demo) by webpack dev servernpm run build           // build the image slider component by rollupnpm run dev     // build watch mode// yarnyarn exampleyarn buildyarn dev

If you want to run a test app, should build before do that.

After run example by webpack dev server,
openhttp://localhost:8080/ in a browser

License

MIT


[8]ページ先頭

©2009-2025 Movatter.jp