RadioGroup
一个适用于 ReactLynx 的无样式单选组组件,用于管理一组单选按钮的单选状态。Info
你可以查看源码来了解它的运行原理,也欢迎大家提 PR 来丰富其能力。
基础用法
示例
禁用
RadioGroup 支持整组禁用,也支持为单个选项设置禁用状态。
结构
组件 API
RadioGroupRoot
The root component of the RadioGroup, containing all of its child components.
defaultValueiOSAndroidHarmony
RadioGroup 被选中的初始值。使用此属性意味着 RadioGroup 是非受控的。如果值不匹配任何一个 Radio 的值,RadioGroup 将不会被选中。
disablediOSAndroidHarmony
如果设置为 true,RadioGroup 将不能接受交互。
onValueChangeiOSAndroidHarmony
选中状态改变时触发
valueiOSAndroidHarmony
RadioGroup 被选中的值。使用此属性意味着 RadioGroup 是受控的。如果值不匹配任何一个 Radio 的值,RadioGroup 将不会被选中。
childreniOSAndroidHarmony
子节点
基于状态的样式与渲染
该组件通过以下一种或两种方式暴露运行时状态。下表仅展示每个状态实际支持的方式:
- UI variant class:支持时,对应组件节点会动态加上
ui-<state>形式的类名,可用.ui-<state> { ... }选择器定制样式; - Render-prop 字段:支持时,当
children传入函数,状态会以children({ <state>: boolean, ... })的形式作为参数传入,便于在运行时做条件渲染。
RadioGroupRoot exposes the following render prop states.
| 渲染属性 | 类型 | 说明 |
|---|---|---|
value | string | null | RadioGroup 当前被选中的值。 |
disabled | boolean | RadioGroup 是否整体被禁用。 |
Radio
The item inside RadioGroup.
childreniOSAndroidHarmony
子组件
classNameiOSAndroidHarmony
类名
disablediOSAndroidHarmony
Radio 是否被禁用。如果设置为 true,则该 Radio 无法接受交互。
radioPropsiOSAndroid
Radio 支持将原始视图属性直接展开到这个属性中。
styleiOSAndroidHarmony
样式
valueiOSAndroidHarmony
Radio 的标识
UI variants applied by Radio.
| 类名 | 说明 |
|---|---|
| ui-active | Radio 处于按下态且未被禁用时生效,可用于 `.ui-active { ... }`。 |
| ui-checked | Radio 处于选中态时生效,可用于 `.ui-checked { ... }`。 |
| ui-disabled | Radio 被禁用时生效,可用于 `.ui-disabled { ... }`。 |
RadioIndicator
The check slot indicating this Radio is now selected. Normally a circle. It's children will only be rendered when selected so it can be a custom inner selected indicator. Can be a ReactNode or a render function returns a ReactNode.
childreniOSAndroidHarmony
子节点
classNameiOSAndroidHarmony
类名
forceMountiOSAndroid
强制挂载子节点。如果设置为 true,即使 checked 为 false,子节点也会被挂载。
styleiOSAndroidHarmony
样式
UI variants applied by RadioIndicator.
| 类名 | 说明 |
|---|---|
| ui-active | Radio 处于按下态且未被禁用时生效,可用于 `.ui-active { ... }`。 |
| ui-checked | Radio 处于选中态时生效,可用于 `.ui-checked { ... }`。 |
| ui-disabled | Radio 被禁用时生效,可用于 `.ui-disabled { ... }`。 |