Skip to content

iOSBrowserOptions

Configuration object that controls the appearance and behavior of an iOSBrowser session.

Kodster.InAppWebBrowser.iOS.iOSBrowserOptions

Overview

iOSBrowserOptions contains optional settings for iOSBrowser. All properties are nullable. Unset values use the system default.

Use iOSBrowserOptionsBuilder to configure values and create instances.

Creating Instances

#if UNITY_IOS
var options = new iOSBrowserOptionsBuilder()
    .WithColorScheme(iOSColorScheme.Dark)
    .WithDismissButtonStyle(DismissButtonStyle.Close)
    .Build();

iOSBrowser.Open("https://example.com", options);
#endif

Properties

ReaderModeEnabled

public bool? ReaderModeEnabled { get; internal set; }

Whether the browser presents the page in Reader Mode if available.

BarCollapsingEnabled

public bool? BarCollapsingEnabled { get; internal set; }

Whether the toolbar collapses as the user scrolls.

Remarks

  • Not available on iOS 26 or later.

DismissButtonStyle

public DismissButtonStyle? DismissButtonStyle { get; internal set; }

Label or icon shown on the Dismiss button.

PresentationStyle

public PresentationStyle? PresentationStyle { get; internal set; }

The way the browser is presented modally.

OpenInExternalHandlerEnabled

public bool? OpenInExternalHandlerEnabled { get; internal set; }

Whether URLs that can be handled by an external app are opened there instead of in-app.

ColorScheme

public iOSColorScheme? ColorScheme { get; internal set; }

Color scheme used for the browser UI.

InteractiveDismissEnabled

public bool? InteractiveDismissEnabled { get; internal set; }

Whether the user can dismiss the browser by tapping the app behind it.

PreferredContentSize

public Vector2? PreferredContentSize { get; internal set; }

Preferred width and height of the browser content when in form-sheet style, in points.

AnimationEnabled

public bool? AnimationEnabled { get; internal set; }

Whether presentation and dismissal are animated.

InitialHeightPercent

public int? InitialHeightPercent { get; internal set; }

Initial height of the browser as a percentage of available screen height (0–100).

ExpansionEnabled

public bool? ExpansionEnabled { get; internal set; }

Whether the browser can be expanded to full height.

BackgroundInteractionEnabled

public bool? BackgroundInteractionEnabled { get; internal set; }

Whether the content behind the browser receives touch input.

GrabberVisible

public bool? GrabberVisible { get; internal set; }

Whether the grabber handle is shown at the top of the browser.

SheetCornerRadius

public float? SheetCornerRadius { get; internal set; }

Corner radius of the browser, in points.

ExpandOnScrollEnabled

public bool? ExpandOnScrollEnabled { get; internal set; }

Whether scrolling content expands the browser to full height.

KeepSheetInLandscapeEnabled

public bool? KeepSheetInLandscapeEnabled { get; internal set; }

Whether the browser remains a sheet in landscape orientation instead of going full-screen.

TransitionStyle

public TransitionStyle? TransitionStyle { get; internal set; }

Animation style used when presenting the browser modally.