Sidiclei-coder / store-block

https://lab.github.com/vtex-trainings/vtex-store-block-course
0 stars 0 forks source link

Connecting _backend_ and _frontend_ #8

Closed github-learning-lab[bot] closed 4 years ago

github-learning-lab[bot] commented 4 years ago

Connecting backend and frontend

Introduction

Now we will learn how to retrieve data from the backend and display it in the interface. VTEX IO uses GraphQL as a language/technology for data transfer, which makes programming our components quite simple. We will modify our Countdown component to search for the targetDate of the releaseDate field of a VTEX product. To perform GraphQL queries in React, the Apollo Client is used, a state management lib that facilitates the integration of a GraphQL API with the front-end application.

The Apollo Client lib offers native integration with React, through hooks. Thus, making a query means using a hook that will not only perform the queries and fetch the data, but will also provide caching and updating the UI state. This integration, called react-apollo is already declared in package.json.

Preparation

  1. On your cloned theme (store-theme) access the store/blocks/product.jsonc file and, on the flex-layout.col#right-col block add the countdown block, right before the buy-button:

       "product-gifts",
    +    "countdown",
       "flex-layout.row#buy-button",
       "availability-subscriber",
  2. Run vtex link on your theme again (if the process is not already running).

  3. Done, now our block is on the product page. Access any of these pages and see the rendered Countdown component.

Release Date Query

  1. Create a folder react/queries and add a productReleaseDate.graphql file to it that will contain the query to be made. In particular, this query will receive a term, which will be the product slug to be retrieved at the launch date. It will call the resolver product, already available through thevtex.search-graphql app, and we will retrieve only the field we need.

    query productReleaseDate($slug: String){
          product(slug: $slug) {
                releaseDate
          }
    }

    Note that the query will need the slug of the product we are looking for. To do so, retrieve this information of the VTEX Product context.

  2. To use this query, it is necessary to add the vtex.search-graphql app as a dependency on your app. We will also need to use the useProduct hook, exported by the vtex.product-context app, to retrieve the product slug that is loaded on the page. To do this, in your app's manifest.json, add in dependencies:

    "vtex.search-graphql": "0.x",
    "vtex.product-context": "0.x"
  3. Now, it is necessary to import the useQuery hooks, to make the query that will return the data we described, and useProduct, to give us information about the current product slug. In addition, it is also necessary to import the query defined previously, which is found in the file productReleaseDate.graphql. It is also important to notice that the prop targetDate will no longer be necessary.

    // react/Countdown.tsx
    import React from 'react'
    ...
    +import { useQuery } from 'react-apollo'
    
    +import useProduct from 'vtex.product-context/useProduct'
    
    +import productReleaseDate from './queries/productReleaseDate.graphql'

    It is important to higlight that there is the possibility of your IDE showing an error while importing product-context.

  4. Define the query using the productReleaseDate imported and the useQuery hook, you can find the product data in useProduct hook. Since they are (hooks)[https://reactjs.org/docs/hooks-intro.html], they only work inside react functional components.

      + const { product: { linkText } } = useProduct()
      + const { data, loading, error } = useQuery(productReleaseDate, {
      +   variables: {
      +     slug: linkText
      +   },
      +   ssr: false
      + })

    linkText will be the same as 'red-front-loading-washer', for example, when your component is rendered in this product's page.

    Besides, it is important to deal with the cases in which there is no data fetched when using useQuery and before returning the main component: loading and error In those cases, it is possible to return a span in the countdown component, such as the example below:

    if (loading) {
      return (
        <div>
          <span>Loading...</span>
        </div>
      )
    }
    if (error) {
      return (
        <div>
          <span>Error!</span>
        </div>
      )
    }
  5. After sending the changes, access a product page and note that the query is working through a console.log({data}) after calling useQuery, which should show something like this:

    {
      data: {
        product: {
         releaseDate: '2019-01-01T00:00:00"',
         __typename:  "Product"
        }
      }
    }
  6. To make Countdown set the hours for the product's releaseDate, change the tick function parameter. You can also remove the props received in the component, as they will no longer be used.

    -tick(targetDate, setTime)
    +tick(data?.product?.releaseDate || DEFAULT_TARGET_DATE, setTime)

Result using the Red Front-Loading Washer product:

In case of having cases that the countdown is going up or with negative values, don't worry! It's related to the fact that some releaseDate can be in the past.

image


Well done!

This is the last step of the Store Block course, you did really well and we hope you've learned a lot until this moment. Congratulations!

If you want to continue learning more about how to develop using VTEX IO, we encourage you to start our next course, which focus on teaching how to develop services on top of VTEX IO. You can find it in the VTEX IO Service Course on Learning Lab.

github-learning-lab[bot] commented 4 years ago

Congratulations!

You have successfully completed this course!