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. There should be exactly one
layoutperview. Its height is calculated automatically based on the device type, orientation, and whether a title bar is present. It can arrange content horizontally (layout--row) or vertically (layout--col), with alignment and stretch modifiers. For organizing content inside it, useflex,columns, orgrid. 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 The Label system provides various styles for displaying text labels, with options for different visual treatments and sizes. The filled variant uses black (darkest) background; label--primary, label--success, etc. use semantic colors. Labels can be used to highlight text, show status, or create visual hierarchy in your interface. 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 The Rich Text component provides a flexible container for displaying text content with consistent styling and layout options. It's commonly used for paragraphs, articles, and other formatted text content that needs to maintain readability and visual hierarchy. 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 The Label system provides various styles for displaying text labels, with options for different visual treatments and sizes. The filled variant uses black (darkest) background; label--primary, label--success, etc. use semantic colors. Labels can be used to highlight text, show status, or create visual hierarchy in your interface. and Description Description Format descriptive text with standardized styles The Description component provides a standardized way to display descriptive text content with consistent styling. , 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 The Rich Text component provides a flexible container for displaying text content with consistent styling and layout options. It's commonly used for paragraphs, articles, and other formatted text content that needs to maintain readability and visual hierarchy. component in tandem with the Content Limiter Content Limiter Change font size when content overflows to fit within the container The Content Limiter system automatically restricts the height of content areas based on the view type. When content exceeds the height threshold, it applies smaller typography and truncates overflowing text using the Clamp Engine to fit the available space. modulation utility.