---
url: /components/basic/FaLabel.md
---
# FaLabel 标签

表单标签组件，支持固定宽度标签和自定义内容，用于表单字段的标签显示。

## 使用场景

* 表单字段标签
* 多列表单布局
* 需要固定标签宽度的表单
* 表单项的组合布局

## Props

| 属性 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `label` | `string` | - | 标签文本 |
| `labelWidth` | `string \| number` | - | 标签宽度（支持数字 px 或字符串） |
| `class` | `HTMLAttributes['class']` | - | 自定义 CSS 类 |

## Slots

| 名称 | 说明 |
|------|------|
| `default` | 表单项内容（输入框、选择器等） |

## 注意事项

1. **labelWidth 类型**：
   * 数字：自动转换为 `px` 单位
   * 字符串：直接使用（如 `"120px"`, `"10em"`, `"8rem"` 等）

2. **标签对齐**：多个表单项使用相同的 `labelWidth` 可实现标签对齐

3. **无 label 属性**：不设置 `label` 属性时，仅作为布局容器使用