IDBCursor.direction
IDBCursor
的方向属性是一个 DOMString
,表示游标遍历的方向, (比如可以通过 IDBObjectStore.openCursor
设置). 查看下文中取值章节获取可取值。
语法
js
cursor.direction;
取值
用一个字符串 (defined by the IDBCursorDirection
enum) 表示游标的遍历方向。相关取值如下表所示:
Value | Description |
---|---|
next |
从数据源开始位置遍历 |
nextunique |
从数据源开始遍历;当取值有重复时,只获取一次。 |
prev |
从数据源的最后位置位置开取值 |
prevunique |
从数据源的最后位置开始取值,只获取一次。 |
例子
在这个简单的例子中,我们首先创建一个事物对象,返回一个对象仓库 (store), 然后使用邮编遍历整个数据仓库。在每次迭代中我们记录了游标的方向,例如 prev(倒序遍历)
html
prev
备注:我们不能改变游标的取值,因为这是个只读属性;应该在IDBObjectStore.openCursor
方法调用的第二个参数指定游标遍历的方向;
使用游标遍历数据时,可以不需要我们指定在特定字段选择数据;我们可以直接获取所有数据,同时在每次循环迭代过程当中,我们可以通过 cursor.value.foo 获取数据,如下是一个完整的游标遍历数据的例子; IDBCursor example (view example live).
js
function backwards() {
list.innerHTML = "";
var transaction = db.transaction(["rushAlbumList"], "readonly");
var objectStore = transaction.objectStore("rushAlbumList");
objectStore.openCursor(null, "prev").onsuccess = function (event) {
var cursor = event.target.result;
if (cursor) {
var listItem = document.createElement("li");
listItem.innerHTML =
"<strong>" +
cursor.value.albumTitle +
"</strong>, " +
cursor.value.year;
list.appendChild(listItem);
console.log(cursor.direction);
cursor.continue();
} else {
console.log("Entries displayed backwards.");
}
};
}
Specifications
Specification |
---|
Indexed Database API 3.0 # ref-for-dom-idbcursor-direction① |
浏览器兼容性
BCD tables only load in the browser
参考资料
- Using IndexedDB
- Starting transactions:
IDBDatabase
- Using transactions:
IDBTransaction
- Setting a range of keys:
IDBKeyRange
- Retrieving and making changes to your data:
IDBObjectStore
- Using cursors:
IDBCursor
- Reference example: To-do Notifications (view example live.)