From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/location/index.html | 109 ++++++++++++++++++++++++++++ files/ja/web/api/location/reload/index.html | 59 +++++++++++++++ 2 files changed, 168 insertions(+) create mode 100644 files/ja/web/api/location/index.html create mode 100644 files/ja/web/api/location/reload/index.html (limited to 'files/ja/web/api/location') diff --git a/files/ja/web/api/location/index.html b/files/ja/web/api/location/index.html new file mode 100644 index 0000000000..feb977ab29 --- /dev/null +++ b/files/ja/web/api/location/index.html @@ -0,0 +1,109 @@ +--- +title: Location +slug: Web/API/Location +tags: + - API + - HTML DOM + - Interface + - Location + - Reference + - インターフェイス +translation_of: Web/API/Location +--- +
{{APIRef("HTML DOM")}}
+ +

Location インターフェイスは、関連付けられたオブジェクトの場所 (URL) を表します。 Location に対して変更が行われると、関連するオブジェクトに反映されます。 {{domxref("Document")}} インターフェイスおよび {{domxref("Window")}} インターフェイスにはこのような関連付けられた Location があり、それぞれ {{domxref("Document.location")}} および {{domxref("Window.location")}} でアクセスできます。

+ +

プロパティ

+ +
+
{{domxref("Location.href")}}
+
URL 全体を収めた {{domxref("USVString")}} を返す文字列化です。この値を変更すると、関連付けられた文書が新しいページへ移動します。この値は、関連付けられた文書のものとは異なるオリジンから設定できます。
+
{{domxref("Location.protocol")}}
+
末尾の ':' を含む、URL のプロトコルスキームを収めた {{domxref("USVString")}} です。
+
{{domxref("Location.host")}}
+
URL のホスト (すなわち hostname、コロン (':')、port) を収めた {{domxref("USVString")}} です。
+
{{domxref("Location.hostname")}}
+
URL のドメインを収めた {{domxref("USVString")}} です。
+
{{domxref("Location.port")}}
+
URL のポート番号を収めた {{domxref("USVString")}} です。
+
{{domxref("Location.pathname")}}
+
URL のパス部分を、先頭の '/' を含めて収めた {{domxref("USVString")}} です。
+
{{domxref("Location.search")}}
+
URL のうち、'?' とそれに続くパラメーターや "クエリー文字列" を収めた {{domxref("USVString")}} です。現代のブラウザーは、クエリー文字列からパラメーターを容易に解析するための URLSearchParams や URL.searchParams を提供しています。
+
{{domxref("Location.hash")}}
+
URL のうち、'#' とそれに続くフラグメント識別子を収めた {{domxref("USVString")}} です。
+
{{domxref("Location.username")}}
+
ドメイン名の前に指定されたユーザー名を収めた {{domxref("USVString")}} です。
+
{{domxref("Location.password")}}
+
ドメイン名の前に指定されたパスワードを収めた {{domxref("USVString")}} です。
+
{{domxref("Location.origin")}} {{readOnlyInline}}
+
特定の location のオリジンの標準形を収めた {{domxref("USVString")}} です。
+
+ +

メソッド

+ +
+
{{domxref("Location.assign()")}}
+
引数で指定した URL のリソースを読み込みます。
+
{{domxref("Location.reload()")}}
+
現在の URL のリソースを再読み込みします。省略可能な唯一の引数は {{domxref("Boolean")}} 値で、true であれば常にサーバーからページを再読み込みします。false を指定するか値を指定しない場合は、ブラウザーがキャッシュからページを再読み込みする可能性があります。
+
{{domxref("Location.replace()")}}
+
現在のリソースを、指定した URL のリソースで置き換えます。assign() メソッドとの違いは、replace() を使用した後は現在のページがセッションの {{domxref("History")}} に保存されないことであり、ユーザーは 戻る ボタンを使用して移動することができません。
+
{{domxref("Location.toString()")}}
+
URL 全体を収めた {{domxref("USVString")}} を返します。これは {{domxref("HTMLHyperlinkElementUtils.href")}} と同義ですが、こちらは値を変更するために使用できません。
+
+ +

例

+ +
// この例のためにアンカー要素を生成して、href プロパティを使用します。
+// より適切な代替手段は、URL を見て document.location または window.location を使用することです。
+var url = document.createElement('a');
+url.href = 'https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container';
+console.log(url.href);      // https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container
+console.log(url.protocol);  // https:
+console.log(url.host);      // developer.mozilla.org:8080
+console.log(url.hostname);  // developer.mozilla.org
+console.log(url.port);      // 8080
+console.log(url.pathname);  // /en-US/search
+console.log(url.search);    // ?q=URL
+console.log(url.hash);      // #search-results-close-container
+console.log(url.origin);    // https://developer.mozilla.org:8080
+
+ +

仕様書

+ + + + + + + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('HTML WHATWG', "browsers.html#the-location-interface", "Location")}}{{Spec2('HTML WHATWG')}}{{SpecName("HTML5 W3C")}} から変更なし。
{{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Location")}}{{Spec2('HTML5 W3C')}}初回定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.Location")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/location/reload/index.html b/files/ja/web/api/location/reload/index.html new file mode 100644 index 0000000000..8d4f1b3973 --- /dev/null +++ b/files/ja/web/api/location/reload/index.html @@ -0,0 +1,59 @@ +--- +title: Location.reload() +slug: Web/API/Location/reload +tags: + - API + - HTML DOM + - Location + - Method + - Reference + - メソッド +translation_of: Web/API/Location/reload +--- +
{{ APIRef("HTML DOM") }}
+ +

Location.reload() メソッドは、再読み込みボタンのように現在の URL を再読み込みします。

+ +

再読み込みがブロックされ、 SECURITY_ERROR {{domxref("DOMException")}} が発生する可能性があります。これは、Location.reload() を呼び出すスクリプトの{{Glossary("origin", "オリジン")}}が、 {{domxref("Location")}} オブジェクトを保持するページのオリジンと異なる場合に発生します。詳細については、同一オリジンポリシーを参照してください。

+ +

構文

+ +
location.reload();
+
+ +

仕様書

+ + + + + + + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('HTML WHATWG', "history.html#dom-location-reload", "Location.reload()")}}{{Spec2('HTML WHATWG')}}{{SpecName("HTML5 W3C")}} からの変更はありません。
{{SpecName('HTML5 W3C', "browsers.html#dom-location-reload", "Location.reload()")}}{{Spec2('HTML5 W3C')}}初回定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.Location.reload")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf