Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Web/API/IDBCursor/direction を更新 #22890

Merged
merged 1 commit into from
Aug 6, 2024
Merged

Web/API/IDBCursor/direction を更新 #22890

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 13 additions & 17 deletions files/ja/web/api/idbcursor/direction/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,38 +1,34 @@
---
title: IDBCursor.direction
title: "IDBCursor: direction プロパティ"
short-title: direction
slug: Web/API/IDBCursor/direction
l10n:
sourceCommit: 96eac9a9130cdf8b95be7089c7b7fbd06ccdee45
sourceCommit: 4dec42ed700040565e8af0e14ff104054ebc20f5
---

{{ APIRef("IndexedDB") }}
{{ APIRef("IndexedDB") }} {{AvailableInWorkers}}

{{domxref("IDBCursor")}} インターフェイスの読み取り専用プロパティ **`direction`** は、(たとえば {{domxref("IDBObjectStore.openCursor")}} で設定した) カーソルの走査の方向を表す文字列です。取りうる値は、以下の[値](#%E5%80%A4)の節を参照してください。

{{AvailableInWorkers}}
**`direction`** は {{domxref("IDBCursor")}} インターフェイスの読み取り専用プロパティで、(たとえば {{domxref("IDBObjectStore.openCursor")}} で設定した) カーソルの走査の方向を表す文字列です。取りうる値は、以下の[値](#%E5%80%A4)の節を参照してください。

## 値

カーソルがデータを走査する方向を表す文字列です。以下の値を取りえます。

- `next`
- : この方向は、カーソルを走査対象の最初で開きます。
- : この方向は、カーソルを走査対象の先頭で開きます。
- `nextunique`
- : この方向は、カーソルを走査対象の最初で開きます。重複した値を持つキーについては、最初のレコードのみを返します。
- : この方向は、カーソルを走査対象の先頭で開きます。重複した値を持つキーについては、最初に訪れた（先頭に最も近い）レコードのみを返します。
- `prev`
- : この方向は、カーソルを走査対象の最後で開きます。
- : この方向は、カーソルを走査対象の末尾で開きます。
- `prevunique`
- : この方向は、カーソルを走査対象の最後で開きます。重複した値を持つキーについては、最初のレコードのみを返します。
- : この方向は、カーソルを走査対象の末尾で開きます。重複した値を持つキーについては、最初に訪れた（末尾に最も近い）レコードのみを返します。

## 例

このシンプルな断片では、トランザクションを作成し、オブジェクトストアを取得し、カーソルを使用してオブジェクトストア内の全レコードを走査します。それぞれの繰り返しにおいて、たとえば以下のようなカーソルの方向を記録します。

```
prev
```
このシンプルな断片では、トランザクションを作成し、オブジェクトストアを取得し、カーソルを使用してオブジェクトストア内の全レコードを走査します。それぞれの繰り返しにおいて、カーソルの方向を記録します。

> **メモ:** `direction` プロパティは読み取り専用なので、このプロパティを用いてカーソルが動く方向を変えることはできません。カーソルが動く方向は、{{domxref("IDBObjectStore.openCursor")}} の第 2 引数で設定します。
> [!NOTE]
> `direction` プロパティは読み取り専用なので、このプロパティを用いてカーソルが動く方向を変えることはできません。カーソルが動く方向は、{{domxref("IDBObjectStore.openCursor")}} の第 2 引数で設定します。
Comment on lines +30 to +31
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[mdn-linter] reported by reviewdog 🐶

Suggested change
> [!NOTE]
> `direction` プロパティは読み取り専用なので、このプロパティを用いてカーソルが動く方向を変えることはできません。カーソルが動く方向は、{{domxref("IDBObjectStore.openCursor")}} の第 2 引数で設定します。
> [!NOTE] > `direction` プロパティは読み取り専用なので、このプロパティを用いてカーソルが動く方向を変えることはできません。カーソルが動く方向は、{{domxref("IDBObjectStore.openCursor")}} の第 2 引数で設定します。


カーソルを使う場合、データをキーで選択する必要はなく、単に全て取得できます。また、ループ中のそれぞれの繰り返しにおいて、カーソルオブジェクトが指している現在のレコードからデータを `cursor.value.foo` のようにして取得できます。動く例全体は、[IDBCursor example](https://github.com/mdn/dom-examples/tree/main/indexeddb-examples/idbcursor) を参照してください。([動く例を見る](https://mdn.github.io/dom-examples/indexeddb-examples/idbcursor/))

Expand Down Expand Up @@ -74,4 +70,4 @@ function backwards() {
- キーの範囲の設定: {{domxref("IDBKeyRange")}}
- データの取得と変更: {{domxref("IDBObjectStore")}}
- カーソルの使用: {{domxref("IDBCursor")}}
- リファレンス例: [To-do Notifications](https://github.com/mdn/dom-examples/tree/main/to-do-notifications) ([動く例を見る](https://mdn.github.io/dom-examples/to-do-notifications/))
- 参考例: [To-do Notifications](https://github.com/mdn/dom-examples/tree/main/to-do-notifications) ([動く例を見る](https://mdn.github.io/dom-examples/to-do-notifications/))
Loading