> ## 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:if

> 計算包含物件、屬性和值的運算式，並在運算式為 true 時執行正文塊。

export const siteNameShort = "知行之橋";

可以使用 arc:if 關鍵字來計算包含物件，屬性和值的運算式。如果指定運算式計算為 ture，則執行此關鍵詞的範圍。

## 參數

* **exp**：要計算的運算式。可以使用字串，日期和數字進行比較。
* **attr**：與目標值比較的屬性的名稱。可以檢查屬性值是否與目標值匹配，也可以檢查屬性值是否為空。
* **value**：與 **attr** 指定的屬性值進行比較的目標值。
* **item**：包含被比較屬性的物件。
* **operator**：用於比較由 **attr** 和 **value** 指定運算物件的運算器名稱。允許的值有：`null`，`notnull`，`hasvalue`，`equals`，`equalsignorecase`，`notequals`，`lessthan` 和 `greaterthan`。預設為：`notnull`。
* **action**：運算式計算結果為 `true` 時要執行的操作。允許的值有：`break`，`continue`。

## 控制屬性

無

## 範例

計算一個簡單的兩值比較：

```xml theme={null}
<arc:if exp="[attr] == 10">
```

判斷給定值與給定屬性值的相等性：

```xml theme={null}
<arc:set attr="attr1" value="value1"/>
<arc:set attr="attr2" value="value2"/>
<arc:if attr="attr1" value="[attr2]" operator="notequals"> <!-- Evaluates to true -->
<arc:else>
False
</arc:else>
True
</arc:if>
```

判斷屬性是否存在：

```xml theme={null}
<arc:set attr="exists" value="true"/>
<arc:if attr="exists"> <!-- Evaluates to true -->
[exists]
</arc:if>
```

## 另請參閱

* [arc:exists](./op-arc-exists)：檢查特定物件中的屬性是否有值。
* [arc:equals](./op-arc-equals)：建立一個相等時執行的程式碼塊。