 | JavaScript | |||
|---|---|---|---|---|
| Prev | Home | Up | Next |
| Availability: |
| |||||||
| Inherits from: | Url object | |||||||
| JavaScript syntax: | - | myLocation = myWindow.location | ||||||
| Object properties: | hash, host, hostname, href, pathname, port, protocol, search, target, text, x, y | |||||||
| Object methods: | assign(), reload(), replace() | |||||||
| Event handlers: | onClick, onDblClick, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp | |||||||
This is a more or less portable encapsulation of a URL value and is most commonly used to describe the location of a document in a window. Changing its href property value has become the preferred means of loading a new document into a window or frame.
This is useful because it can also operate very conveniently across frame boundaries. That is, a script in one frame can modify the contents of another.
There are some security implications when accessing frames from different servers or domains. These can overcome in Netscape by using signed scripts.
| Property | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| hash | 1.0  | 1.0 | 2.0 | 3.02 | 3.0 |  | | 1 | | | - |
| host | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| hostname | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| href | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| pathname | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| port | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| protocol | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | ReadOnly. |
| search | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| target | 1.0 | 1.0 | 2.0 | 3.02 | | | | | | | - |
| text | 1.2 | | 4.0 | | | | | | | | - |
| x | 1.2 | | 4.0 | | | | | | | | - |
| y | 1.2 | | 4.0 | | | | | | | | - |
| Method | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| assign() | 1.0 | 1.0 | 2.0 | 3.02 | | | | | | | 
, Deprecated |
| reload() | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | 1 | | | - |
| replace() | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | 1 | | | - |
| Event name | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| onClick | 1.0 | 1.0 | 2.0 | 3.0 | 3.0 | | | | | 4.0 | |
| onDblClick | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onHelp | | 3.0 | | 4.0 | | | | | | | |
| onKeyDown | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onKeyPress | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onKeyUp | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onMouseDown | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onMouseMove | 1.2 | 3.0 | 4.0 | 4.0 | | | | | | 4.0 | |
| onMouseOut | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onMouseOver | 1.0 | 1.0 | 2.0 | 3.0 | 3.0 | | | | | 4.0 | |
| onMouseUp | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| Prev | Home | Next |
| location | Up | Location.assign() |
JavaScript Programmer's Reference, Cliff Wootton Wrox Press (www.wrox.com) Join the Wrox JavaScript forum at p2p.wrox.com Please report problems to support@wrox.com © 2001 Wrox Press. All Rights Reserved. Terms and conditions. | ||