复合输入控件 Input Group
用于把各种输入控件和按钮组合在一起。
基础使用
把各种输入控件和按钮组合在一起,目前支持以下组件:
- Input
- InputNumber
- InputTag
- AutoComplete
- Select
- Button
- InputGroupLabel
- ColorPicker
- TimePicker
- DatePicker
- DateTimePicker
.ini
隐藏源代码
圆角边框
shape 属性控制形状。
borderRadius 设置按钮圆角,优先级高于 shape,与 CSS border-radius 行为一致。
精力和技术力不太充足,自定义圆角还有需要优化的地方,但整体不影响使用。
隐藏源代码
控件尺寸
size 属性控制尺寸。
隐藏源代码
禁用状态
disabled 会设置子控件的禁用状态。
隐藏源代码
API
InputGroupProps
| 属性 | 类型 | 可选 | 默认值 | 描述 | 版本 |
|---|---|---|---|---|---|
| borderRadius | NumberOrPercentage | NumberOrPercentage[] | 是 | | 圆角半径,优先级高于 shape,将覆盖子组件的 borderRadius,圆角仅作用于两侧子组件的外侧边框。与 CSS border-radius 行为一致;单值或长度为 1 的数组 → 四角同时生效;长度为 2 的数组 → [左上 & 右下, 右上 & 左下];长度为 3 的数组 → [左上, 右上 & 左下, 右下];长度为 4 的数组 → 按顺时针顺序依次作用于四角。 | 0.0.2 |
| shape | 'rect' | 'round' | 是 | 'rect' | 组件形状,将覆盖子组件的 shape,圆角仅作用于两侧子组件的外侧边框。 | 0.0.3 |
| size | 'medium' | 'large' | 'small' | 是 | 'medium' | 组件尺寸,将覆盖子组件的 size。 | 0.0.2 |
| disabled | boolean | 是 | false | 是否禁用。 | 0.0.2 |
| readonly | boolean | 是 | false | 是否只读。 | 0.0.3 |
| pollSizeChange | boolean | 是 | false | 开启轮询组件尺寸变化,会影响作为子组件的数据输入组件的同名属性。 | 0.1.0 |
InputGroupSlots
| 插槽 | 参数 | 描述 | 版本 |
|---|---|---|---|
| default | | 需要组合的组件。 | 0.0.2 |
InputGroupLabelProps
| 属性 | 类型 | 可选 | 默认值 | 描述 | 版本 |
|---|---|---|---|---|---|
| backgroundColor | string | 是 | | 背景颜色,详见 支持的颜色解析。 | 0.0.2 |
| borderRadius | NumberOrPercentage | NumberOrPercentage[] | 是 | | 圆角半径,优先级高于 shape。与 CSS border-radius 行为一致;单值或长度为 1 的数组 → 四角同时生效;长度为 2 的数组 → [左上 & 右下, 右上 & 左下];长度为 3 的数组 → [左上, 右上 & 左下, 右下];长度为 4 的数组 → 按顺时针顺序依次作用于四角。 | 0.0.2 |
| shape | 'rect' | 'round' | 是 | 'rect' | 组件形状。 | 0.0.3 |
| size | 'medium' | 'large' | 'small' | 是 | 'medium' | 组件尺寸。 | 0.0.2 |
| pollSizeChange | boolean | 是 | false | 开启轮询组件尺寸变化,可能会影响性能。 | 0.1.0 |
InputGroupLabelSlots
| 插槽 | 参数 | 描述 | 版本 |
|---|---|---|---|
| default | | 标签内容。 | 0.0.2 |
NumberOrPercentage
ts
export type NumberOrPercentage = number | `${number}%`