> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# arc:first

> 仅在 arc:call 或 arc:enum 的第一次迭代中执行脚本块，适用于生成标题或检查对象集中的第一个对象。

export const siteNameShort = "知行之桥";

arc:first 关键字是只在 [arc:call](./op-arc-call) 或 [arc:enum](./op-arc-enum) 的第一次迭代时执行的脚本。这是一种方便的方法，可以在生成对象集剩余部分之前生成标题或检查对象集的第一项。

在第一次迭代中，arc:first 的主体在 [arc:call](./op-arc-call) 或 [arc:enum](./op-arc-enum) 中先于其它代码执行，无论 arc:first 在 [arc:call](./op-arc-call) 或 [arc:enum](./op-arc-enum) 主体中的什么位置。为了起到提醒作用，建议将 arc:first 放到 [arc:call](./op-arc-call) 或 [arc:enum](./op-arc-enum) 主体的顶部。

如果作用域没有对象，那么 arc:first 或 [arc:last](./op-arc-last) 都不会执行。

## 参数

无

## 控制属性

无

## 示例

从对象集中创建一个 HTML 表，其中每个对象都以行的形式表示：

```xml theme={null}
<arc:call op="listCustomers">
  <arc:first>
    <table>
    <thead>
      <arc:enum item="customer">
        <td>[_attr]</td>
      </arc:enum>
    </thead>
  </arc:first>
    <tr>
      <arc:enum item="customer">
        <td>[_value]</td>
      </arc:enum>
    </tr>
  <arc:last>
    </table>
  </arc:last>
</arc:call>
```

## 另请参阅

* [arc:last](./op-arc-last)：只在最后一次迭代时执行的代码块。