Off-Canvas

The versatile new addition is great for building hidden sidebars into your project for navigation, shopping carts, and more.

Examples

Options Galore

It is easy to add just about any content to Off-Canvas tool to create popout elements. Here we have a couple of quick, simple examples below. The left-hand example is just some plain text content with a header.

The right-hand example is a simple slide out navigation using ther List Group tool as well as some social media icons using the Foundry Icons too. Likely you'd use Off-Canvas' Fixed Positioning settings for placing the navigation toggle in a fixed location on your page.

Header Label

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco ex ea commodo consequat. Duis aute irure dolor in reprehenderit in fugiat nulla pariatur. Excepteur sint occaecat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Elvis isn’t dead, he just went home.

The Off-Canvas tool is another area where we've combined the functionality of multiple past tools into one, more modular package -- and with more options, too.

With this new tool you can create hidden sidebars of content, much as you would have in the past using the Side Slide tool.

Additionally you can also create versatile hidden navigation panels as well using Off-Canvas paired with a List, List Group, Accordion, etc. This modular approach gives you a great deal more control over the design and layout and opens up more options.

Settings

Edit Mode

Edit Mode Title

Allows you to add a custom label to the top title bar of the tool. This lets you quickly identify what purpose you're using that tool for in your layout. This title is also visible when you've collapsed or hidden the contents of the tool in Edit Mode.

Off-Canvas Location & Size

Location

Here you can decide which edge of the browser you'd like the Off-Canvas tool to appear from when toggled by the visitor. You can choose from Top, Bottom, Left or Right. This defaults to the left-hand side of the browser.

Height / Width

Depending on the location you choose you're then able to adjust the height or width of the Off-Canvas content area.

Off-Canvas Toggles

Start Open

When enabled the Off-Canvas tool will start out open when the page loads. This is off by default, meaning the content won't be seen until the visitor triggers the Off Canvas item.

Backdrop

Enabling this feature will add a background overlay between the Off-Canvas item and the page.

Page Scrolls Under Backdrop

Allows the page content to continue to scroll even when the Off-Canvas tool has been triggered and is visible.

Off-Canvas Header

Hide Header

By default a header label is added to the top of the Off-Canvas content. This allows you to label the contents below it. You can use this feature to disable and hide this header.

Header Label

This is where you'll enter the label text for your header at the top of the Off-Canvas content area.

Header Font Size

This setting provides you with several preset font sizes for the included header. If you want more control over the header you can disable this in-built header and add a Header tool within Off-Canvas' content manually.

Bold Label

When enabled the header label is bolded to help it standout.

Hide Close Button

By default Off-Canvas includes a button within the header section. This feature allows you to disable this closer button.

Off-Canvas Styling

Header Background

Allows you to use one of Foundry's presets from the color palette or extended color palette, as well as the grey, white and dark preset values for the header background. You're also provided an option to choose a custom one-off color as well.

Header Text

Provides a color picker for customizing the text within the Off-Canvas header.

Close Button

Allows you to chooose whether the close button, when enabled, should be light or dark. Use this feature to choose a style that fits your header background best.

Header Padding

Choose from several preset padding options for the Off-Canvas header area.

Content Background

Allows you to use one of Foundry's presets from the color palette or extended color palette, as well as the grey, white and dark preset values for the main content background. You're also provided an option to choose a custom one-off color as well.

Content Padding

Choose from several preset padding options for the Off-Canvas main content area.

Off-Canvas Shadow

Shadow

Used to add a decorative shadow to this tool. Foundry provides a variety of preset shadow styles, as well as access to a user defined preset that you can configure in the Control Center. Additionally for one-off shadows there is also a custom shadow option where you can create a unique shadow style, setting its positioning, size, spread and color.

Button

Hide Button

Allows you to hide the trigger button. This can often be helpful when having the Off-Canvas item start open on page load.

Button Label

Here you can add text to the button label that will trigger the Off-Canvas tool. If you wish to have just an Icon in the button enable the Icon feature and delete the text within this label field.

Add Accesibility Label

When enabled you can add an ARIA label for accessibility to your button.

Include Base Margin

When enabled a preset margin will be added to the base of the tool. Foundry allows you to configure the Base Margin preset to your liking within the Control Center. The Base Margin can be configured independently at each of the 6 responsive breakpoints.

Button Fixed Positioning

Use Fixed Positioning

When enabled your button will be positionedin a fixed spot within the browser window instead of normal, inline positioning. This allows your button to always be visible. This can be handy for slide out navigation layouts.

Vertical & Horizontal

When fixed positioning is enabled you're able to use these toggles to place the button in specific areas of the browser window.

Offset

Here you can adjust the button's distance from the edge of the browser window. You can adjust both the horizontal and vertical offset.

Z-Index

Allows you to adjust the layering of elements using a custom z-index value.

Button Font

Font

Here we can define the font for this tool. You can choose to use one of the fonts defined in the Typeface stack or simply use the Base Font that is defined in the Foundry Control Center.

Font Weight

Allows you to adjust the font weight for your text. This setting goes from 100 to 900 in increments of 100. Standard Normal font weight is 400 and Bold font weight is generally 700.

Button Styling

Mode

The Button tool offers several different style modes to choose from. Below we look at each of the style modes and what they have to offer:

Presets

Allows you to use one of Foundry's presets from the color palette or extended color palette, as well as the grey, white and dark preset values. You're also provided a color picker for setting the text color.

Link

The Button will be shown in a way the mimics a standard link on the page. It will take on the link styling provided in the Control Center.

Custom Styling

Provides color pickers for styling the Button's background, border and text colors, as well as providing alternate colors for each of these for when the visitor hovers over the button.

Gradient (2 Color)

We provide two different gradient style options. In the Two Color Gradient setting you're given color pickers for the gradient's two colors as well as the button border and text. Much like the Custom Styling option you can also adjust the styling for the hovered button as well. You've also got control over the angle of the gradient.

Gradient (4 Color)

Much the same as the Two Color gradient option, but with the added ability to choose four colors as well as choose the color position along the gradient for each of the four colors. Again, you have control over the text and border, along with the gradient angle, and can adjust the gradient's colors for when it is hovered over by visitors.

Outline Mode

Outline Mode can be used when working with the Preset styling mode. This basically inverses the colors and uses a tranparent background color. This is yet another way to provide variety in your page and button designs.

Hover Opacity

When using Preset mode for your Button's style we can set the opacity of the button when the visitor hover over it. When using other modes like Custom Styling and gradients you can set separate hover styling instead of using the Opacity hover feature.

Gradient Overlay

We provide a quick way to add a subtle light gradient over our buttons when using Preset or Custom Styling modes. This simply includes a translucent white gradient over the button to give it a bit more depth.

Size

Here you can adjust the size of the button using the 3 preset choices. You can opt for a small, standard or large button, with the default being Standard.

Rounded Corners

Foundry provides 5 different presets for rounded corners. These can be found throughout Foundry's various tools. You're also able to remove the roundness of the corners by setting this to none, or provide your own custom value for the border radius, or rounded corners. When using Custom mode you can set a different value on each of the four corners.

Block Button

When you want to have a button take up the full-wdith of its parent container you can use the block button feature. This setting can be toggled on or off at each of the 6 responsive breakpoints. This is handy for setting a block button for mobile at the Small and Extra Small breakpoints.

Button Alignment

Alignment (Uniform)

This setting allows you to align the button to the left, center or right of its parent container. In Uniform mode this alignment will be set the same for all 6 breakpoints.

Alignment (Non-Uniform)

Clicking on the small plus icon will give you the ability to adjust the alignment of the button independently at each of the 6 responsive breakpoints giving you more granular control.

Button Shadow

Shadow

Used to add a decorative shadow to the button. Foundry provides a variety of preset shadow styles, as well as access to a user defined preset that you can configure in the Control Center. Additionally for one-off shadows there is also a custom shadow option where you can create a unique shadow style, setting its positioning, size, spread and color.

Button Icon

Icon Library

Here you can tell this tool which icon library you're using, whether it is the Bootstrap Icons or Font Awesome. By choosing one you're then given the ability to then choose one of the preset icon choices or choose Custom and type in the unique identifier for the icon you'd like to use. The font identifiers can be found on the Bootstrap and Font Awesome sites.

By default the Icon Library setting is set to None, which disables the icon.

Location

Allows you to choose which side of the button's text you wish to place the icon. You can choose from left, right or place the icon in a floating badge on the top right corner of the button.

When using the Badge setting you'll also be provided settings for styling the background and icon color as well as a shadow for the badge. You'll be able to choose from using a preset color palette option for the background or custom color picker.

HTML Comment

HTML Comment

Enabling this feature adds an HTML comment to the exported code to indicate the name of the tool being used here. This is helpful to both yourself and others when troubleshooting, or inspecting the code. This is enabled by default.

Custom

This field allows you to replace the default HTML Comment with your own text.

CSS

Classes

Allows you to specify an options class, or classes, that will be added to this tool's wrapper. You can use this to apply custom styling from the Blacksmith tool, or add a Bootstrap v5 preset class to your item. If you're applying more than one class be sure that you separate each class name with a space. Do not use special characters.