|
|
|
WebKitGTK+ Reference Manual | |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
WebKitViewportAttributesWebKitViewportAttributes — Represents the viewport properties of a web page |
WebKitViewportAttributes;
void webkit_viewport_attributes_recompute
(WebKitViewportAttributes *viewportAttributes);
"available-height" gint : Read / Write "available-width" gint : Read / Write "desktop-width" gint : Read / Write "device-dpi" gint : Read / Write "device-height" gint : Read / Write "device-pixel-ratio" gfloat : Read "device-width" gint : Read / Write "height" gint : Read "initial-scale-factor" gfloat : Read "maximum-scale-factor" gfloat : Read "minimum-scale-factor" gfloat : Read "user-scalable" gboolean : Read "valid" gboolean : Read "width" gint : Read
WebKitViewportAttributes offers the viewport properties to user agents to control the viewport layout. It contains the viewport size, initial scale with limits, and information about whether a user is able to scale the contents in the viewport. This makes a web page fit the device screen.
The "viewport-attributes-changed" signal will be emitted with WebKitViewportAttributes when the viewport attributes are updated in the case of loading web pages contain the viewport properties and calling webkit_viewport_attributes_recompute.
If the device size, available size, desktop width, or device DPI needs to be changed due to a consequence of an explicit browser request (caused by screen rotation, resizing, or similar reasons), You should call webkit_viewport_attributes_recompute to recompute the viewport properties and override those values in the handler of "viewport-attributes-recompute-requested" signal.
For more information on the viewport properties, refer to the Safari reference library at http://developer.apple.com/safari/library/documentation/appleapplications/reference/safarihtmlref/articles/metatags.html
/* Connect to the viewport-attributes-changes signal */
WebKitViewportAttributes* attributes = webkit_web_view_get_viewport_attributes (web_view);
g_signal_connect (web_view, "viewport-attributes-recompute-requested", G_CALLBACK (viewport_recompute_cb), window);
g_signal_connect (web_view, "viewport-attributes-changed", G_CALLBACK (viewport_changed_cb), window);
g_signal_connect (attributes, "notify::valid", G_CALLBACK (viewport_valid_changed_cb), web_view);
/* Handle the viewport-attributes-recompute-requested signal to override the device width */
static void
viewport_recompute_cb (WebKitWebView* web_view, WebKitViewportAttributes* attributes, GtkWidget* window)
{
int override_available_width = 480;
g_object_set (G_OBJECT(attributes), "available-width", override_available_width, NULL);
}
/* Handle the viewport-attributes-changed signal to recompute the initial scale factor */
static void
viewport_changed_cb (WebKitWebView* web_view, WebKitViewportAttributes* attributes, gpointer data)
{
gfloat initialScale;
g_object_get (G_OBJECT (atributes), "initial-scale-factor", &initialScale, NULL);
webkit_web_view_set_zoom_level (web_view, initialScale);
}
/* Handle the notify::valid signal to initialize the zoom level */
static void
viewport_valid_changed_cb (WebKitViewportAttributes* attributes, GParamSpec* pspec, WebKitWebView* web_view)
{
gboolean is_valid;
g_object_get (attributes, "valid", &is_valid, NULL);
if (!is_valid)
webkit_web_view_set_zoom_level (web_view, 1.0);
}
void webkit_viewport_attributes_recompute
(WebKitViewportAttributes *viewportAttributes);
Recompute the optimal viewport attributes and emit the viewport-attribute-changed signal. The viewport-attributes-recompute-requested signal also will be handled to override the device size, available size, desktop width, or device DPI.
|
a WebKitViewportAttributes |
Since 1.3.8
"available-height" property"available-height" gint : Read / Write
The height of the visible area.
Allowed values: >= 0
Default value: 0
"available-width" property"available-width" gint : Read / Write
The width of the visible area.
Allowed values: >= 0
Default value: 0
"desktop-width" property"desktop-width" gint : Read / Write
The width of viewport that works well for most web pages designed for desktop.
Allowed values: >= 0
Default value: 980
"device-dpi" property"device-dpi" gint : Read / Write
The number of dots per inch of the screen.
Allowed values: >= 0
Default value: 160
"device-height" property"device-height" gint : Read / Write
The height of the screen.
Allowed values: >= 0
Default value: 0
"device-pixel-ratio" property"device-pixel-ratio" gfloat : Read
The device pixel ratio of the viewport.
Allowed values: >= -1
Default value: -1
"device-width" property"device-width" gint : Read / Write
The width of the screen.
Allowed values: >= 0
Default value: 0
"height" property"height" gint : Read
The height of the viewport.
Allowed values: >= 0
Default value: 0
"initial-scale-factor" property"initial-scale-factor" gfloat : Read
The initial scale of the viewport.
Allowed values: >= -1
Default value: -1
"maximum-scale-factor" property"maximum-scale-factor" gfloat : Read
The maximum scale of the viewport.
Allowed values: >= -1
Default value: -1
"minimum-scale-factor" property"minimum-scale-factor" gfloat : Read
The minimum scale of the viewport.
Allowed values: >= -1
Default value: -1
"user-scalable" property"user-scalable" gboolean : Read
Determines whether or not the user can zoom in and out.
Default value: TRUE
"valid" property"valid" gboolean : Read
Determines whether or not the attributes are valid, and can be used.
Default value: FALSE
"width" property"width" gint : Read
The width of the viewport.
Allowed values: >= 0
Default value: 0