HTML 履歴リストへのアクセス

Adobe AIR 1.0 およびそれ以降

HTMLLoader オブジェクトに新しいページが読み込まれるとき、ランタイムでは、そのオブジェクトの履歴リストを維持します。履歴リストは、HTML ページの window.history オブジェクトに対応します。HTMLLoader クラスに含まれている次のプロパティとメソッドを使用すると、HTML 履歴リストを操作することができます。

クラスメンバー

説明

historyLength

後方と前方のエントリを含む、履歴リスト全体の長さです。

historyPosition

履歴リストでの現在の位置です。この位置より前の履歴アイテムは「戻る」ナビゲーションを表し、この位置より後の履歴アイテムは「進む」ナビゲーションを表します。

getHistoryAt()

履歴リスト内の指定した位置にある履歴エントリに対応する URLRequest オブジェクトを返します。

historyBack()

可能であれば、履歴リスト内を後方に進みます。

historyForward()

可能であれば、履歴リスト内を前方に進みます。

historyGo()

ブラウザーの履歴内を指定のステップ数だけ移動します。正の場合は前方に、負の場合は後方に移動します。0 の場合はページが再読み込みされます。終端を超える位置を指定すると、リストの最後に移動します。

履歴リスト内の項目は、 HTMLHistoryItem 型のオブジェクトとして格納されます。HTMLHistoryItem クラスには、次のプロパティがあります。

プロパティ

説明

isPost

HTML ページに POST データが含まれている場合は true に設定されます。

originalUrl

リダイレクトされる前の HTML ページの元の URL です。

title

HTML ページのタイトルです。

url

HTML ページの URL です。