تخطّي إلى المحتوى الرئيسي

زر اختيار Radio

اختيار واحد من بين مجموعة خيارات، ويدعم الاستخدام المنفرد أو مع LhRadioGroup.

الاستخدام الأساسي​

اختيار مجموعة

المحدد: ink

import { useState } from 'react'
import { LhRadio, LhRadioGroup } from '@lh-ui/react'

export default function Demo() {
const [value, setValue] = useState('ink')

return (
<LhRadioGroup value={value} onChange={(val) => setValue(val as string)}>
<LhRadio value="ink">رسم الحبر</LhRadio>
<LhRadio value="danqing">ألوان دانتشينغ</LhRadio>
<LhRadio value="blank">مساحة فارغة</LhRadio>
</LhRadioGroup>
)
}

Radio Props​

الخاصيةالوصفالنوعالقيم المتاحةالافتراضي
valueقيمة الخيار (مطلوبة)unknown——
checkedحالة التحديد المتحكَّم بها (عند الاستخدام المنفرد)boolean——
defaultCheckedالتحديد الافتراضي غير المتحكَّم بهboolean—false
labelالنص الظاهرstring——
disabledمعطّلboolean—false
sizeالحجم'large' | 'middle' | 'small'—يُكتسَب من ConfigProvider
nameالخاصية الأصلية name (تُمرَّر عبر Group)string——
sxخصائص تخطيط سريعةSxProps——

Radio أحداث​

الحدثالوصفمعامل الاستدعاءالمقابل في Vue
onChangeيُطلَق عند التحديد (معاملان)(checked: boolean, event: ChangeEvent) => void@change

RadioGroup Props​

الخاصيةالوصفالنوعالافتراضي
valueقيمة التحديد المتحكَّم بهاunknown—
defaultValueالقيمة الافتراضية غير المتحكَّم بهاunknown—
disabledتعطيل جميع العناصر الفرعيةbooleanfalse
sizeحجم العناصر الفرعية'large' | 'middle' | 'small'يُكتسَب من ConfigProvider
nameالخاصية الأصلية name المُمرَّرة إلى العناصر الفرعيةstring—

RadioGroup أحداث​

الحدثالوصفمعامل الاستدعاءالمقابل في Vue
onChangeتغيُّر التحديد، ومعامل الاستدعاء هو قيمة الخيار المحدد(value: unknown) => void@change
فروق معاملات onChange

استدعاء onChange في LhRadio هو (checked, event)، بينما يكون استدعاء onChange في LhRadioGroup مباشرةً value للعنصر المحدد — وذلك يتوافق مع CheckboxGroup.

الأنماط​

import '@lh-ui/react/style/radio'