Customizing the Thumbnail File Viewer on Android
The thumbnail bar is the component found on the bottom of our
PdfActivity by default, or as a standalone view named
To set the style of your thumbnail bar inside the
PdfActivity, you can use
PdfActivityConfiguration.Builder#setThumbnailBarMode (for custom layout implementation, see the
CustomFragmentActivity in our Catalog app), which takes the
ThumbnailBarMode enum as a parameter. These are the possible values:
THUMBNAIL_BAR_MODE_NONE— hides the thumbnail bar
THUMBNAIL_BAR_MODE_FLOATING— shows the floating thumbnail bar
THUMBNAIL_BAR_MODE_PINNED— shows the thumbnail bar pinned to the bottom of the screen
THUMBNAIL_BAR_MODE_SCROLLABLE— shows the scrollable thumbnail bar with larger thumbnails and without the border
To customize the look of your thumbnail bar (color, thumbnail width, thumbnail height, etc.) see the corresponding section in the Appearance Styling guide.
Gestural Navigation Support (Android Q+)
Google has announced gestural navigation as part of the Android Q navigation system. This change requires apps to update their bottom views so as not to interfere with the area reserved for gesture detection. Our floating thumbnail bar is designed with this in mind, and it will keep the necessary distance from the bottom of the screen.
The other two thumbnail bars (pinned and scrollable) were originally designed to be displayed at the bottom of the screen. They have also been redesigned to work with gestural navigation in fullscreen (immersive) mode by adding the padding on the bottom, so as not to obstruct gestural navigation touches.
Android Q introduces an option for fully gestural system navigation. There are two things that app developers should do to prepare for this feature:
Extend app content from edge to edge.
Handle conflicting app gestures.
⚠️ Warning: In order for pinned and scrollable thumbnail bars to work with gestural navigation, you must use the fullscreen mode in your activity. Otherwise, the bars will interfere with the gestural navigation area on the bottom.
ℹ️ Note: You can set the
PdfActivity to fullscreen/immersive mode via