UIScrollView

Reset UIScrollView Offset

Supported in:

Kiosk Pro Lite, Basic, Plus and Enterprise

Directly control the iOS/iPadOS's UIScrollView resettingOffset_isEnabled property. This can be used to prevent the page from scrolling back to the top after an input field is selected and the on-screen keyboard is subsequently dismissed.

Default Value: Off

Note: this setting has affects specific models of iPads differently. If your deployment is using multiple iPad models, make sure to test this setting on each type.


Values for Remote Settings Control & Managed App Configuration

Key kp_scrollsContentBehavior_isScrollResetAfterKeyboardShownEnabled
Key Type boolean
Default Value false

UIScrollView Content Inset Adjustment Behavior

Supported in:

Kiosk Pro Lite, Basic, Plus and Enterprise

Directly control the iOS/iPadOS's UIScrollView ContentInsetAdjustmentBehavior property, which can affect safe area insets on devices without a Home button, and scolling behavior of certain form views.

Default Value:
  • Never
Other Possible Values:
  • Always
  • Scrollable Axes
  • Automatic

The following descriptions are taken directly from Apple's documentation:

Never

"Do not adjust the scroll view insets."

Always

"Always include the safe area insets in the content adjustment."

Scrollable Axes

"Adjust the insets only in the scrollable directions. The top and bottom insets include the safe area inset values when the vertical content size is greater than the height of the scroll view itself. The top and bottom insets are also adjusted when the alwaysBounceVertical property is true. Similarly, the left and right insets include the safe area insets when the horizontal content size is greater than the width of the scroll view."

Automatic

"Automatically adjust the scroll view insets. Content is always adjusted vertically when the scroll view is the content view of a view controller that is currently displayed by a navigation or tab bar controller. If the scroll view is horizontally scrollable, the horizontal content offset is also adjusted when there are nonzero safe area insets."


Values for Remote Settings Control & Managed App Configuration

Key kp_scrollsContentBehavior_contentInsetAdjustmentBehavior
Key Type integer
Default Value 0
Possible Values
  • 0 = Never
  • 1 = Automatic
  • 2 = Scrollable Axes
  • 3 = Always

Change Log

  • Added Reset UIScrollView Offset in version 9.4.4. Added UIScrollView Content Inset Adjustment Behavior in version 9.5.
  • Note: While current versions of Kiosk Pro require iOS/iPadOS 12.4 or later, if you are working with an earlier version of the app and OS, these features are not available on devices before iOS 11.

Still stuck? How can we help? How can we help?