@hanzo/ui

Input

import { Input } from '@hanzo/ui'

Default

A single-line text field with a placeholder, for any free text short enough to fit on one line.

export function Default() {
  return (
    <YStack width={320}>
      <Input placeholder="Organization name" />
    </YStack>
  )
}

States

A disabled field takes no focus or input; a read-only one shows a value you can select and copy but not change.

export function States() {
  return (
    <YStack width={320} gap="$3">
      <Input disabled defaultValue="us-east-1" />
      <Input readOnly defaultValue="api.hanzo.ai" />
    </YStack>
  )
}

Adornments

An icon at the start or a unit at the end is drawn inside the field, for a search icon, a currency or a domain suffix.

USD
@hanzo.ai
export function Adornments() {
  return (
    <YStack width={320} gap="$3">
      <Input
        startAdornment={<Search size={16} />}
        placeholder="Search models"
      />
      <Input
        endAdornment={<Text fontSize="$2">USD</Text>}
        placeholder="0.00"
        inputMode="decimal"
      />
      <Input
        startAdornment={<Mail size={16} />}
        endAdornment={<Text fontSize="$2">@hanzo.ai</Text>}
        placeholder="name"
      />
    </YStack>
  )
}

Password

`type="password"` masks the value and draws an eye that reveals it; with `reveal={false}` the eye is left out and the toggle is yours to draw.

export function Password() {
  const [shown, setShown] = useState(false)
  return (
    <YStack width={320} gap="$3">
      <Input type="password" defaultValue="correct horse battery staple" />
      <XStack gap="$2" items="center">
        <YStack flex={1}>
          <Input
            type={shown ? "text" : "password"}
            reveal={false}
            defaultValue="correct horse battery staple"
          />
        </YStack>
        <Button variant="outline" size="sm" onPress={() => setShown((v) => !v)}>
          {shown ? "Hide" : "Show"}
        </Button>
      </XStack>
    </YStack>
  )
}

Controlled

`value` and `onChangeText` keep the text in React state, `maxLength` caps it, and a Label bound by `htmlFor` focuses the field when clicked.

0/32
export function Controlled() {
  const [name, setName] = useState("")
  return (
    <YStack width={320} gap="$2">
      <Label htmlFor="project-name">Project name</Label>
      <Input
        id="project-name"
        value={name}
        onChangeText={setName}
        placeholder="my-agent"
        maxLength={32}
      />
      <Text fontSize="$2" color="$quiet">
        {name.length}/32
      </Text>
    </YStack>
  )
}

Types

export type InputProps = Omit<ComponentProps<typeof GuiInput>, 'children' | 'size'> & {
  /** Optional leading affordance (icon/text) rendered inside the field. */
  startAdornment?: ReactNode
  /** Optional trailing affordance rendered inside the field. */
  endAdornment?: ReactNode
  /**
   * Whether a masked field draws its own show/hide eye. Default true.
   *
   * `false` when the caller owns the reveal — `SecretInput` does, and so does
   * any field that masks locally — because two controls over one boolean is a
   * field with two states that disagree: press ours and the caller's icon still
   * reads "show", press theirs and ours does. The field is masked by whichever
   * was pressed last and neither control can say which.
   */
  reveal?: boolean
  /**
   * The box: `default` 36 high, `lg` 46 for a page's own form, `sm` 32 and `xs`
   * 24 for the record density (control.ts `BOX`). Unset, the nearest `<Density>`
   * decides; inside an `InputGroup` the group's box is the field's.
   */
  size?: FieldSize
  /** On the raised ground instead of a bare edge (control.ts `FILL`). */
  fill?: boolean
}

Exports

Inputtype InputProps