From our blog
Last updated
Last updated
So far we've been building individual components and built them in a way we can re-use them. Well, the time has come to build a list of content where we will re-use most components we've built. Using the designs below, we will build the From our blog content list. Here are some details about this component:
It uses multiple instances of the card component
The entire collection has a heading of "From our blog"
It uses a button that links users to a page like /blog
This component will be completely different than the ones we've built thus far. All previous components have been a single item, this one will have an unlimited number of items. Let's start
Inside src/patterns/componentscreate a new folder called from-our-blog
Inside the from-our-blog folder create a new file called from-our-blog.json
Inside from-our-blog.json add the following code:
There is a lot going on in this file. Let's go over it and you will see that it's actually relatively straight forward.
First we declared the heading object which will be the title for the entire collection (From our blog)
Directly under that we are declaring a cta object which will be the button at the bottom of the list. The order in which we define these objects has no effect on how things will turn out.
At around line 13, we declared an array, items: [ ] . This will help us mimic the array of content to build the collection.
Each item in the array represents a blog post. Inside each item we have declared the card's fields (image, title, date, body_text, tags ). So we've basically copied the content from card.json and have repeated it 4 times inside the items array in from-our-blog.json.
So the data is ready, let's go ahead and add the markup for the component.
Inside the from-our-blog folder create a new file called from-our-blog.twig
Inside from-our-blog.twig add the following code:
As I mentioned earlier, this is a unique component and nothing like we've built thus far. Let's review:
First we attach the component's library. Don't forget to create the library.
Next we add a <section> element to wrap the entire component. As we've done before, the first and main component wrapper should always use the name of the component as its class (from-our-blog). In addition we pass the modifier and attributes and title_prefix_ and title_suffix _placeholders.
Next we make use of the heading component to print the component's main title.
Next we create a wrapper to hold all the blog posts/cards with the class of from-our-blog__items
Next we create twig block (blog_items), which we will use later to print Drupal's nodes.
Inside the twig block we run a for loop function. We are iterating through the items array and for each item we find in it, we include a card component using an embed statement.
Notice we are declaring the featured_date twig block. This particular card or collection of cards does not need the date on the top-left corner of the card like the card wide does. So by declaring an empty twig block for featured_date, we are basically excluding that content from rendering.
Finally we are including a button component so we can link it to /blog or /news.
Inside the from-our-blog folder create a new file called from-our-blog.scss
Inside from-our-blog.scss add this code:
The styles are very simple as they only focus on aligning the cards side by side. All other card-specific styles were written in the card component.
While in your theme's root directory, run the following commands in your command line and press Return
npm run build
npm run watch
TIP: Since we created a whole new component; if you had the watch task running, it is recommended you stop it by pressing Ctrl + C on your keyboard and run the commands above. This will ensure the new component will be generated and all related code will be compiled.
In your browser of choice open the following URL: http://localhost:3000. You should be able to find the From our blog component. The styles we wrote already account for responsive behavior of this component.
