---
updatedAt: 2025-09-16T22:08:46.000Z
agentTools:
  projectIndex: https://developers.karte.io/llms.txt
---

# widget.setState

state を変更します。

> 📘 state とは
>
> state とは表示/非表示や Widget の状態を管理するための Integer です。\
> デフォルトでは `0: 非表示` と `1: 表示` が用意されていますが、KARTE のエディタ上で表示状態を複数定義することが可能です。

# Syntax:

```javascript
widget.setState(state)
```

# Arguments:

<Table align={["left","left","left","left","left"]}>
  <thead>
    <tr>
      <th>
        Name
      </th>

      <th>
        Type
      </th>

      <th>
        Required
      </th>

      <th>
        Default
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        state
      </td>

      <td>
        Number
      </td>

      <td>
        ○
      </td>

      <td>

      </td>

      <td>
        ステートを表す数値
      </td>
    </tr>
  </tbody>
</Table>

```javascript
widget.setState(1)
```

> 📘 setStateは、ktr-onで指定するハンドラとして直接呼び出すことができます
>
> showやhideとは異なり、setStateはkrt-onで登録するハンドラに直接指定することができます。
>
> ```html
> <div krt-on:click="setState(0)">閉じる</div>
> ```
>
> showやhideをHTML側でハンドラとして指定したい場合は、widget.methodで登録してください。