wui
组件

单选框 Radio Group

用于互斥选项的轻量单选控件组。

基础示例

Loading…
pnpm dlx wui@latest add @wui/radio-group
components/ui/radio-group.tsx
"use client"

import * as React from "react"
import { RadioGroup as RadioGroupPrimitive } from "radix-ui"
import { cva } from "class-variance-authority"

import { cn } from "@/lib/utils"

function RadioGroup({ className, ...props }: React.ComponentProps<typeof RadioGroupPrimitive.Root>) {
  return (
    <RadioGroupPrimitive.Root
      data-slot="radio-group"
      className={cn("grid gap-2.5", className)}
      {...props}
    />
  )
}

const radioGroupItemVariants = cva(
  "peer inline-flex shrink-0 cursor-pointer items-center justify-center rounded-full border border-input bg-background shadow-xs outline-none transition-[border-color,box-shadow,transform] duration-150 ease-out hover:border-ring/70 active:scale-[0.94] focus-visible:ring-[3px] focus-visible:ring-ring/35 disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:border-primary",
  {
    variants: {
      size: {
        sm: "size-4",
        default: "size-5",
        lg: "size-6",
      },
    },
    defaultVariants: { size: "default" },
  }
)

export interface RadioGroupItemProps
  extends React.ComponentProps<typeof RadioGroupPrimitive.Item> {
  /** Physical size of the radio control. @default "default" */
  size?: "sm" | "default" | "lg"
}

/** One option inside a RadioGroup. */
function RadioGroupItem({ className, size = "default", ...props }: RadioGroupItemProps) {
  return (
    <RadioGroupPrimitive.Item
      data-slot="radio-group-item"
      data-size={size}
      className={cn(radioGroupItemVariants({ size }), className)}
      {...props}
    >
      <RadioGroupPrimitive.Indicator
        data-slot="radio-group-indicator"
        className="size-1/2 rounded-full bg-primary"
      />
    </RadioGroupPrimitive.Item>
  )
}

export { RadioGroup, RadioGroupItem, radioGroupItemVariants }

组件作用

RadioGroup 用于从两个或更多互斥选项中选择一项。环形边框与全局主色实心圆点保持清晰的选中反馈,同时保留方向键切换、焦点管理与表单语义。

组件属性

PropTypeDefaultDescription
disabledboolean
asChildboolean

事件

onValueChange(value) 在选择变化后触发。RadioGroupItem 接收必需的 value,原生焦点、禁用与表单属性会继续透传。

拓展使用

通过 orientation 控制键盘导航方向,通过 disabled 禁用整组或单项。RadioGroupItem 支持 size="sm | default | lg",标签应使用原生 label 包裹或通过 htmlFor 关联。