Grid Particle Documentation

  • Tony
  • 3 October 2018
  • 2 Comments
  • Docs
The Grid particle is a fully responsive & mobile friendly particle to display your custom content in Grid view without any line of coding. Parallax, Masonry, Filter support. See how Grid can be designed beautifully on Demo Page.

# Gridcard Package contents

Files Description
jlgridcard.yaml Contains the Grid Card particle settings.
jlgridcard.html.twig The Twig file to pull information, settings.

Installation Installing the particle on your website is a really simple process. You can refer to the document here to know more.

Requirements Gridcard requires Uikit 3 for Gantry 5 Atom to be installed and enabled in your theme layout settings.

Go to Template/Theme Settings > select the Layout to add Grid particle (i.e: Home) -> Layout tab -> Drag and drop the Grid Particle from Particles panel (left corner) to the section you want to display the particle.

Settings

Tab Content

Settings Description
Items List Grid items to show. You can add new items to the collection using the plus + icon

Items You can add new items to the collection using the plus + icon

Settings Description
Title Enter the item title
Meta Enter the item meta
Content Enter short content
Image An image field with an image picker.
Image ALT Enter the image’s alt attribute.
Link Specify the button link.
Link Text Specify the button label.
Tags If you want to use filter tag option, enter a comma-separated list of tags, for example: blue, white, black.

Grid Settings Common settings for grid layout

Settings Description
Enable Masonry The masonry effect creates a layout free of gaps even if grid cells have different heights.
Parallax The parallax effect moves single grid columns at different speeds while scrolling. Define the vertical parallax offset in pixels.
Column Gap Set the size of the gap between the grid columns.
Row Gap Set the size of the gap between the grid rows.
Show Dividers Display dividers between grid cells.
Center columns Use this option to center the grid cell columns.
Center rows Use this option to center the grid row columns.
Match Height To match the height of the direct child of each cell.
Example without Match Height

With Match Height enabled.

Columns/Filter Common settings for Columns and Filter

Settings Description
Columns Settings Common settings for Grid columns layout.
Phone Portrait Set the number of grid columns for each breakpoint. Inherit refers to the number of columns on the next smaller screen size.
Phone Landscape
Tablet Landscape
Desktop
Large Screens
Filter Settings Common settings for Filter
Enable Filter Enable filter navigation for Gridcard.
Reverse order Enable tags reverse order.
All Items Show filter control for all items.
All Items Label Replace the All label tag.
Style Select the filter navigation style. The pill and divider styles are only available for horizontal Subnavs.
Position Position the filter navigation at the top, left or right. A larger style can be applied to left and right navigations.
Primary navigation This option won’t have any effect IF the Filter Style is set to Tab and Filter position is set to Top.
Alignment Align the filter controls. The Alignment styles are only available for TOP filter position.
Margin Set vertical margin. The Margin styles are only available for TOP filter position.
Grid Width Define the width of the filter navigation. Choose between percent and fixed widths or expand columns to the width of their content.
This feature is available for Left/Right filter Position only.
Grid Column Gap Set the size of the gap between between the filter navigation and the content.
Grid Row Gap Set the size of the gap if the grid items stack.
Grid Breakpoint Set the breakpoint from which the filter navigation and grid will stack.
Show tooltip info Show tooltip title when hovering on the tag items
Tooltip Position Choose one of these options to adjust the tooltip’s alignment.
CSS Classes CSS class name for the particle.

Tab Style

Card Settings Common settings for Card

Settings Description
Card Style Select one of the boxed card styles or a blank panel.
Link card Link the whole card if a link exists.
Size Define the card’s size by selecting the padding between the card and its content.
Max Width Set the maximum width.

Title Settings Common settings for Title Style

Settings Description
Style Heading styles differ in font-size but may also come with a predefined color, size and font.
Link title Link the title if a link exists.
Hover Style Set the hover style for a linked title. Enable link title to use this option.
Decoration Decorate the headline with a divider, bullet or a line that is vertically centered to the heading.
Predefined Color Select a predefined text color.
Custom Color Customize the title color instead using predefined title color mode.
You need to set the predefined color to None to use the customize color option.
Font Size Customize the title text font size.
Transform The following options will transform text into uppercased, capitalized or lowercased characters.
HTML Element Choose one of the elements to fit your semantic structure.
Margin Top Set the top margin. Note that the margin will only apply if the content field immediately follows another content field.

Meta Settings Common settings for Meta Style

Settings Description
Style Select a predefined meta text style, including color, size and font-family.
Predefined Color Select the predefined meta color.
Custom Color Customize the meta color. Set Predefined Color for Meta to None before using this feature.
Font Size Customize the title text font size.
Transform The following options will transform text into uppercased, capitalized or lowercased characters.
Alignment Align the meta text above/below the title or below the content.
Margin Top Set the top margin. Note that the margin will only apply if the content field immediately follows another content field.

Content Settings Common settings for Content Style

Settings Description
Style Select a predefined text style, including color, size and font-family.
Predefined Color Select the predefined meta color.
Content Color Customize the content color instead using predefined text color.
You need to set the predefined color to None to use the customize color option.
Font Size Customize the content text font size.
Transform The following options will transform text into uppercased, capitalized or lowercased characters.
Margin Top Set the top margin. Note that the margin will only apply if the content field immediately follows another content field.

Image Settings Common settings for Image Style

Settings Description
Align image without padding Top, left or right aligned images can be attached to the card’s edge. If the image is aligned to the left or right, it will also extend to cover the whole space.
This option won’t have any effect IF the Card Style is set to None or Image Alignment is set to Between.
Width Set the width of the image.
Height Set the height of the image.
Image Border Select the image’s border style.
This option won’t have any effect unless the Card Style is set to None.
Box Shadow Select the image’s box shadow size.
This option won’t have any effect unless the Card Style is set to None.
Hover Box Shadow Select the image’s box shadow size on hover.
This option won’t have any effect unless the Card Style is set to None.
Link image Link the image if a link exists.
Hover Transition Set the hover transition for a linked image.
Image Alignment Align the image to the top,left, right or place it between the title and the content.
Grid Width Define the width of the image within the grid. Choose between percent and fixed widths or expand columns to the width of their content.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Grid Column Gap Set the size of the gap between the image and the content.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Grid Row Gap Set the size of the gap if the grid items stack.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Grid Breakpoint Set the breakpoint from which grid cells will stack.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Vertical Alignment Vertically center grid cells.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Margin Top Set the top margin. Note that the margin will only apply if the content field immediately follows another content field.
This option won’t have any effect unless Image Alignment is set to Bottom or Between.

Link Settings Common settings for Link Style

Settings Description
Target Target browser window when item is clicked.
Style Set the button style.
Button Size Set the button size.
Margin Top Set the top margin. Note that the margin will only apply if the content field immediately follows another content field.

General, Parallax and Parallax Background tab

Please take a look the documentation here for more detail about these tabs settings

Video Tutorial

Comments

Leave a Reply

You must be logged in to post a comment.