Location.href - 完全なURLを取得、変更する
投稿日: / 更新日:
JavaScriptの、Locationオブジェクトのhref
は、URLを取得、変更するプロパティです。
説明
Locationオブジェクトのhrefプロパティは、ドキュメントの完全なURLを含みます。
https://syncer.jp:443/index.html#section-1
Locationオブジェクトの特徴として、Locationオブジェクトそのものを文字列で扱う時、その内容はhrefプロパティと同じ値になります。要は、下記は同じ結果になるということです。
// ドキュメントのURLを取得
var url = window.location ;
var url = window.location.href ;
また、hrefプロパティに新しく値を設定することで現在のURLを変更、すなわち、ページ移動させることができます。指定する値は、絶対パス、相対パス、サーバー相対パスなど、a要素のhref属性に指定できるものならなんでも大丈夫です。
サンプルコード
https://syncer.jp:443/index.html#section-1
// URLを取得 ( → "https://syncer.jp:443/index.html#section-1" )
var href = window.location.href ;
// URLを変更
window.location.href = "./new-page.html" ;
デモ
下記はsyncer-editor.com
上のページです。window.location.href
を取得して表示します。URLの変更はボタンを押してから3秒後に実行します。
構文
string href = Location.href
Location.href = string newHref
返り値
項目 | 説明 |
---|---|
href | 現在のURL。 |
指定する値
項目 | 説明 |
---|---|
newHref | 新しく設定したいURL。設定するとこのURLに移動する。 |
関連項目
- Location - ブラウザロケーションのオブジェクト。
- Location.hash - フラグメント識別子(#〜)を取得、変更する。
- Location.host - ホスト名とポートを取得、変更する。
- Location.hostname - ホスト名を取得、変更する。
- Location.href - 完全なURLを取得、変更する。
- Location.pathname - パスを取得、変更する。
- Location.port - ポート番号を取得、変更する。
- Location.protocol - プロトコルを取得、変更する。
- Location.search - クエリを取得、変更する。
外部リンク
- HTML Living Standard - WHATWGによる仕様書。