---
url: /docs/forms/components/col.md
---
# Col 组件

## 概述

`Col` 类用于创建表单中的列布局。它继承自 `FormComponent`，并提供了不同的列宽度设置。

## 使用方法

### 设置列宽度

* **设置宽度为 4**

  ```php
  public function span4(): static
  ```

  返回当前实例，设置列宽度为 4。

* **设置宽度为 6**

  ```php
  public function span6(): static
  ```

  返回当前实例，设置列宽度为 6。

* **设置宽度为 8**

  ```php
  public function span8(): static
  ```

  返回当前实例，设置列宽度为 8。

* **设置宽度为 12**

  ```php
  public function span12(): static
  ```

  返回当前实例，设置列宽度为 12。

### 设置列的具体宽度

```php
protected function span(int $span): static
```

* **参数**:
  * `int $span`: 列宽度值。
* **返回**: 返回当前实例。

## 示例

```php
$col = new Col(function($form) {
    // 在这里定义表单项
});

$col->span4(); // 设置列宽为 4
```

## 说明

* `Col` 类通过回调函数构造表单，并允许用户设置不同的列宽度，以便灵活控制表单布局。
* 使用 `span` 方法可以设置列的具体宽度，支持的值通常为 4, 6, 8, 和 12。