https://github.com/yuri-becker/react-jigsaw-puzzle
🧩 Simple plug-and-play React component for jigsaw puzzles
https://github.com/yuri-becker/react-jigsaw-puzzle
javascript jigsaw-puzzle-game puzzle puzzle-game react react-dom tiles typescript
Last synced: about 1 month ago
JSON representation
🧩 Simple plug-and-play React component for jigsaw puzzles
- Host: GitHub
- URL: https://github.com/yuri-becker/react-jigsaw-puzzle
- Owner: yuri-becker
- License: gpl-3.0
- Created: 2021-04-09T15:53:46.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-01-10T22:23:18.000Z (over 1 year ago)
- Last Synced: 2025-03-11T05:16:42.528Z (about 1 month ago)
- Topics: javascript, jigsaw-puzzle-game, puzzle, puzzle-game, react, react-dom, tiles, typescript
- Language: TypeScript
- Homepage: https://yuri-becker.github.io/react-jigsaw-puzzle/
- Size: 1.77 MB
- Stars: 25
- Watchers: 2
- Forks: 14
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://yuri-becker.github.io/react-jigsaw-puzzle)
[](https://www.npmjs.com/package/react-jigsaw-puzzle)
[](https://github.com/yuri-becker/react-jigsaw-puzzle/blob/main/LICENSE.txt) [](https://github.com/yuri-becker/japp/stargazers)
[](https://github.com/yuri-becker/react-jigsaw-puzzle/commits/main)
react-jigsaw-puzzle
Simple plug-and-play React component for jigsaw puzzles.
It supports resizing and can be fed with any image URL without the need to "tile" the image first.
Check out the [Demo](https://yuri-becker.github.io/react-jigsaw-puzzle/) to see if it fits your needs.
## Usage
```tsx
// Minimal usage
import {JigsawPuzzle} from "react-jigsaw-puzzle/lib";
import "react-jigsaw-puzzle/lib/jigsaw-puzzle.css";
;
```
```tsx
// With custom amount of rows and columns
import {JigsawPuzzle} from "react-jigsaw-puzzle/lib";
import "react-jigsaw-puzzle/lib/jigsaw-puzzle.css";
alert("Solved!")}
/>;
```
### Properties
| Name | Type | Purpose | Default |
| ------------ | :--------: | ----------------------------------------------------- | :--------: |
| **imageSrc** | _string_ | Source of the image. Can be any URL or relative path. | _required_ |
| **rows** | _number_ | The amount of rows the puzzle will have. | 3 |
| **columns** | _number_ | The amount of columns the puzzle with have. | 4 |
| **onSolved** | _function_ | Called when the puzzle is solved. | () => {} |
### Styling
You can simply override or add styles via plain CSS.
The following style classes are used:
- `.jigsaw-puzzle` - The container for the puzzle pieces
- `.jigsaw-puzzle__piece` - Puzzle piece/tile
- `.jigsaw-puzzle__piece--solved` - Puzzle piece in the correct position
- `.jigsaw-puzzle__piece--dragging` - Puzzle piece that is being dragged
## Drawbacks
- The component adjusts its height according to the image's aspect ratio.
That means if the image has a 2:1 aspect ratio and the width is set or calculated to 800px, the puzzle will be 400px high.
That is probably what you'll want for landscape images, but portrait or square images can easily expand out of the viewport on desktop screens.
You can work around this by setting either a fixed width or a width dependent on the viewport height (`vh`).
- While in theory you can make a 100x100 puzzle, a large tile amount will result in poor render performance.
This is because each tile is basically rendering the whole image but "zooms in".
If you want to make really large puzzles, this is probably not for you. Still, I decided to not limit the tile amount because computers and phones are getting faster by the day.
- I built this for a very specific use-case. If you find bugs or want features added, feel free to either create an issue or make a PR.
- Touch scrolling is disabled while moving a tile by temporarily setting `overflow:hidden` on the `` element.
Keep in mind that this does not prevent the navigation bar from moving in and out on mobile phones if the site is larger than the viewport.
## Contributing
Since I am not actively working on this component, I **really** appreciate any contribution.
Feel free to create issues for bugs and feature requests and I will see what I can do.
I also highly encourage you to open pull requests for bugfixes, updates and improvements.