Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/miro-wq/goit-js-hw-11
The project is a feature-rich image search application that integrates with the Pixabay API to deliver stunning results. It showcases advanced JavaScript concepts, API interaction, and user interface enhancements.
https://github.com/miro-wq/goit-js-hw-11
api-integration axios crud-operation error-handling javascript pixabay-api search-functionality simple-lightbox
Last synced: about 2 months ago
JSON representation
The project is a feature-rich image search application that integrates with the Pixabay API to deliver stunning results. It showcases advanced JavaScript concepts, API interaction, and user interface enhancements.
- Host: GitHub
- URL: https://github.com/miro-wq/goit-js-hw-11
- Owner: Miro-wq
- Created: 2024-07-17T11:24:11.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-11-20T13:55:58.000Z (2 months ago)
- Last Synced: 2024-11-20T14:38:25.747Z (2 months ago)
- Topics: api-integration, axios, crud-operation, error-handling, javascript, pixabay-api, search-functionality, simple-lightbox
- Language: JavaScript
- Homepage: https://miro-wq.github.io/goit-js-hw-11/
- Size: 2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ✨ C.R.U.D. ✨
## 🛠 Tools used
[](https://skillicons.dev)
>The project is a feature-rich image search application that integrates with the Pixabay API to deliver stunning results. It showcases advanced JavaScript concepts, API interaction, and user interface enhancements.
>
- **Pixabay API Integration:** Fetches high-quality images based on user queries.
- **Infinite Scroll:** Loads additional images automatically as the user scrolls down.
- **Search Functionality:** Allows users to search for specific images by keywords.
- **Modern Design:** User-friendly interface with responsive behavior.
- **Error Handling:** Displays proper messages for empty or invalid queries.
- **HTML, CSS:** Structure and styling for a polished look.
- **JavaScript:** Core logic for search, pagination, and event handling.
- **Axios:** For seamless API requests.
- **SimpleLightbox:** Enhances the viewing experience with a lightbox effect.
Build a front-end part of a keyword search and image viewer application. Add some decoration to the interface elements.
The form is originally in the HTML document. The user will enter a search string in the text field, and when submitting the form, an HTTP request must be made.
```html
Search
```
Use the public API of the Pixabay service as a back-end. Sign up, get your unique access key and read the documentation.
Here is a list of query string parameters that you must specify:
- `key` - your unique API access key.
- `q` - search term. What the user will enter.
- `image_type` - image type. You only want photos, so set the value to photo.
- `orientation` - orientation of the photo. Set the value to horizontal.
- `safesearch` - filter by age. Set the value to true.
The response will contain an array of images that meet the request parameters. Each image is described by an object, and you need only the following properties:
- `webformatURL` - link to a small image for the list of cards.
- `largeImageURL` - link to a large image.
- `tags` - line with image description. Suitable for the alt attribute.
- `likes` - number of likes.
- `views` - number of views.
- `comments` - number of comments.
- `downloads` - number of downloads.
If the back-end returns an empty array, then there are no matches. In this case, show a notification with the text `"Sorry, there are no images matching your search query. Please try again."`. For notifications, use this library: notiflix.
The `div.gallery` element is originally in the HTML document, and the markup of the image cards needs to be rendered into it. When searching with a new keyword, you should completely clear the gallery content to avoid confusing results.
```html
```
Single image card markup template for the gallery.
```html
![]()
Likes
Views
Comments
Downloads
```
Pixabay API supports pagination and provides the `page` and `per_page` parameters. Make it so that each response contains 40 objects (20 by default).
- Initially, the `page` parameter value must be `1`.
- With each subsequent request, it must be increased by `1`.
- When searching with a new keyword, the value of `page` must be reset to its initial value, since there will be pagination for a new collection of images.
The HTML document already has the markup of the button used to execute the request for the next group of images and add markup to the already existing gallery items.
```html
Load more
```
- Initially, the button must be hidden.
- After the first request, the button appears in the interface under the gallery.
- When re-submitting the form, the button is first hidden and then displayed after the request.
In response, the back-end returns the `totalHits` property - the total number of images that match the search criteria (for a free account). If the user has reached the end of the collection, hide the button and display a notification with the text: `"We're sorry, but you've reached the end of search results."`.
> [!NOTE]
> The following features are optional, but they will be a good additional practice.
After the first request, for each new search, display a notification with the number of images found in total `totalHits property`. Notification text: `"Hooray! We found totalHits images."`
Add the display of large images with the `SimpleLightbox` library for a full gallery.
- In your markup, wrap each image card in a link as said in the documentation.
- The library has a refresh() method that must be called every time after adding a new group of image cards.
In order to add the CSS code of the library to the project, you need to add one more import, aside from the one described in the documentation.
```html
// Described in documentation
import SimpleLightbox from "simplelightbox";
// Additional styles import
import "simplelightbox/dist/simple-lightbox.min.css";
```
Make smooth page scrolling after the request and rendering each next group of images. Here is a hint code for you. Figure it out for yourself.
```js
const { height: cardHeight } = document
.querySelector(".gallery")
.firstElementChild.getBoundingClientRect();
window.scrollBy({
top: cardHeight * 2,
behavior: "smooth",
});
```