Safari Developer Library

Developer

DOMWindow Additions Reference

Options
Deployment Target:

On This Page

DOMWindow

DOMWindow additions allow conversion of points between page- and node-coordinate systems for transitions, support for CSS media queries, and device orientation and motion events.

  • Converts a point from page coordinates to node coordinates.

    Declaration

    WebKitPointwebkitConvertPointFromPageToNode(in Nodenode, in WebKitPointp);

    Parameters

    node

    The coordinate space to convert the given point to.

    p

    A point in page coordinates to convert to node coordinates.

    Return Value

    A point that is at the same location as p but in node coordinates.

  • Converts a point from node coordinates of a block element to page coordinates.

    Declaration

    WebKitPointwebkitConvertPointFromNodeToPage(in Nodenode, in WebKitPointp);

    Parameters

    node

    The coordinate space for p.

    p

    A point in node coordinates to convert to page coordinates.

    Return Value

    A point that is at the same location as p but in page coordinates.

  • orientation Property

    Specifies the orientation of the device.

    Declaration

    readonly attribute long orientation

    Discussion

    This property is set to one of the values in Table 1. For example, if the user starts with the device in portrait orientation and then changes to landscape orientation by turning the device to the right, the window’s orientation property is set to -90. If the user instead changes to landscape by turning the device to the left, the window’s orientation property is set to 90. The default value is 0.

    Table 1Window orientation values

    Value

    Description

    0

    Portrait orientation. This is the default value.

    -90

    Landscape orientation with the screen turned clockwise.

    90

    Landscape orientation with the screen turned counterclockwise.

    180

    Portrait orientation with the screen turned upside down. This value is currently not supported on iPhone.

  • The event listener that is called when the device motion changes.

    Declaration

    attribute EventListener ondevicemotion

    Discussion

    Read DeviceMotionEvent Class Reference for details.

  • The event listener that is called while the device orientation changes around the x, y, and z axes.

    Declaration

    attribute EventListener ondeviceorientation

    Discussion

    Read DeviceOrientationEvent Class Reference for details.