# ビュー

- Human documentation: [https://docs.univer.ai/ja-JP/guides/bases/model/views](https://docs.univer.ai/ja-JP/guides/bases/model/views)

- Agent Markdown: [https://docs.univer.ai/ja-JP/guides/bases/model/views.md](https://docs.univer.ai/ja-JP/guides/bases/model/views.md)

- Requested language: `ja-JP`

- Content language: `ja-JP`

- Documentation version: `1.2.0`

- Source: [bases/model/views.ja-JP.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/bases/model/views.ja-JP.mdx)

---

ビューは、ユーザーにテーブルをどのように表示するかを定義します。ビューでは、フィールドの非表示や並べ替え、レコードの絞り込み、並べ替え、グループ化のほか、グリッド、カンバン、カレンダー、ガント、ギャラリーの各表示形式に固有の設定を定義できます。

## ビューのスナップショット

| プロパティ          | 型                                     | 説明                                                         |              |
| -------------- | ------------------------------------- | ---------------------------------------------------------- | ------------ |
| id             | `string`                              | ビューID。                                                     |              |
| tableId        | `string`                              | このビューを所有するテーブルのID。                                         |              |
| name           | `string`                              | ビュー名。                                                      |              |
| type           | `BaseViewType`                        | `grid`, `kanban`, `calendar`, `gantt`, `gallery`, `pivot`. |              |
| fieldOrder?    | `string[]`                            | このビューでのフィールドの順序。                                           |              |
| fieldSettings? | `Record\<string, IViewFieldSetting\>` | フィールドごとの表示状態、幅、カード設定。                                      |              |
| filter?        | \`IFilterConfig                       | null\`                                                     | ビューのフィルター設定。 |
| sort?          | `ISortConfig[]`                       | 並べ替えルール。                                                   |              |
| group?         | `IGroupConfig[]`                      | グループ化ルール。                                                  |              |
| config         | `ViewSpecificConfig`                  | ビュー形式固有の設定。                                                |              |

## ビュー形式

| 形式         | 用途                                                 |
| ---------- | -------------------------------------------------- |
| `grid`     | スプレッドシートのような形式でテーブルを編集します。                         |
| `kanban`   | 選択肢、ユーザー、グループ、テキスト、日付のいずれかのフィールドに基づいてカードをグループ化します。 |
| `calendar` | 日付フィールドに基づいてレコードを配置します。                            |
| `gantt`    | 開始日と終了日のフィールドを使ってタイムラインを計画します。                     |
| `gallery`  | 画像やコンテンツの多いレコードをカード形式で配置します。                       |
| `pivot`    | 集計とグラフ表示にはダッシュボードプラグインが必要です。                       |

## ビューの作成

```ts
const view = table.createView('Kanban', univerAPI.Enum.BaseViewType.Kanban)
```

## フィルタリングと並べ替えの設定

```ts
view.setFilter({
  conjunction: univerAPI.Enum.BaseFilterConjunction.AND,
  conditions: [
    {
      fieldId: 'status',
      operator: univerAPI.Enum.BaseFilterOperator.IS,
      operand: 'In progress',
    },
  ],
})

view.setSort([
  { fieldId: 'dueDate', direction: univerAPI.Enum.BaseSortDirection.ASC },
])
```

## フィールドの表示状態と幅

```ts
view.setFieldVisible('internalNotes', false)
view.setFieldWidth('title', 280)
```

[ダッシュボードとピボットビュー](https://docs.univer.ai/ja-JP/guides/bases/features/dashboard.md)