V2 Troubleshooting
Framework v2 is more advanced than earlier versions, which makes it less forgiving of markup that was not intended. This may cause certain layouts or plugins to behave differently. Use this checklist to review your project and bring it in line with the intended usage.
#
Troubleshooting Checklist
-
Does your markup contain a single layout element?
There should be exactly one element with the Layout Layout Primary container for organizing plugin content The Layout is the content container inside a View, exactly one
layoutperview. It arranges content horizontally (layout--row) or vertically (layout--col), with alignment and stretch modifiers. class in your markup. Multiple or nested layouts are not supported.
-
Do your elements contain supported content?
Elements don't support nesting other elements inside them. For example, Label Label Create clear labels for unified content identification Short captions and status chips for a plugin screen. Five sizes plus style variants (filled, outline, underline, inverted) and semantic variants such as label--success and label--error. elements can't have nested more labels or any other elements inside them. If you need rich text capability, use the Rich Text Rich Text Display formatted paragraphs with alignment and size variants A container for long-form text: paragraphs, headings, lists, and quotes. The framework styles the children of the content block, so text from a feed renders in the framework font without a class on every tag. component instead.
-
Clamping is not working as expected?
When using Clamp Clamp Manage text overflow with single and multi-line truncation The Clamp engine truncates text to a specified number of lines using word-based ellipsis. It preserves the original text, measures available width, and re-applies clamping whenever layouts change. on elements like Label Label Create clear labels for unified content identification Short captions and status chips for a plugin screen. Five sizes plus style variants (filled, outline, underline, inverted) and semantic variants such as label--success and label--error. and Description Description Format descriptive text with standardized styles Supporting body text, sized to sit under a Title or a Value rather than compete with it. Four size variants from base to xxlarge, with wrapping or line clamping for longer copy. , these elements can't contain rich text. If you want to clamp rich text content, you need to use the Rich Text Rich Text Display formatted paragraphs with alignment and size variants A container for long-form text: paragraphs, headings, lists, and quotes. The framework styles the children of the content block, so text from a feed renders in the framework font without a class on every tag. component in tandem with the Content Limiter Content Limiter Change font size when content overflows to fit within the container Content areas are capped in height by the view type they sit in. Past that threshold the limiter steps typography down and the Clamp engine truncates the first block that still overflows. modulation utility.