How to Build BookSearch App using Vue.js and ElasticSearch
Read our updated post from March, 2022 ove here: https://blog.reactivesearch.io/appsearch-with-vuejs-and-elasticsearch
In this post, we are going to build a Booksearch Application using Vue.js and ElasticSearch. You might have already heard of Vue.js, one of the fastest growing JavaScript frameworks. You might also have heard about ElasticSearch — it is the #1 search engine. In any case, I will do a walkthrough explaining the basics of Search and build the app in a step-by-step manner.
Edit: This post and the code walkthrough has been updated to the 1.0.0 release made on Dec 5, ’19. You can read more about the new Vue ReactiveSearch library below.
Before diving in, you can try out the Live demo of the final app here.
.
.
.
.
What is ElasticSearch
ElasticSearch is a blazing fast, open-source, full-text search engine. It allows you to store, search, and analyze both small and large volumes of data quickly (we are talking milliseconds here). It is generally used as the underlying engine/technology to power applications that have complex search features and requirements. You can read more about it here.
Why ElasticSearch
With ElasticSearch, you can build a fast search which utilizes its powerful Query DSL. However, setting up ElasticSearch correctly requires a lot of work. For instance, the mappings, analyzers, and tokenizers need to be set correctly or you may not receive accurate search results back. Besides, the more filters that get applied along with the search query, the more complex the resulting search query becomes.
Setting Up ElasticSearch
Setting up and maintaining our own search engine cluster can be time-consuming and costly. So we will be using Appbase.io to save our time and cost of maintaining Cluster.
At appbase.io, we have built some open-source tools to help you do all these things within a matter of clicks.
- Tool to add data into ElasticSearch — Importer
- Tool to view ElasticSearch data like an excel sheet — Data Browser
- Tool to generate relevant ElasticSearch queries easily — Query Builder
In this blog post, we will be using these tools to utilize the strength of ElasticSearch with Vue to build powerful apps.
Building our Search Backend
As mentioned above, we will be using appbase.io for our search backend. It offers a real-time search API service based on ElasticSearch. This saves us time and cost of setting up and maintaining our own search engine cluster.
This means that we wouldn’t require writing any server code. 💥
In order to make Booksearch application, we will need a dataset of some really good books. I have already created an appbase.io app with the books dataset indexed over here. You can either clone this dataset to use your own credentials or copy the below credentials:
app="good-books-yj"
credentials="gBgUqs2tV:3456f3bf-ea9e-4ebc-9c93-08eb13e5c87c"
How to use ElasticSearch with Vue.js?
We will be using the ReactiveSearch-vue open-source library to build the Booksearch application in this post. This library offers a range of highly customizable rich UI components that can connect with an ElasticSearch index hosted anywhere. It provides scaffolding to build UIs such as Airbnb, Yelp, you name it. We will show how simple it is to build one by creating our Booksearch app.
ReactiveSearch for Vue is a port of ReactiveSearch (written for React) that has been downloaded over 125,000 times in the past year and currently powering hundreds of production search UIs. You can read more about the Vue.js announcement here:
Setting Up Frontend
Step 1: Base setup of Vue.js with ReactiveSearch
We will use Codesandbox.io to help us build our application in a step by step fashion. Open the above link and click on the Open Vue
button.
If you instead want to develop this locally, you can also use vue-cli
. You can read more about it here.
Install ReactiveSearch for Vue
Now we can add our dependency by clicking the Add Dependency
button on CodeSandbox and searching for reactivesearch-vue
, or if you are working locally you can install the package:
yarn add @appbaseio/reactivesearch-vue
Step 2: Adding components from ReactiveSearch library
Now that we have the dataset to play around with and we are also done with our setup, it’s time for adding components to our app.
We need to first register the library so that we can use the components in the main.js
. We can do this via the use
method of Vue
:
import ReactiveSearch from "@appbaseio/reactivesearch-vue";Vue.use(ReactiveSearch);
Connecting our Search Backend via ReactiveBase Component
All the ReactiveSearch components are wrapped inside a container component — ReactiveBase
which connects the components to an Elasticsearch index. We’ll apply this in the /src/App.vue
file. You can read more about Reactivebase
here.
The app
and credentials
are taken from my appbase.io app. In case you are using your own app, you can swap the values in L2 and L3.
Use DataSearch Component for the main search
DataSearch
creates a search box UI component that is connected to one or more database fields.
dataField
prop values are the name of the field on which we want to apply our search.
iconPosition
is used to align the search icon to right or left.
You can learn more about this component props over here.
Use MultiList Component for Authors filter
We always want to read the book from our favorite authors so why not we built an option to select our favorite authors and search through the list of authors.
In this component, dataField
attribute defines the data field to be connected to the component’s UI view. title
attribute gives the heading to the component, while class
attribute is used to provide the class name to the MultiList container. We can use react
prop which allows components to watch each other and update their data reactively. For example, an Authors Filter component can update its data based on the selected fields in the Rating Filter component and DataSearch component.
You can learn more about the attributes of this component here.
Use RatingsFilter Component for Rating filter
We want only the best books for us, so why not create an option to filter the best-rated books on our dataset.
SingleRange
component displays a curated list of items where only one item can be selected at a time. Each item represents a range of values, specified in the data prop of the component.
In this component, dataField
attribute defines the data field to be connected to the component’s UI view. title
attribute gives the heading to the component, while :data
attribute is a collection of UI labels
with associated start
and end
range values. You can read more about the attributes of component here.
:data
is the shorthand for v-bind:data
which is used to pass data to the components.
Step 3: Use ReactiveList Component for displaying Book Results
ReactiveList
creates a data-driven result list UI component. This list can reactively update itself based on changes in other components or changes in the database itself.
In this component, pagination
is used to show the pagination at the bottom of the list. react
is used to watch changes through different components like SingleRange and MultiList in our case. You can read more about this component properties here.
Notice slot
and slot-scope
it is used to get data from the child component to parent component. If you have used React
it is like a render-prop
. You can read more about it here.
Step 4: Styling the Application
We will now make use of some styles to make the application look elegant and professional. We can add styles to an element using class
and adding their respective CSS in styles.css
.
You can get all the styles here & add them to App.vue
.
We will also make this app mobile responsive. To do this, we will use a variable
to hide/show filters using a button when we are on a mobile viewport.
@click
is shorthand for v-on:click
. It is used to track whenever a click event is fired on the button.
Summary
Here comes the end of our journey, and we have got our awesome Booksearch app built with ReactiveSearch-Vue. To summarize everything so far:
This post introduces ReactiveSearch-Vue — A Vue.js UI components library for ElasticSearch that provide scaffolding for building great search experiences. Next, we went step-by-step to add different UI components and style our app.
- Step 1: Base setup for Vue with ReactiveSearch — CodeSandbox here.
- Step 2: Adding components from ReactiveSearch library — CodeSandbox here.
- Step 3: Displaying data using ReactiveList — CodeSandbox here.
- Step 4: Adding styles to make responsive and professional — CodeSandbox.
Check out the live demo here.
Alternatively, if you want to build this app locally using vue-cli, you can check out the Github repo here.
Useful References
All ReactiveSearch components can be interactively tried using the playground at https://reactivesearch-vue-playground.netlify.com/.
The documentation for all the components is available at https://docs.appbase.io/docs/reactivesearch/vue/overview/QuickStart/.
Finally, go ★ ReactiveSearch on Github so you can find it when you need to build that awesome search!