src/third_party/WebKit/public/web/WebSettings.h

   1 /*
   2  * Copyright (C) 2009 Google Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions are
   6  * met:
   7  *
   8  *     * Redistributions of source code must retain the above copyright
   9  * notice, this list of conditions and the following disclaimer.
  10  *     * Redistributions in binary form must reproduce the above
  11  * copyright notice, this list of conditions and the following disclaimer
  12  * in the documentation and/or other materials provided with the
  13  * distribution.
  14  *     * Neither the name of Google Inc. nor the names of its
  15  * contributors may be used to endorse or promote products derived from
  16  * this software without specific prior written permission.
  17  *
  18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29  */
  30
  31 #ifndef WebSettings_h
  32 #define WebSettings_h
  33
  34 #include "../platform/WebCommon.h"
  35 #include "../platform/WebSize.h"
  36 #include <unicode/uscript.h>
  37
  38 namespace blink {
  39
  40 class WebString;
  41 class WebURL;
  42
  43 // WebSettings is owned by the WebView and allows code to modify the settings for
  44 // the WebView's page without any knowledge of WebCore itself.  For the most part,
  45 // these functions have a 1:1 mapping with the methods in WebCore/page/Settings.h.
  46 class WebSettings {
  47 public:
  48     enum EditingBehavior {
  49         EditingBehaviorMac,
  50         EditingBehaviorWin,
  51         EditingBehaviorUnix,
  52         EditingBehaviorAndroid
  53     };
  54
  55     enum V8CacheOptions {
  56         V8CacheOptionsOff,
  57         V8CacheOptionsParse,
  58         V8CacheOptionsCode
  59     };
  60
  61     enum V8ScriptStreamingMode {
  62         V8ScriptStreamingModeAll,
  63         V8ScriptStreamingModeOnlyAsyncAndDefer,
  64         V8ScriptStreamingModeAllPlusBlockParsingBlocking,
  65     };
  66
  67     // Bit field values to tell Blink what kind of pointer/hover types are
  68     // available on the system. These must match the enums in
  69     // core/css/PointerProperties.h and their equality is compile-time asserted
  70     // in WebSettingsImpl.cpp.
  71     enum PointerType {
  72         PointerTypeNone = 1,
  73         PointerTypeCoarse = 2,
  74         PointerTypeFine = 4
  75     };
  76
  77     enum HoverType {
  78         HoverTypeNone = 1,
  79         // Indicates that the primary pointing system can hover, but it requires
  80         // a significant action on the user’s part. e.g. hover on “long press”.
  81         HoverTypeOnDemand = 2,
  82         HoverTypeHover = 4
  83     };
  84
  85     virtual bool mainFrameResizesAreOrientationChanges() const = 0;
  86     virtual int availablePointerTypes() const = 0;
  87     virtual PointerType primaryPointerType() const = 0;
  88     virtual int availableHoverTypes() const = 0;
  89     virtual HoverType primaryHoverType() const = 0;
  90     virtual bool shrinksViewportContentToFit() const = 0;
  91     virtual bool viewportEnabled() const = 0;
  92     virtual void setAccelerated2dCanvasEnabled(bool) = 0;
  93     virtual void setAccelerated2dCanvasMSAASampleCount(int) = 0;
  94     virtual void setAcceleratedCompositingEnabled(bool) = 0;
  95     virtual void setPreferCompositingToLCDTextEnabled(bool) = 0;
  96     // Not implemented yet, see http://crbug.com/178119
  97     virtual void setAcceleratedCompositingForTransitionEnabled(bool) { };
  98     // If set to true, allows frames with an https origin to display passive
  99     // contents at an insecure URL. Otherwise, disallows it. The
 100     // FrameLoaderClient set to the frame may override the value set by this
 101     // method.
 102     virtual void setAccessibilityEnabled(bool) = 0;
 103     virtual void setAccessibilityPasswordValuesEnabled(bool) = 0;
 104     virtual void setAllowDisplayOfInsecureContent(bool) = 0;
 105     virtual void setAllowFileAccessFromFileURLs(bool) = 0;
 106     virtual void setAllowCustomScrollbarInMainFrame(bool) = 0;
 107     // If set to true, allows frames with an https origin to run active
 108     // contents at an insecure URL. This includes WebSockets. Otherwise,
 109     // disallows it. The FrameLoaderClient set to the frame may override the
 110     // value set by this method.
 111     virtual void setAllowRunningOfInsecureContent(bool) = 0;
 112     // If set to true, allows frames with an https origin to connect WebSockets
 113     // with an insecure URL (ws://). Otherwise, disallows it. Only when this is
 114     // set to true, this value overrides the value set by
 115     // setAllowRunningOfInsecureContent() for WebSockets. The FrameLoaderClient
 116     // set to the frame may override the value set by this method.
 117     virtual void setAllowConnectingInsecureWebSocket(bool) = 0;
 118     virtual void setAllowScriptsToCloseWindows(bool) = 0;
 119     virtual void setAllowUniversalAccessFromFileURLs(bool) = 0;
 120     virtual void setAntialiased2dCanvasEnabled(bool) = 0;
 121     virtual void setAntialiasedClips2dCanvasEnabled(bool) = 0;
 122     virtual void setAsynchronousSpellCheckingEnabled(bool) = 0;
 123     virtual void setAutoZoomFocusedNodeToLegibleScale(bool) = 0;
 124     virtual void setCaretBrowsingEnabled(bool) = 0;
 125     virtual void setClobberUserAgentInitialScaleQuirk(bool) = 0;
 126     virtual void setContainerCullingEnabled(bool) = 0;
 127     virtual void setCookieEnabled(bool) = 0;
 128     virtual void setNavigateOnDragDrop(bool) = 0;
 129     virtual void setCursiveFontFamily(const WebString&, UScriptCode = USCRIPT_COMMON) = 0;
 130     virtual void setDNSPrefetchingEnabled(bool) = 0;
 131     virtual void setDOMPasteAllowed(bool) = 0;
 132     virtual void setDefaultFixedFontSize(int) = 0;
 133     virtual void setDefaultFontSize(int) = 0;
 134     virtual void setDefaultTextEncodingName(const WebString&) = 0;
 135     virtual void setDefaultVideoPosterURL(const WebString&) = 0;
 136     void setDeferred2dCanvasEnabled(bool) { } // temporary stub
 137     virtual void setDeferredImageDecodingEnabled(bool) = 0;
 138     virtual void setDeviceScaleAdjustment(float) = 0;
 139     virtual void setDeviceSupportsMouse(bool) = 0;
 140     virtual void setDeviceSupportsTouch(bool) = 0;
 141     virtual void setDoubleTapToZoomEnabled(bool) = 0;
 142     virtual void setDownloadableBinaryFontsEnabled(bool) = 0;
 143     virtual void setEditingBehavior(EditingBehavior) = 0;
 144     virtual void setEnableScrollAnimator(bool) = 0;
 145     virtual void setEnableTouchAdjustment(bool) = 0;
 146     virtual void setRegionBasedColumnsEnabled(bool) = 0;
 147     virtual void setExperimentalWebGLEnabled(bool) = 0;
 148     virtual void setFantasyFontFamily(const WebString&, UScriptCode = USCRIPT_COMMON) = 0;
 149     virtual void setFixedFontFamily(const WebString&, UScriptCode = USCRIPT_COMMON) = 0;
 150     virtual void setForceZeroLayoutHeight(bool) = 0;
 151     virtual void setFullscreenSupported(bool) = 0;
 152     virtual void setHyperlinkAuditingEnabled(bool) = 0;
 153     virtual void setIgnoreMainFrameOverflowHiddenQuirk(bool) = 0;
 154     virtual void setImagesEnabled(bool) = 0;
 155     virtual void setInlineTextBoxAccessibilityEnabled(bool) = 0;
 156     virtual void setJavaEnabled(bool) = 0;
 157     virtual void setJavaScriptCanAccessClipboard(bool) = 0;
 158     virtual void setJavaScriptCanOpenWindowsAutomatically(bool) = 0;
 159     virtual void setJavaScriptEnabled(bool) = 0;
 160     virtual void setLayerSquashingEnabled(bool) = 0;
 161     virtual void setLoadsImagesAutomatically(bool) = 0;
 162     virtual void setLoadWithOverviewMode(bool) = 0;
 163     virtual void setLocalStorageEnabled(bool) = 0;
 164     virtual void setMainFrameClipsContent(bool) = 0;
 165     virtual void setMainFrameResizesAreOrientationChanges(bool) = 0;
 166     virtual void setMaxTouchPoints(int) = 0;
 167     virtual void setMediaControlsOverlayPlayButtonEnabled(bool) = 0;
 168     virtual void setMediaPlaybackRequiresUserGesture(bool) = 0;
 169     virtual void setMinimumAccelerated2dCanvasSize(int) = 0;
 170     virtual void setMinimumFontSize(int) = 0;
 171     virtual void setMinimumLogicalFontSize(int) = 0;
 172     virtual void setMockScrollbarsEnabled(bool) = 0;
 173     virtual void setOfflineWebApplicationCacheEnabled(bool) = 0;
 174     virtual void setOpenGLMultisamplingEnabled(bool) = 0;
 175     virtual void setPasswordEchoDurationInSeconds(double) = 0;
 176     virtual void setPasswordEchoEnabled(bool) = 0;
 177     virtual void setPerTilePaintingEnabled(bool) = 0;
 178     virtual void setPictographFontFamily(const WebString&, UScriptCode = USCRIPT_COMMON) = 0;
 179     virtual void setPinchOverlayScrollbarThickness(int) = 0;
 180     virtual void setPinchVirtualViewportEnabled(bool) = 0;
 181     virtual void setPluginsEnabled(bool) = 0;
 182     virtual void setAvailablePointerTypes(int) = 0;
 183     virtual void setPrimaryPointerType(PointerType) = 0;
 184     virtual void setAvailableHoverTypes(int) = 0;
 185     virtual void setPrimaryHoverType(HoverType) = 0;
 186     virtual void setRenderVSyncNotificationEnabled(bool) = 0;
 187     virtual void setReportScreenSizeInPhysicalPixelsQuirk(bool) = 0;
 188     virtual void setRootLayerScrolls(bool) = 0;
 189     virtual void setSansSerifFontFamily(const WebString&, UScriptCode = USCRIPT_COMMON) = 0;
 190     virtual void setSelectTrailingWhitespaceEnabled(bool) = 0;
 191     virtual void setSelectionIncludesAltImageText(bool) = 0;
 192     virtual void setSerifFontFamily(const WebString&, UScriptCode = USCRIPT_COMMON) = 0;
 193     virtual void setShouldPrintBackgrounds(bool) = 0;
 194     virtual void setShouldClearDocumentBackground(bool) = 0;
 195     virtual void setShouldRespectImageOrientation(bool) = 0;
 196     virtual void setShowFPSCounter(bool) = 0;
 197     virtual void setShowPaintRects(bool) = 0;
 198     virtual void setShrinksStandaloneImagesToFit(bool) = 0;
 199     virtual void setShrinksViewportContentToFit(bool) = 0;
 200     virtual void setSmartInsertDeleteEnabled(bool) = 0;
 201     // Spatial navigation feature, when enabled, improves the experience
 202     // of keyboard-controlling the web pages which originally were not designed
 203     // for keyboard navigation. It allows to use arrow keys to move focus between
 204     // the adjacent HTML elements. As a side effect, it extends the criteria for
 205     // elements to be focusable to include any element which has click or keyboard
 206     // event handlers specified. User can also trigger click handlers for such
 207     // elements using SPACE or ENTER keys.
 208     virtual void setSpatialNavigationEnabled(bool) = 0;
 209     virtual void setStandardFontFamily(const WebString&, UScriptCode = USCRIPT_COMMON) = 0;
 210     virtual void setSupportDeprecatedTargetDensityDPI(bool) = 0;
 211     virtual void setSupportsMultipleWindows(bool) = 0;
 212     virtual void setSyncXHRInDocumentsEnabled(bool) = 0;
 213     virtual void setTextAreasAreResizable(bool) = 0;
 214     virtual void setTextAutosizingEnabled(bool) = 0;
 215     virtual void setAccessibilityFontScaleFactor(float) = 0;
 216     virtual void setThreadedScrollingEnabled(bool) = 0;
 217     virtual void setTouchDragDropEnabled(bool) = 0;
 218     virtual void setTouchEditingEnabled(bool) = 0;
 219     virtual void setUnifiedTextCheckerEnabled(bool) = 0;
 220     virtual void setUnsafePluginPastingEnabled(bool) = 0;
 221     virtual void setUseLegacyBackgroundSizeShorthandBehavior(bool) = 0;
 222     virtual void setUseSolidColorScrollbars(bool) = 0;
 223     virtual void setUseWideViewport(bool) = 0;
 224     virtual void setUsesEncodingDetector(bool) = 0;
 225     virtual void setV8CacheOptions(V8CacheOptions) = 0;
 226     virtual void setV8ScriptStreamingEnabled(bool) = 0;
 227     virtual void setV8ScriptStreamingMode(V8ScriptStreamingMode) = 0;
 228     virtual void setValidationMessageTimerMagnification(int) = 0;
 229     virtual void setViewportEnabled(bool) = 0;
 230     virtual void setViewportMetaEnabled(bool) = 0;
 231     virtual void setViewportMetaLayoutSizeQuirk(bool) = 0;
 232     virtual void setViewportMetaMergeContentQuirk(bool) = 0;
 233     virtual void setViewportMetaNonUserScalableQuirk(bool) = 0;
 234     virtual void setViewportMetaZeroValuesQuirk(bool) = 0;
 235     virtual void setWebAudioEnabled(bool) = 0;
 236     virtual void setWebGLErrorsToConsoleEnabled(bool) = 0;
 237     virtual void setWebSecurityEnabled(bool) = 0;
 238     virtual void setWideViewportQuirkEnabled(bool) = 0;
 239     virtual void setXSSAuditorEnabled(bool) = 0;
 240
 241 protected:
 242     ~WebSettings() { }
 243 };
 244
 245 } // namespace blink
 246
 247 #endif