/* * Copyright (C) 2008 Christian Dywan * Copyright (C) 2008 Nuanti Ltd. * Copyright (C) 2008 Collabora Ltd. * Copyright (C) 2008 Holger Hans Peter Freyther * Copyright (C) 2009 Jan Michael Alonzo * Copyright (C) 2009 Movial Creative Technologies Inc. * Copyright (C) 2009 Igalia S.L. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public License * along with this library; see the file COPYING.LIB. If not, write to * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301, USA. */ #include "config.h" #include "webkitwebsettings.h" #include "EditingBehavior.h" #include "FileSystem.h" #include "PluginDatabase.h" #include "webkitenumtypes.h" #include "webkitglobalsprivate.h" #include "webkitversion.h" #include "webkitwebsettingsprivate.h" #include #include #include #if OS(UNIX) #include #elif OS(WINDOWS) #include "SystemInfo.h" #endif /** * SECTION:webkitwebsettings * @short_description: Control the behaviour of a #WebKitWebView * * #WebKitWebSettings can be applied to a #WebKitWebView to control text encoding, * color, font sizes, printing mode, script support, loading of images and various other things. * After creation, a #WebKitWebSettings object contains default settings. * * * /* Create a new websettings and disable java script */ * WebKitWebSettings *settings = webkit_web_settings_new (); * g_object_set (G_OBJECT(settings), "enable-scripts", FALSE, NULL); * * /* Apply the result */ * webkit_web_view_set_settings (WEBKIT_WEB_VIEW(my_webview), settings); * */ using namespace WebCore; G_DEFINE_TYPE(WebKitWebSettings, webkit_web_settings, G_TYPE_OBJECT) struct _WebKitWebSettingsPrivate { gchar* default_encoding; gchar* cursive_font_family; gchar* default_font_family; gchar* fantasy_font_family; gchar* monospace_font_family; gchar* sans_serif_font_family; gchar* serif_font_family; guint default_font_size; guint default_monospace_font_size; guint minimum_font_size; guint minimum_logical_font_size; gboolean enforce_96_dpi; gboolean auto_load_images; gboolean auto_shrink_images; gboolean print_backgrounds; gboolean enable_scripts; gboolean enable_plugins; gboolean resizable_text_areas; gchar* user_stylesheet_uri; gfloat zoom_step; gboolean enable_developer_extras; gboolean enable_private_browsing; gboolean enable_spell_checking; gchar* spell_checking_languages; gboolean enable_caret_browsing; gboolean enable_html5_database; gboolean enable_html5_local_storage; gboolean enable_xss_auditor; gboolean enable_spatial_navigation; gboolean enable_frame_flattening; gchar* user_agent; gboolean javascript_can_open_windows_automatically; gboolean javascript_can_access_clipboard; gboolean enable_offline_web_application_cache; WebKitEditingBehavior editing_behavior; gboolean enable_universal_access_from_file_uris; gboolean enable_file_access_from_file_uris; gboolean enable_dom_paste; gboolean tab_key_cycles_through_elements; gboolean enable_default_context_menu; gboolean enable_site_specific_quirks; gboolean enable_page_cache; gboolean auto_resize_window; gboolean enable_java_applet; gboolean enable_hyperlink_auditing; gboolean enable_fullscreen; gboolean enable_dns_prefetching; }; #define WEBKIT_WEB_SETTINGS_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE((obj), WEBKIT_TYPE_WEB_SETTINGS, WebKitWebSettingsPrivate)) enum { PROP_0, PROP_DEFAULT_ENCODING, PROP_CURSIVE_FONT_FAMILY, PROP_DEFAULT_FONT_FAMILY, PROP_FANTASY_FONT_FAMILY, PROP_MONOSPACE_FONT_FAMILY, PROP_SANS_SERIF_FONT_FAMILY, PROP_SERIF_FONT_FAMILY, PROP_DEFAULT_FONT_SIZE, PROP_DEFAULT_MONOSPACE_FONT_SIZE, PROP_MINIMUM_FONT_SIZE, PROP_MINIMUM_LOGICAL_FONT_SIZE, PROP_ENFORCE_96_DPI, PROP_AUTO_LOAD_IMAGES, PROP_AUTO_SHRINK_IMAGES, PROP_PRINT_BACKGROUNDS, PROP_ENABLE_SCRIPTS, PROP_ENABLE_PLUGINS, PROP_RESIZABLE_TEXT_AREAS, PROP_USER_STYLESHEET_URI, PROP_ZOOM_STEP, PROP_ENABLE_DEVELOPER_EXTRAS, PROP_ENABLE_PRIVATE_BROWSING, PROP_ENABLE_SPELL_CHECKING, PROP_SPELL_CHECKING_LANGUAGES, PROP_ENABLE_CARET_BROWSING, PROP_ENABLE_HTML5_DATABASE, PROP_ENABLE_HTML5_LOCAL_STORAGE, PROP_ENABLE_XSS_AUDITOR, PROP_ENABLE_SPATIAL_NAVIGATION, PROP_ENABLE_FRAME_FLATTENING, PROP_USER_AGENT, PROP_JAVASCRIPT_CAN_OPEN_WINDOWS_AUTOMATICALLY, PROP_JAVASCRIPT_CAN_ACCESS_CLIPBOARD, PROP_ENABLE_OFFLINE_WEB_APPLICATION_CACHE, PROP_EDITING_BEHAVIOR, PROP_ENABLE_UNIVERSAL_ACCESS_FROM_FILE_URIS, PROP_ENABLE_FILE_ACCESS_FROM_FILE_URIS, PROP_ENABLE_DOM_PASTE, PROP_TAB_KEY_CYCLES_THROUGH_ELEMENTS, PROP_ENABLE_DEFAULT_CONTEXT_MENU, PROP_ENABLE_SITE_SPECIFIC_QUIRKS, PROP_ENABLE_PAGE_CACHE, PROP_AUTO_RESIZE_WINDOW, PROP_ENABLE_JAVA_APPLET, PROP_ENABLE_HYPERLINK_AUDITING, PROP_ENABLE_FULLSCREEN, PROP_ENABLE_DNS_PREFETCHING }; // Create a default user agent string // This is a liberal interpretation of http://www.mozilla.org/build/revised-user-agent-strings.html // See also http://developer.apple.com/internet/safari/faq.html#anchor2 static String webkitPlatform() { #if PLATFORM(X11) DEFINE_STATIC_LOCAL(const String, uaPlatform, (String("X11; "))); #elif OS(WINDOWS) DEFINE_STATIC_LOCAL(const String, uaPlatform, (String(""))); #elif PLATFORM(MAC) DEFINE_STATIC_LOCAL(const String, uaPlatform, (String("Macintosh; "))); #elif defined(GDK_WINDOWING_DIRECTFB) DEFINE_STATIC_LOCAL(const String, uaPlatform, (String("DirectFB; "))); #else DEFINE_STATIC_LOCAL(const String, uaPlatform, (String("Unknown; "))); #endif return uaPlatform; } static String webkitOSVersion() { // FIXME: platform/version detection can be shared. #if OS(DARWIN) #if CPU(X86) DEFINE_STATIC_LOCAL(const String, uaOSVersion, (String("Intel Mac OS X"))); #else DEFINE_STATIC_LOCAL(const String, uaOSVersion, (String("PPC Mac OS X"))); #endif #elif OS(UNIX) DEFINE_STATIC_LOCAL(String, uaOSVersion, (String())); if (!uaOSVersion.isEmpty()) return uaOSVersion; struct utsname name; if (uname(&name) != -1) uaOSVersion = makeString(name.sysname, ' ', name.machine); else uaOSVersion = String("Unknown"); #elif OS(WINDOWS) DEFINE_STATIC_LOCAL(const String, uaOSVersion, (windowsVersionForUAString())); #else DEFINE_STATIC_LOCAL(const String, uaOSVersion, (String("Unknown"))); #endif return uaOSVersion; } String webkitUserAgent() { // We mention Safari since many broken sites check for it (OmniWeb does this too) // We re-use the WebKit version, though it doesn't seem to matter much in practice DEFINE_STATIC_LOCAL(const String, uaVersion, (makeString(String::number(WEBKIT_USER_AGENT_MAJOR_VERSION), '.', String::number(WEBKIT_USER_AGENT_MINOR_VERSION), '+'))); DEFINE_STATIC_LOCAL(const String, staticUA, (makeString("Mozilla/5.0 (", webkitPlatform(), webkitOSVersion(), ") AppleWebKit/", uaVersion) + makeString(" (KHTML, like Gecko) Version/5.0 Safari/", uaVersion))); return staticUA; } static void webkit_web_settings_finalize(GObject* object); static void webkit_web_settings_set_property(GObject* object, guint prop_id, const GValue* value, GParamSpec* pspec); static void webkit_web_settings_get_property(GObject* object, guint prop_id, GValue* value, GParamSpec* pspec); static void webkit_web_settings_class_init(WebKitWebSettingsClass* klass) { GObjectClass* gobject_class = G_OBJECT_CLASS(klass); gobject_class->finalize = webkit_web_settings_finalize; gobject_class->set_property = webkit_web_settings_set_property; gobject_class->get_property = webkit_web_settings_get_property; webkitInit(); GParamFlags flags = (GParamFlags)(WEBKIT_PARAM_READWRITE | G_PARAM_CONSTRUCT); g_object_class_install_property(gobject_class, PROP_DEFAULT_ENCODING, g_param_spec_string( "default-encoding", _("Default Encoding"), _("The default encoding used to display text."), "iso-8859-1", flags)); g_object_class_install_property(gobject_class, PROP_CURSIVE_FONT_FAMILY, g_param_spec_string( "cursive-font-family", _("Cursive Font Family"), _("The default Cursive font family used to display text."), "serif", flags)); g_object_class_install_property(gobject_class, PROP_DEFAULT_FONT_FAMILY, g_param_spec_string( "default-font-family", _("Default Font Family"), _("The default font family used to display text."), "sans-serif", flags)); g_object_class_install_property(gobject_class, PROP_FANTASY_FONT_FAMILY, g_param_spec_string( "fantasy-font-family", _("Fantasy Font Family"), _("The default Fantasy font family used to display text."), "serif", flags)); g_object_class_install_property(gobject_class, PROP_MONOSPACE_FONT_FAMILY, g_param_spec_string( "monospace-font-family", _("Monospace Font Family"), _("The default font family used to display monospace text."), "monospace", flags)); g_object_class_install_property(gobject_class, PROP_SANS_SERIF_FONT_FAMILY, g_param_spec_string( "sans-serif-font-family", _("Sans Serif Font Family"), _("The default Sans Serif font family used to display text."), "sans-serif", flags)); g_object_class_install_property(gobject_class, PROP_SERIF_FONT_FAMILY, g_param_spec_string( "serif-font-family", _("Serif Font Family"), _("The default Serif font family used to display text."), "serif", flags)); g_object_class_install_property(gobject_class, PROP_DEFAULT_FONT_SIZE, g_param_spec_int( "default-font-size", _("Default Font Size"), _("The default font size used to display text."), 5, G_MAXINT, 12, flags)); g_object_class_install_property(gobject_class, PROP_DEFAULT_MONOSPACE_FONT_SIZE, g_param_spec_int( "default-monospace-font-size", _("Default Monospace Font Size"), _("The default font size used to display monospace text."), 5, G_MAXINT, 10, flags)); g_object_class_install_property(gobject_class, PROP_MINIMUM_FONT_SIZE, g_param_spec_int( "minimum-font-size", _("Minimum Font Size"), _("The minimum font size used to display text."), 0, G_MAXINT, 5, flags)); g_object_class_install_property(gobject_class, PROP_MINIMUM_LOGICAL_FONT_SIZE, g_param_spec_int( "minimum-logical-font-size", _("Minimum Logical Font Size"), _("The minimum logical font size used to display text."), 1, G_MAXINT, 5, flags)); /** * WebKitWebSettings:enforce-96-dpi: * * Enforce a resolution of 96 DPI. This is meant for compatibility * with web pages which cope badly with different screen resolutions * and for automated testing. * Web browsers and applications that typically display arbitrary * content from the web should provide a preference for this. * * Since: 1.0.3 */ g_object_class_install_property(gobject_class, PROP_ENFORCE_96_DPI, g_param_spec_boolean( "enforce-96-dpi", _("Enforce 96 DPI"), _("Enforce a resolution of 96 DPI"), FALSE, flags)); g_object_class_install_property(gobject_class, PROP_AUTO_LOAD_IMAGES, g_param_spec_boolean( "auto-load-images", _("Auto Load Images"), _("Load images automatically."), TRUE, flags)); g_object_class_install_property(gobject_class, PROP_AUTO_SHRINK_IMAGES, g_param_spec_boolean( "auto-shrink-images", _("Auto Shrink Images"), _("Automatically shrink standalone images to fit."), TRUE, flags)); g_object_class_install_property(gobject_class, PROP_PRINT_BACKGROUNDS, g_param_spec_boolean( "print-backgrounds", _("Print Backgrounds"), _("Whether background images should be printed."), TRUE, flags)); g_object_class_install_property(gobject_class, PROP_ENABLE_SCRIPTS, g_param_spec_boolean( "enable-scripts", _("Enable Scripts"), _("Enable embedded scripting languages."), TRUE, flags)); g_object_class_install_property(gobject_class, PROP_ENABLE_PLUGINS, g_param_spec_boolean( "enable-plugins", _("Enable Plugins"), _("Enable embedded plugin objects."), TRUE, flags)); g_object_class_install_property(gobject_class, PROP_RESIZABLE_TEXT_AREAS, g_param_spec_boolean( "resizable-text-areas", _("Resizable Text Areas"), _("Whether text areas are resizable."), TRUE, flags)); g_object_class_install_property(gobject_class, PROP_USER_STYLESHEET_URI, g_param_spec_string("user-stylesheet-uri", _("User Stylesheet URI"), _("The URI of a stylesheet that is applied to every page."), 0, flags)); /** * WebKitWebSettings:zoom-step: * * The value by which the zoom level is changed when zooming in or out. * * Since: 1.0.1 */ g_object_class_install_property(gobject_class, PROP_ZOOM_STEP, g_param_spec_float( "zoom-step", _("Zoom Stepping Value"), _("The value by which the zoom level is changed when zooming in or out."), 0.0f, G_MAXFLOAT, 0.1f, flags)); /** * WebKitWebSettings:enable-developer-extras: * * Whether developer extensions should be enabled. This enables, * for now, the Web Inspector, which can be controlled using the * #WebKitWebInspector instance held by the #WebKitWebView this * setting is enabled for. * * Since: 1.0.3 */ g_object_class_install_property(gobject_class, PROP_ENABLE_DEVELOPER_EXTRAS, g_param_spec_boolean( "enable-developer-extras", _("Enable Developer Extras"), _("Enables special extensions that help developers"), FALSE, flags)); /** * WebKitWebSettings:enable-private-browsing: * * Whether to enable private browsing mode. Private browsing mode prevents * WebKit from updating the global history and storing any session * information e.g., on-disk cache, as well as suppressing any messages * from being printed into the (javascript) console. * * This is currently experimental for WebKitGtk. * * Since: 1.1.2 */ g_object_class_install_property(gobject_class, PROP_ENABLE_PRIVATE_BROWSING, g_param_spec_boolean( "enable-private-browsing", _("Enable Private Browsing"), _("Enables private browsing mode"), FALSE, flags)); /** * WebKitWebSettings:enable-spell-checking: * * Whether to enable spell checking while typing. * * Since: 1.1.6 */ g_object_class_install_property(gobject_class, PROP_ENABLE_SPELL_CHECKING, g_param_spec_boolean( "enable-spell-checking", _("Enable Spell Checking"), _("Enables spell checking while typing"), FALSE, flags)); /** * WebKitWebSettings:spell-checking-languages: * * The languages to be used for spell checking, separated by commas. * * The locale string typically is in the form lang_COUNTRY, where lang * is an ISO-639 language code, and COUNTRY is an ISO-3166 country code. * For instance, sv_FI for Swedish as written in Finland or pt_BR * for Portuguese as written in Brazil. * * If no value is specified then the value returned by * gtk_get_default_language will be used. * * Since: 1.1.6 */ g_object_class_install_property(gobject_class, PROP_SPELL_CHECKING_LANGUAGES, g_param_spec_string( "spell-checking-languages", _("Languages to use for spell checking"), _("Comma separated list of languages to use for spell checking"), 0, flags)); /** * WebKitWebSettings:enable-caret-browsing: * * Whether to enable caret browsing mode. * * Since: 1.1.6 */ g_object_class_install_property(gobject_class, PROP_ENABLE_CARET_BROWSING, g_param_spec_boolean("enable-caret-browsing", _("Enable Caret Browsing"), _("Whether to enable accessibility enhanced keyboard navigation"), FALSE, flags)); /** * WebKitWebSettings:enable-html5-database: * * Whether to enable HTML5 client-side SQL database support. Client-side * SQL database allows web pages to store structured data and be able to * use SQL to manipulate that data asynchronously. * * Since: 1.1.8 */ g_object_class_install_property(gobject_class, PROP_ENABLE_HTML5_DATABASE, g_param_spec_boolean("enable-html5-database", _("Enable HTML5 Database"), _("Whether to enable HTML5 database support"), TRUE, flags)); /** * WebKitWebSettings:enable-html5-local-storage: * * Whether to enable HTML5 localStorage support. localStorage provides * simple synchronous storage access. * * Since: 1.1.8 */ g_object_class_install_property(gobject_class, PROP_ENABLE_HTML5_LOCAL_STORAGE, g_param_spec_boolean("enable-html5-local-storage", _("Enable HTML5 Local Storage"), _("Whether to enable HTML5 Local Storage support"), TRUE, flags)); /** * WebKitWebSettings:enable-xss-auditor * * Whether to enable the XSS Auditor. This feature filters some kinds of * reflective XSS attacks on vulnerable web sites. * * Since: 1.1.11 */ g_object_class_install_property(gobject_class, PROP_ENABLE_XSS_AUDITOR, g_param_spec_boolean("enable-xss-auditor", _("Enable XSS Auditor"), _("Whether to enable the XSS auditor"), TRUE, flags)); /** * WebKitWebSettings:enable-spatial-navigation * * Whether to enable the Spatial Navigation. This feature consists in the ability * to navigate between focusable elements in a Web page, such as hyperlinks and * form controls, by using Left, Right, Up and Down arrow keys. For example, if * an user presses the Right key, heuristics determine whether there is an element * he might be trying to reach towards the right, and if there are multiple elements, * which element he probably wants. * * Since: 1.1.23 */ g_object_class_install_property(gobject_class, PROP_ENABLE_SPATIAL_NAVIGATION, g_param_spec_boolean("enable-spatial-navigation", _("Enable Spatial Navigation"), _("Whether to enable Spatial Navigation"), FALSE, flags)); /** * WebKitWebSettings:enable-frame-flattening * * Whether to enable the Frame Flattening. With this setting each subframe is expanded * to its contents, which will flatten all the frames to become one scrollable page. * On touch devices, it is desired to not have any scrollable sub parts of the page as * it results in a confusing user experience, with scrolling sometimes scrolling sub parts * and at other times scrolling the page itself. For this reason iframes and framesets are * barely usable on touch devices. * * Since: 1.3.5 */ g_object_class_install_property(gobject_class, PROP_ENABLE_FRAME_FLATTENING, g_param_spec_boolean("enable-frame-flattening", _("Enable Frame Flattening"), _("Whether to enable Frame Flattening"), FALSE, flags)); /** * WebKitWebSettings:user-agent: * * The User-Agent string used by WebKitGtk. * * This will return a default User-Agent string if a custom string wasn't * provided by the application. Setting this property to a NULL value or * an empty string will result in the User-Agent string being reset to the * default value. * * Since: 1.1.11 */ g_object_class_install_property(gobject_class, PROP_USER_AGENT, g_param_spec_string("user-agent", _("User Agent"), _("The User-Agent string used by WebKitGtk"), webkitUserAgent().utf8().data(), flags)); /** * WebKitWebSettings:javascript-can-open-windows-automatically * * Whether JavaScript can open popup windows automatically without user * intervention. * * Since: 1.1.11 */ g_object_class_install_property(gobject_class, PROP_JAVASCRIPT_CAN_OPEN_WINDOWS_AUTOMATICALLY, g_param_spec_boolean("javascript-can-open-windows-automatically", _("JavaScript can open windows automatically"), _("Whether JavaScript can open windows automatically"), FALSE, flags)); /** * WebKitWebSettings:javascript-can-access-clipboard * * Whether JavaScript can access Clipboard. * * Since: 1.3.0 */ g_object_class_install_property(gobject_class, PROP_JAVASCRIPT_CAN_ACCESS_CLIPBOARD, g_param_spec_boolean("javascript-can-access-clipboard", _("JavaScript can access Clipboard"), _("Whether JavaScript can access Clipboard"), FALSE, flags)); /** * WebKitWebSettings:enable-offline-web-application-cache * * Whether to enable HTML5 offline web application cache support. Offline * Web Application Cache ensures web applications are available even when * the user is not connected to the network. * * Since: 1.1.13 */ g_object_class_install_property(gobject_class, PROP_ENABLE_OFFLINE_WEB_APPLICATION_CACHE, g_param_spec_boolean("enable-offline-web-application-cache", _("Enable offline web application cache"), _("Whether to enable offline web application cache"), TRUE, flags)); /** * WebKitWebSettings:editing-behavior * * This setting controls various editing behaviors that differ * between platforms and that have been combined in two groups, * 'Mac' and 'Windows'. Some examples: * * 1) Clicking below the last line of an editable area puts the * caret at the end of the last line on Mac, but in the middle of * the last line on Windows. * * 2) Pushing down the arrow key on the last line puts the caret * at the end of the last line on Mac, but does nothing on * Windows. A similar case exists on the top line. * * Since: 1.1.13 */ g_object_class_install_property(gobject_class, PROP_EDITING_BEHAVIOR, g_param_spec_enum("editing-behavior", _("Editing behavior"), _("The behavior mode to use in editing mode"), WEBKIT_TYPE_EDITING_BEHAVIOR, WEBKIT_EDITING_BEHAVIOR_UNIX, flags)); /** * WebKitWebSettings:enable-universal-access-from-file-uris * * Whether to allow files loaded through file:// URIs universal access to * all pages. * * Since: 1.1.13 */ g_object_class_install_property(gobject_class, PROP_ENABLE_UNIVERSAL_ACCESS_FROM_FILE_URIS, g_param_spec_boolean("enable-universal-access-from-file-uris", _("Enable universal access from file URIs"), _("Whether to allow universal access from file URIs"), FALSE, flags)); /** * WebKitWebSettings:enable-dom-paste * * Whether to enable DOM paste. If set to %TRUE, document.execCommand("Paste") * will correctly execute and paste content of the clipboard. * * Since: 1.1.16 */ g_object_class_install_property(gobject_class, PROP_ENABLE_DOM_PASTE, g_param_spec_boolean("enable-dom-paste", _("Enable DOM paste"), _("Whether to enable DOM paste"), FALSE, flags)); /** * WebKitWebSettings:tab-key-cycles-through-elements: * * Whether the tab key cycles through elements on the page. * * If @flag is %TRUE, pressing the tab key will focus the next element in * the @web_view. If @flag is %FALSE, the @web_view will interpret tab * key presses as normal key presses. If the selected element is editable, the * tab key will cause the insertion of a tab character. * * Since: 1.1.17 */ g_object_class_install_property(gobject_class, PROP_TAB_KEY_CYCLES_THROUGH_ELEMENTS, g_param_spec_boolean("tab-key-cycles-through-elements", _("Tab key cycles through elements"), _("Whether the tab key cycles through elements on the page."), TRUE, flags)); /** * WebKitWebSettings:enable-default-context-menu: * * Whether right-clicks should be handled automatically to create, * and display the context menu. Turning this off will make * WebKitGTK+ not emit the populate-popup signal. Notice that the * default button press event handler may still handle right * clicks for other reasons, such as in-page context menus, or * right-clicks that are handled by the page itself. * * Since: 1.1.18 */ g_object_class_install_property(gobject_class, PROP_ENABLE_DEFAULT_CONTEXT_MENU, g_param_spec_boolean( "enable-default-context-menu", _("Enable Default Context Menu"), _("Enables the handling of right-clicks for the creation of the default context menu"), TRUE, flags)); /** * WebKitWebSettings::enable-site-specific-quirks * * Whether to turn on site-specific hacks. Turning this on will * tell WebKitGTK+ to use some site-specific workarounds for * better web compatibility. For example, older versions of * MediaWiki will incorrectly send WebKit a css file with KHTML * workarounds. By turning on site-specific quirks, WebKit will * special-case this and other cases to make the sites work. * * Since: 1.1.18 */ g_object_class_install_property(gobject_class, PROP_ENABLE_SITE_SPECIFIC_QUIRKS, g_param_spec_boolean( "enable-site-specific-quirks", _("Enable Site Specific Quirks"), _("Enables the site-specific compatibility workarounds"), FALSE, flags)); /** * WebKitWebSettings:enable-page-cache: * * Enable or disable the page cache. Disabling the page cache is * generally only useful for special circumstances like low-memory * scenarios or special purpose applications like static HTML * viewers. This setting only controls the Page Cache, this cache * is different than the disk-based or memory-based traditional * resource caches, its point is to make going back and forth * between pages much faster. For details about the different types * of caches and their purposes see: * http://webkit.org/blog/427/webkit-page-cache-i-the-basics/ * * Since: 1.1.18 */ g_object_class_install_property(gobject_class, PROP_ENABLE_PAGE_CACHE, g_param_spec_boolean("enable-page-cache", _("Enable page cache"), _("Whether the page cache should be used"), FALSE, flags)); /** * WebKitWebSettings:auto-resize-window: * * Web pages can request to modify the size and position of the * window containing the #WebKitWebView through various DOM methods * (resizeTo, moveTo, resizeBy, moveBy). By default WebKit will not * honor this requests, but you can set this property to %TRUE if * you'd like it to do so. If you wish to handle this manually, you * can connect to the notify signal for the * #WebKitWebWindowFeatures of your #WebKitWebView. * * Since: 1.1.22 */ g_object_class_install_property(gobject_class, PROP_AUTO_RESIZE_WINDOW, g_param_spec_boolean("auto-resize-window", _("Auto Resize Window"), _("Automatically resize the toplevel window when a page requests it"), FALSE, flags)); /** * WebKitWebSettings:enable-file-access-from-file-uris: * * Boolean property to control file access for file:// URIs. If this * option is enabled every file:// will have its own security unique domain. * * Since: 1.1.22 */ g_object_class_install_property(gobject_class, PROP_ENABLE_FILE_ACCESS_FROM_FILE_URIS, g_param_spec_boolean("enable-file-access-from-file-uris", "Enable file access from file URIs", "Controls file access for file:// URIs.", FALSE, flags)); /** * WebKitWebSettings:enable-java-applet: * * Enable or disable support for the Java <applet> tag. Keep in * mind that Java content can be still shown in the page through * <object> or <embed>, which are the preferred tags for this task. * * Since: 1.1.22 */ g_object_class_install_property(gobject_class, PROP_ENABLE_JAVA_APPLET, g_param_spec_boolean("enable-java-applet", _("Enable Java Applet"), _("Whether Java Applet support through should be enabled"), TRUE, flags)); /** * WebKitWebSettings:enable-hyperlink-auditing: * * Enable or disable support for . * * Since: 1.2.5 */ g_object_class_install_property(gobject_class, PROP_ENABLE_HYPERLINK_AUDITING, g_param_spec_boolean("enable-hyperlink-auditing", _("Enable Hyperlink Auditing"), _("Whether should be able to send pings"), FALSE, flags)); /* Undocumented for now */ g_object_class_install_property(gobject_class, PROP_ENABLE_FULLSCREEN, g_param_spec_boolean("enable-fullscreen", _("Enable Fullscreen"), _("Whether the Mozilla style API should be enabled."), FALSE, flags)); /** * WebKitWebSettings:enable-dns-prefetching * * Whether webkit prefetches domain names. This is a separate knob from private browsing. * Whether private browsing should set this or not is up for debate, for now it doesn't. * * Since: 1.3.13. */ g_object_class_install_property(gobject_class, PROP_ENABLE_DNS_PREFETCHING, g_param_spec_boolean("enable-dns-prefetching", _("WebKit prefetches domain names"), _("Whether WebKit prefetches domain names"), TRUE, flags)); g_type_class_add_private(klass, sizeof(WebKitWebSettingsPrivate)); } static void webkit_web_settings_init(WebKitWebSettings* web_settings) { web_settings->priv = G_TYPE_INSTANCE_GET_PRIVATE(web_settings, WEBKIT_TYPE_WEB_SETTINGS, WebKitWebSettingsPrivate); } static void webkit_web_settings_finalize(GObject* object) { WebKitWebSettings* web_settings = WEBKIT_WEB_SETTINGS(object); WebKitWebSettingsPrivate* priv = web_settings->priv; g_free(priv->default_encoding); g_free(priv->cursive_font_family); g_free(priv->default_font_family); g_free(priv->fantasy_font_family); g_free(priv->monospace_font_family); g_free(priv->sans_serif_font_family); g_free(priv->serif_font_family); g_free(priv->user_stylesheet_uri); g_free(priv->spell_checking_languages); g_free(priv->user_agent); G_OBJECT_CLASS(webkit_web_settings_parent_class)->finalize(object); } static void webkit_web_settings_set_property(GObject* object, guint prop_id, const GValue* value, GParamSpec* pspec) { WebKitWebSettings* web_settings = WEBKIT_WEB_SETTINGS(object); WebKitWebSettingsPrivate* priv = web_settings->priv; switch(prop_id) { case PROP_DEFAULT_ENCODING: g_free(priv->default_encoding); priv->default_encoding = g_strdup(g_value_get_string(value)); break; case PROP_CURSIVE_FONT_FAMILY: g_free(priv->cursive_font_family); priv->cursive_font_family = g_strdup(g_value_get_string(value)); break; case PROP_DEFAULT_FONT_FAMILY: g_free(priv->default_font_family); priv->default_font_family = g_strdup(g_value_get_string(value)); break; case PROP_FANTASY_FONT_FAMILY: g_free(priv->fantasy_font_family); priv->fantasy_font_family = g_strdup(g_value_get_string(value)); break; case PROP_MONOSPACE_FONT_FAMILY: g_free(priv->monospace_font_family); priv->monospace_font_family = g_strdup(g_value_get_string(value)); break; case PROP_SANS_SERIF_FONT_FAMILY: g_free(priv->sans_serif_font_family); priv->sans_serif_font_family = g_strdup(g_value_get_string(value)); break; case PROP_SERIF_FONT_FAMILY: g_free(priv->serif_font_family); priv->serif_font_family = g_strdup(g_value_get_string(value)); break; case PROP_DEFAULT_FONT_SIZE: priv->default_font_size = g_value_get_int(value); break; case PROP_DEFAULT_MONOSPACE_FONT_SIZE: priv->default_monospace_font_size = g_value_get_int(value); break; case PROP_MINIMUM_FONT_SIZE: priv->minimum_font_size = g_value_get_int(value); break; case PROP_MINIMUM_LOGICAL_FONT_SIZE: priv->minimum_logical_font_size = g_value_get_int(value); break; case PROP_ENFORCE_96_DPI: priv->enforce_96_dpi = g_value_get_boolean(value); break; case PROP_AUTO_LOAD_IMAGES: priv->auto_load_images = g_value_get_boolean(value); break; case PROP_AUTO_SHRINK_IMAGES: priv->auto_shrink_images = g_value_get_boolean(value); break; case PROP_PRINT_BACKGROUNDS: priv->print_backgrounds = g_value_get_boolean(value); break; case PROP_ENABLE_SCRIPTS: priv->enable_scripts = g_value_get_boolean(value); break; case PROP_ENABLE_PLUGINS: priv->enable_plugins = g_value_get_boolean(value); break; case PROP_RESIZABLE_TEXT_AREAS: priv->resizable_text_areas = g_value_get_boolean(value); break; case PROP_USER_STYLESHEET_URI: g_free(priv->user_stylesheet_uri); priv->user_stylesheet_uri = g_strdup(g_value_get_string(value)); break; case PROP_ZOOM_STEP: priv->zoom_step = g_value_get_float(value); break; case PROP_ENABLE_DEVELOPER_EXTRAS: priv->enable_developer_extras = g_value_get_boolean(value); break; case PROP_ENABLE_PRIVATE_BROWSING: priv->enable_private_browsing = g_value_get_boolean(value); break; case PROP_ENABLE_CARET_BROWSING: priv->enable_caret_browsing = g_value_get_boolean(value); break; case PROP_ENABLE_HTML5_DATABASE: priv->enable_html5_database = g_value_get_boolean(value); break; case PROP_ENABLE_HTML5_LOCAL_STORAGE: priv->enable_html5_local_storage = g_value_get_boolean(value); break; case PROP_ENABLE_SPELL_CHECKING: priv->enable_spell_checking = g_value_get_boolean(value); break; case PROP_SPELL_CHECKING_LANGUAGES: g_free(priv->spell_checking_languages); priv->spell_checking_languages = g_strdup(g_value_get_string(value)); break; case PROP_ENABLE_XSS_AUDITOR: priv->enable_xss_auditor = g_value_get_boolean(value); break; case PROP_ENABLE_SPATIAL_NAVIGATION: priv->enable_spatial_navigation = g_value_get_boolean(value); break; case PROP_ENABLE_FRAME_FLATTENING: priv->enable_frame_flattening = g_value_get_boolean(value); break; case PROP_USER_AGENT: g_free(priv->user_agent); if (!g_value_get_string(value) || !strlen(g_value_get_string(value))) priv->user_agent = g_strdup(webkitUserAgent().utf8().data()); else priv->user_agent = g_strdup(g_value_get_string(value)); break; case PROP_JAVASCRIPT_CAN_OPEN_WINDOWS_AUTOMATICALLY: priv->javascript_can_open_windows_automatically = g_value_get_boolean(value); break; case PROP_JAVASCRIPT_CAN_ACCESS_CLIPBOARD: priv->javascript_can_access_clipboard = g_value_get_boolean(value); break; case PROP_ENABLE_OFFLINE_WEB_APPLICATION_CACHE: priv->enable_offline_web_application_cache = g_value_get_boolean(value); break; case PROP_EDITING_BEHAVIOR: priv->editing_behavior = static_cast(g_value_get_enum(value)); break; case PROP_ENABLE_UNIVERSAL_ACCESS_FROM_FILE_URIS: priv->enable_universal_access_from_file_uris = g_value_get_boolean(value); break; case PROP_ENABLE_FILE_ACCESS_FROM_FILE_URIS: priv->enable_file_access_from_file_uris = g_value_get_boolean(value); break; case PROP_ENABLE_DOM_PASTE: priv->enable_dom_paste = g_value_get_boolean(value); break; case PROP_TAB_KEY_CYCLES_THROUGH_ELEMENTS: priv->tab_key_cycles_through_elements = g_value_get_boolean(value); break; case PROP_ENABLE_DEFAULT_CONTEXT_MENU: priv->enable_default_context_menu = g_value_get_boolean(value); break; case PROP_ENABLE_SITE_SPECIFIC_QUIRKS: priv->enable_site_specific_quirks = g_value_get_boolean(value); break; case PROP_ENABLE_PAGE_CACHE: priv->enable_page_cache = g_value_get_boolean(value); break; case PROP_AUTO_RESIZE_WINDOW: priv->auto_resize_window = g_value_get_boolean(value); break; case PROP_ENABLE_JAVA_APPLET: priv->enable_java_applet = g_value_get_boolean(value); break; case PROP_ENABLE_HYPERLINK_AUDITING: priv->enable_hyperlink_auditing = g_value_get_boolean(value); break; case PROP_ENABLE_FULLSCREEN: priv->enable_fullscreen = g_value_get_boolean(value); break; case PROP_ENABLE_DNS_PREFETCHING: priv->enable_dns_prefetching = g_value_get_boolean(value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec); break; } } static void webkit_web_settings_get_property(GObject* object, guint prop_id, GValue* value, GParamSpec* pspec) { WebKitWebSettings* web_settings = WEBKIT_WEB_SETTINGS(object); WebKitWebSettingsPrivate* priv = web_settings->priv; switch (prop_id) { case PROP_DEFAULT_ENCODING: g_value_set_string(value, priv->default_encoding); break; case PROP_CURSIVE_FONT_FAMILY: g_value_set_string(value, priv->cursive_font_family); break; case PROP_DEFAULT_FONT_FAMILY: g_value_set_string(value, priv->default_font_family); break; case PROP_FANTASY_FONT_FAMILY: g_value_set_string(value, priv->fantasy_font_family); break; case PROP_MONOSPACE_FONT_FAMILY: g_value_set_string(value, priv->monospace_font_family); break; case PROP_SANS_SERIF_FONT_FAMILY: g_value_set_string(value, priv->sans_serif_font_family); break; case PROP_SERIF_FONT_FAMILY: g_value_set_string(value, priv->serif_font_family); break; case PROP_DEFAULT_FONT_SIZE: g_value_set_int(value, priv->default_font_size); break; case PROP_DEFAULT_MONOSPACE_FONT_SIZE: g_value_set_int(value, priv->default_monospace_font_size); break; case PROP_MINIMUM_FONT_SIZE: g_value_set_int(value, priv->minimum_font_size); break; case PROP_MINIMUM_LOGICAL_FONT_SIZE: g_value_set_int(value, priv->minimum_logical_font_size); break; case PROP_ENFORCE_96_DPI: g_value_set_boolean(value, priv->enforce_96_dpi); break; case PROP_AUTO_LOAD_IMAGES: g_value_set_boolean(value, priv->auto_load_images); break; case PROP_AUTO_SHRINK_IMAGES: g_value_set_boolean(value, priv->auto_shrink_images); break; case PROP_PRINT_BACKGROUNDS: g_value_set_boolean(value, priv->print_backgrounds); break; case PROP_ENABLE_SCRIPTS: g_value_set_boolean(value, priv->enable_scripts); break; case PROP_ENABLE_PLUGINS: g_value_set_boolean(value, priv->enable_plugins); break; case PROP_RESIZABLE_TEXT_AREAS: g_value_set_boolean(value, priv->resizable_text_areas); break; case PROP_USER_STYLESHEET_URI: g_value_set_string(value, priv->user_stylesheet_uri); break; case PROP_ZOOM_STEP: g_value_set_float(value, priv->zoom_step); break; case PROP_ENABLE_DEVELOPER_EXTRAS: g_value_set_boolean(value, priv->enable_developer_extras); break; case PROP_ENABLE_PRIVATE_BROWSING: g_value_set_boolean(value, priv->enable_private_browsing); break; case PROP_ENABLE_CARET_BROWSING: g_value_set_boolean(value, priv->enable_caret_browsing); break; case PROP_ENABLE_HTML5_DATABASE: g_value_set_boolean(value, priv->enable_html5_database); break; case PROP_ENABLE_HTML5_LOCAL_STORAGE: g_value_set_boolean(value, priv->enable_html5_local_storage); break; case PROP_ENABLE_SPELL_CHECKING: g_value_set_boolean(value, priv->enable_spell_checking); break; case PROP_SPELL_CHECKING_LANGUAGES: g_value_set_string(value, priv->spell_checking_languages); break; case PROP_ENABLE_XSS_AUDITOR: g_value_set_boolean(value, priv->enable_xss_auditor); break; case PROP_ENABLE_SPATIAL_NAVIGATION: g_value_set_boolean(value, priv->enable_spatial_navigation); break; case PROP_ENABLE_FRAME_FLATTENING: g_value_set_boolean(value, priv->enable_frame_flattening); break; case PROP_USER_AGENT: g_value_set_string(value, priv->user_agent); break; case PROP_JAVASCRIPT_CAN_OPEN_WINDOWS_AUTOMATICALLY: g_value_set_boolean(value, priv->javascript_can_open_windows_automatically); break; case PROP_JAVASCRIPT_CAN_ACCESS_CLIPBOARD: g_value_set_boolean(value, priv->javascript_can_access_clipboard); break; case PROP_ENABLE_OFFLINE_WEB_APPLICATION_CACHE: g_value_set_boolean(value, priv->enable_offline_web_application_cache); break; case PROP_EDITING_BEHAVIOR: g_value_set_enum(value, priv->editing_behavior); break; case PROP_ENABLE_UNIVERSAL_ACCESS_FROM_FILE_URIS: g_value_set_boolean(value, priv->enable_universal_access_from_file_uris); break; case PROP_ENABLE_FILE_ACCESS_FROM_FILE_URIS: g_value_set_boolean(value, priv->enable_file_access_from_file_uris); break; case PROP_ENABLE_DOM_PASTE: g_value_set_boolean(value, priv->enable_dom_paste); break; case PROP_TAB_KEY_CYCLES_THROUGH_ELEMENTS: g_value_set_boolean(value, priv->tab_key_cycles_through_elements); break; case PROP_ENABLE_DEFAULT_CONTEXT_MENU: g_value_set_boolean(value, priv->enable_default_context_menu); break; case PROP_ENABLE_SITE_SPECIFIC_QUIRKS: g_value_set_boolean(value, priv->enable_site_specific_quirks); break; case PROP_ENABLE_PAGE_CACHE: g_value_set_boolean(value, priv->enable_page_cache); break; case PROP_AUTO_RESIZE_WINDOW: g_value_set_boolean(value, priv->auto_resize_window); break; case PROP_ENABLE_JAVA_APPLET: g_value_set_boolean(value, priv->enable_java_applet); break; case PROP_ENABLE_HYPERLINK_AUDITING: g_value_set_boolean(value, priv->enable_hyperlink_auditing); break; case PROP_ENABLE_FULLSCREEN: g_value_set_boolean(value, priv->enable_fullscreen); break; case PROP_ENABLE_DNS_PREFETCHING: g_value_set_boolean(value, priv->enable_dns_prefetching); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec); break; } } /** * webkit_web_settings_new: * * Creates a new #WebKitWebSettings instance with default values. It must * be manually attached to a WebView. * * Returns: a new #WebKitWebSettings instance **/ WebKitWebSettings* webkit_web_settings_new() { return WEBKIT_WEB_SETTINGS(g_object_new(WEBKIT_TYPE_WEB_SETTINGS, NULL)); } /** * webkit_web_settings_copy: * * Copies an existing #WebKitWebSettings instance. * * Returns: (transfer full): a new #WebKitWebSettings instance **/ WebKitWebSettings* webkit_web_settings_copy(WebKitWebSettings* web_settings) { WebKitWebSettingsPrivate* priv = web_settings->priv; WebKitWebSettings* copy = WEBKIT_WEB_SETTINGS(g_object_new(WEBKIT_TYPE_WEB_SETTINGS, "default-encoding", priv->default_encoding, "cursive-font-family", priv->cursive_font_family, "default-font-family", priv->default_font_family, "fantasy-font-family", priv->fantasy_font_family, "monospace-font-family", priv->monospace_font_family, "sans-serif-font-family", priv->sans_serif_font_family, "serif-font-family", priv->serif_font_family, "default-font-size", priv->default_font_size, "default-monospace-font-size", priv->default_monospace_font_size, "minimum-font-size", priv->minimum_font_size, "minimum-logical-font-size", priv->minimum_logical_font_size, "auto-load-images", priv->auto_load_images, "auto-shrink-images", priv->auto_shrink_images, "print-backgrounds", priv->print_backgrounds, "enable-scripts", priv->enable_scripts, "enable-plugins", priv->enable_plugins, "resizable-text-areas", priv->resizable_text_areas, "user-stylesheet-uri", priv->user_stylesheet_uri, "zoom-step", priv->zoom_step, "enable-developer-extras", priv->enable_developer_extras, "enable-private-browsing", priv->enable_private_browsing, "enable-spell-checking", priv->enable_spell_checking, "spell-checking-languages", priv->spell_checking_languages, "enable-caret-browsing", priv->enable_caret_browsing, "enable-html5-database", priv->enable_html5_database, "enable-html5-local-storage", priv->enable_html5_local_storage, "enable-xss-auditor", priv->enable_xss_auditor, "enable-spatial-navigation", priv->enable_spatial_navigation, "enable-frame-flattening", priv->enable_frame_flattening, "user-agent", webkit_web_settings_get_user_agent(web_settings), "javascript-can-open-windows-automatically", priv->javascript_can_open_windows_automatically, "javascript-can-access-clipboard", priv->javascript_can_access_clipboard, "enable-offline-web-application-cache", priv->enable_offline_web_application_cache, "editing-behavior", priv->editing_behavior, "enable-universal-access-from-file-uris", priv->enable_universal_access_from_file_uris, "enable-file-access-from-file-uris", priv->enable_file_access_from_file_uris, "enable-dom-paste", priv->enable_dom_paste, "tab-key-cycles-through-elements", priv->tab_key_cycles_through_elements, "enable-default-context-menu", priv->enable_default_context_menu, "enable-site-specific-quirks", priv->enable_site_specific_quirks, "enable-page-cache", priv->enable_page_cache, "auto-resize-window", priv->auto_resize_window, "enable-java-applet", priv->enable_java_applet, "enable-hyperlink-auditing", priv->enable_hyperlink_auditing, "enable-fullscreen", priv->enable_fullscreen, "enable-dns-prefetching", priv->enable_dns_prefetching, NULL)); return copy; } /** * webkit_web_settings_add_extra_plugin_directory: * @web_view: a #WebKitWebView * @directory: the directory to add * * Adds the @directory to paths where @web_view will search for plugins. * * Since: 1.0.3 */ void webkit_web_settings_add_extra_plugin_directory(WebKitWebView* webView, const gchar* directory) { g_return_if_fail(WEBKIT_IS_WEB_VIEW(webView)); PluginDatabase::installedPlugins()->addExtraPluginDirectory(filenameToString(directory)); } /** * webkit_web_settings_get_user_agent: * @web_settings: a #WebKitWebSettings * * Returns the User-Agent string currently used by the web view(s) associated * with the @web_settings. * * Since: 1.1.11 */ G_CONST_RETURN gchar* webkit_web_settings_get_user_agent(WebKitWebSettings* webSettings) { g_return_val_if_fail(WEBKIT_IS_WEB_SETTINGS(webSettings), NULL); WebKitWebSettingsPrivate* priv = webSettings->priv; return priv->user_agent; } namespace WebKit { WebCore::EditingBehaviorType core(WebKitEditingBehavior type) { return (WebCore::EditingBehaviorType)type; } }