@loadsmart/loadsmart-ui 5.12.3 → 5.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loadsmart/loadsmart-ui",
-  "version": "5.12.3",
+  "version": "5.13.0",
   "description": "Miranda UI, a React UI library",
   "main": "dist",
   "files": [

package/src/components/Tabs/Tabs.test.tsx

@@ -69,4 +69,35 @@ describe('Tabs', () => {
 
     expect(screen.getByRole('tab', { selected: true })).toHaveTextContent('Multi-quote')
   })
+
+  it('mounts only the visible tab when using the `lazy` prop', () => {
+    setup({
+      children: (
+        <Fragment>
+          <Tabs.Items>
+            <Tabs.Item name="tab-1" default>
+              Tabs 1
+            </Tabs.Item>
+            <Tabs.Item name="tab-2">Tabs 2</Tabs.Item>
+          </Tabs.Items>
+          <Tabs.Panels>
+            <Tabs.Panel name="tab-1" lazy>
+              first content
+            </Tabs.Panel>
+            <Tabs.Panel name="tab-2" lazy>
+              second content
+            </Tabs.Panel>
+          </Tabs.Panels>
+        </Fragment>
+      ),
+    })
+
+    expect(screen.getByText('first content')).toBeInTheDocument()
+    expect(screen.queryByText('second content')).not.toBeInTheDocument()
+
+    fire.click(screen.getByDisplayValue('tab-2'))
+
+    expect(screen.getByText('second content')).toBeInTheDocument()
+    expect(screen.queryByText('first content')).not.toBeInTheDocument()
+  })
 })

package/src/components/Tabs/Tabs.tsx

@@ -203,20 +203,29 @@ function PanelsItems({ children, ...props }: PanelsItemsProps) {
 
 interface PanelsItemProps extends HTMLAttributes<HTMLElement> {
   name: string
+  /**
+   * Renders the Panel.Item only when is visible
+   * @default false
+   */
+  lazy?: boolean
 }
 
-function PanelsItem({ children, name, ...props }: PanelsItemProps) {
+function PanelsItem({ children, name, lazy, ...props }: PanelsItemProps) {
   const { activeTab } = useContext(TabContext)
 
   const hidden = activeTab !== name
 
   return (
     <PanelsItemWrapper {...props} role="tabpanel" aria-hidden={hidden}>
-      {children}
+      {lazy && hidden ? null : children}
     </PanelsItemWrapper>
   )
 }
 
+PanelsItem.defaultProps = {
+  lazy: false,
+}
+
 export interface TabsProps extends HTMLAttributes<HTMLElement>, WithDirectionProps {
   activeTab?: string
   onTabChange?: (tab: string) => void
@@ -228,6 +237,21 @@ const TabsWrapper = styled.div`
   }
 `
 
+/**
+ * @example
+ * <Tabs>
+    <Tabs.Items>
+      <Tabs.Item name="tab-1" default>
+        Tabs 1
+      </Tabs.Item>
+      <Tabs.Item name="tab-2">Tabs 2</Tabs.Item>
+    </Tabs.Items>
+    <Tabs.Panels>
+      <Tabs.Panel name="tab-1">first content</Tabs.Panel>
+      <Tabs.Panel name="tab-2">second content</Tabs.Panel>
+    </Tabs.Panels>
+ * </Tabs>
+ */
 function Tabs({
   children,
   direction = 'horizontal',