@hanzo/ui

Resizable

import { ResizablePanelGroup, ResizablePanel, ResizableHandle } from '@hanzo/ui'

Default

Two panels share the width evenly, and the handle between them moves the boundary by drag or, once focused, by the arrow keys: five percent a press, one with Shift held.

Filessrc/index.tssrc/resizable.tsxpackage.json

Pick a file to see its contents.

export function Default() {
  return (
    <ResizablePanelGroup
      direction="horizontal"
      height={200}
      maxW={560}
      borderWidth={1}
      borderColor="$borderColor"
      rounded="$3"
    >
      <ResizablePanel p="$3" gap="$1">
        <Text fontSize={13} fontWeight="600">
          Files
        </Text>
        <Text fontFamily="$mono" fontSize={13} color="$color11">
          src/index.ts
        </Text>
        <Text fontFamily="$mono" fontSize={13} color="$color11">
          src/resizable.tsx
        </Text>
        <Text fontFamily="$mono" fontSize={13} color="$color11">
          package.json
        </Text>
      </ResizablePanel>
      <ResizableHandle />
      <ResizablePanel p="$3">
        <Paragraph fontSize={13} color="$color11">
          Pick a file to see its contents.
        </Paragraph>
      </ResizablePanel>
    </ResizablePanelGroup>
  )
}

Vertical

`direction="vertical"` stacks the panels top to bottom, `defaultSize` gives the lower one its starting share, and `withHandle` draws a grip on the divider so it reads as draggable.

const server = createServer(handler)server.listen(3000)
$ pnpm test14 passed in 1.2s
export function Vertical() {
  return (
    <ResizablePanelGroup
      direction="vertical"
      height={240}
      maxW={560}
      borderWidth={1}
      borderColor="$borderColor"
      rounded="$3"
    >
      <ResizablePanel p="$3" gap="$1">
        <Text fontFamily="$mono" fontSize={13}>
          const server = createServer(handler)
        </Text>
        <Text fontFamily="$mono" fontSize={13}>
          server.listen(3000)
        </Text>
      </ResizablePanel>
      <ResizableHandle withHandle />
      <ResizablePanel defaultSize={35} p="$3" gap="$1" bg="$raised">
        <Text fontFamily="$mono" fontSize={13} color="$color11">
          $ pnpm test
        </Text>
        <Text fontFamily="$mono" fontSize={13} color="$color11">
          14 passed in 1.2s
        </Text>
      </ResizablePanel>
    </ResizablePanelGroup>
  )
}

Limits

`minSize` and `maxSize` clamp how far a boundary moves, a disabled handle keeps one in place, and `onLayout` reports every change as percentages of the group.

Navigation15% to 40%
Document
InspectorPinned
25% / 55% / 20%
export function Limits() {
  const [sizes, setSizes] = useState([25, 55, 20])
  return (
    <YStack gap="$2" maxW={560}>
      <ResizablePanelGroup
        direction="horizontal"
        height={180}
        borderWidth={1}
        borderColor="$borderColor"
        rounded="$3"
        onLayout={setSizes}
      >
        <ResizablePanel
          defaultSize={25}
          minSize={15}
          maxSize={40}
          p="$3"
          gap="$1"
        >
          <Text fontSize={13} fontWeight="600">
            Navigation
          </Text>
          <Text fontSize={12} color="$color11">
            15% to 40%
          </Text>
        </ResizablePanel>
        <ResizableHandle />
        <ResizablePanel p="$3">
          <Text fontSize={13} fontWeight="600">
            Document
          </Text>
        </ResizablePanel>
        <ResizableHandle disabled />
        <ResizablePanel defaultSize={20} p="$3" gap="$1">
          <Text fontSize={13} fontWeight="600">
            Inspector
          </Text>
          <Text fontSize={12} color="$color11">
            Pinned
          </Text>
        </ResizablePanel>
      </ResizablePanelGroup>
      <Text fontSize={12} color="$color10">
        {sizes.map((s) => `${Math.round(s)}%`).join(" / ")}
      </Text>
    </YStack>
  )
}

Collapsible

A collapsible panel's floor is `collapsedSize` rather than `minSize`, and `onResize` reports its share so the content can turn into icons once the rail is narrow.

Inbox
Sent
Archive

Drag the rail narrower than 15% and the labels give way to icons.

export function Collapsible() {
  const [rail, setRail] = useState(24)
  const narrow = rail < 15
  const rows = [
    { icon: Inbox, label: "Inbox" },
    { icon: Send, label: "Sent" },
    { icon: Archive, label: "Archive" },
  ]
  return (
    <ResizablePanelGroup
      direction="horizontal"
      height={200}
      maxW={560}
      borderWidth={1}
      borderColor="$borderColor"
      rounded="$3"
    >
      <ResizablePanel
        defaultSize={24}
        minSize={20}
        collapsible
        collapsedSize={10}
        onResize={setRail}
        p="$3"
        gap="$2"
      >
        {rows.map(({ icon: Icon, label }) => (
          <XStack
            key={label}
            gap="$2"
            items="center"
            justify={narrow ? "center" : "flex-start"}
          >
            <Icon size={16} />
            {!narrow && <Text fontSize={13}>{label}</Text>}
          </XStack>
        ))}
      </ResizablePanel>
      <ResizableHandle withHandle />
      <ResizablePanel p="$3">
        <Paragraph fontSize={13} color="$color11">
          Drag the rail narrower than 15% and the labels give way to icons.
        </Paragraph>
      </ResizablePanel>
    </ResizablePanelGroup>
  )
}

Nested

A group inside a panel splits the other axis, and `autoSaveId` on each group keeps its arrangement in the browser, keyed by the panels' `id`s, so it comes back on the next visit.

Explorersrc/app.tsxsrc/routes.ts
export const routes = defineRoutes(app)
Problemssrc/app.tsx:12 unused import Router
export function Nested() {
  return (
    <ResizablePanelGroup
      direction="horizontal"
      autoSaveId="docs.workbench"
      height={260}
      maxW={560}
      borderWidth={1}
      borderColor="$borderColor"
      rounded="$3"
    >
      <ResizablePanel id="explorer" defaultSize={30} p="$3" gap="$1">
        <Text fontSize={13} fontWeight="600">
          Explorer
        </Text>
        <Text fontFamily="$mono" fontSize={13} color="$color11">
          src/app.tsx
        </Text>
        <Text fontFamily="$mono" fontSize={13} color="$color11">
          src/routes.ts
        </Text>
      </ResizablePanel>
      <ResizableHandle withHandle />
      <ResizablePanel id="workbench">
        <ResizablePanelGroup
          direction="vertical"
          autoSaveId="docs.workbench.editor"
        >
          <ResizablePanel id="editor" p="$3">
            <Text fontFamily="$mono" fontSize={13}>
              export const routes = defineRoutes(app)
            </Text>
          </ResizablePanel>
          <ResizableHandle withHandle />
          <ResizablePanel id="problems" defaultSize={30} p="$3" gap="$1">
            <Text fontSize={13} fontWeight="600">
              Problems
            </Text>
            <Text fontFamily="$mono" fontSize={13} color="$color11">
              src/app.tsx:12 unused import Router
            </Text>
          </ResizablePanel>
        </ResizablePanelGroup>
      </ResizablePanel>
    </ResizablePanelGroup>
  )
}

Types

export type ResizablePanelGroupProps = Omit<
  XStackProps,
  "onLayout" | "direction"
> & {
  direction: ResizeDirection
  autoSaveId?: string
  onLayout?: (sizes: number[]) => void
  children?: ReactNode
}
export type ResizablePanelProps = Omit<XStackProps, "id" | "onLayout"> & {
  id?: string
  order?: number
  defaultSize?: number
  minSize?: number
  maxSize?: number
  collapsible?: boolean
  collapsedSize?: number
  onResize?: (size: number) => void
  children?: ReactNode
}
export type ResizableHandleProps = Omit<
  XStackProps,
  "disabled" | "onLayout"
> & {
  withHandle?: boolean
  disabled?: boolean
}

Exports

ResizablePanelGroupResizablePanelResizableHandletype ResizablePanelGroupPropstype ResizablePanelPropstype ResizableHandleProps