NutrientViewConfiguration class

Typed viewer configuration for bindings-based Nutrient views.

NutrientViewConfiguration replaces the legacy PdfConfiguration for views that communicate with the native SDK directly via JNI/FFI bindings (Android) or FFI (iOS) rather than through the Pigeon method channel.

Only options that have a direct 1-to-1 mapping in the platform's native configuration builder are represented as cross-platform fields. Options that are meaningful on only one platform are grouped under the corresponding platform sub-configuration:

  • androidConfig — Android-only options
  • iosConfig — iOS-only options
  • webConfig — Web-only options (type is Object? to avoid a dependency on nutrient_flutter; pass a WebViewConfiguration instance at the call site)

Example

NutrientInstantView(
  serverUrl: 'https://example.com/api/1/documents/abc',
  jwt: 'eyJhbGci...',
  configuration: NutrientViewConfiguration(
    pageLayoutMode: PageLayoutMode.single,
    appearanceMode: AppearanceMode.night,
    thumbnailBarMode: ThumbnailBarMode.floating,
    androidConfig: AndroidViewConfiguration(
      showSearchAction: false,
    ),
    iosConfig: IOSViewConfiguration(
      spreadFitting: SpreadFitting.adaptive,
    ),
  ),
)

Constructors

NutrientViewConfiguration({ScrollDirection? scrollDirection, PageLayoutMode? pageLayoutMode, PageTransition? pageTransition, bool? firstPageAlwaysSingle, UserInterfaceViewMode? userInterfaceViewMode, ThumbnailBarMode? thumbnailBarMode, AppearanceMode? appearanceMode, int? startPage, bool? enableTextSelection, bool? enableAnnotationEditing, bool? enableFormEditing, bool? disableAutosave, bool? enableInstantComments, double? minimumZoomScale, double? maximumZoomScale, SignatureSavingStrategy? signatureSavingStrategy, SignatureCreationConfiguration? signatureCreationConfiguration, AndroidViewConfiguration? androidConfig, IOSViewConfiguration? iosConfig, Object? webConfig, Map<String, String>? aiAssistantConfiguration, String? password})
const

Properties

aiAssistantConfiguration → Map<String, String>?
Optional AI Assistant configuration.
final
androidConfig → AndroidViewConfiguration?
Android-specific options.
final
appearanceMode → AppearanceMode?
The colour theme / appearance mode of the viewer.
final
disableAutosave → bool?
Disable automatic saving of changes.
final
enableAnnotationEditing → bool?
Allow the user to create and edit annotations.
final
enableFormEditing → bool?
Allow the user to fill in form fields.
final
enableInstantComments → bool?
Enable Instant comments. Defaults to false.
final
enableTextSelection → bool?
Allow the user to select text in the document.
final
firstPageAlwaysSingle → bool?
Always show the first page as a single page in double-page mode.
final
hashCode → int
The hash code for this object.
no setterinherited
iosConfig → IOSViewConfiguration?
iOS-specific options.
final
maximumZoomScale → double?
Maximum zoom scale factor.
final
minimumZoomScale → double?
Minimum zoom scale factor.
final
pageLayoutMode → PageLayoutMode?
Single page, double-page spread, or automatic.
final
pageTransition → PageTransition?
The page transition animation.
final
password → String?
Password used to unlock an encrypted document when the view loads.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
scrollDirection → ScrollDirection?
The direction pages are scrolled.
final
signatureCreationConfiguration → SignatureCreationConfiguration?
Configures the signature creation UI (creation modes, color presets, typed-signature fonts, and per-platform layout options).
final
signatureSavingStrategy → SignatureSavingStrategy?
When the signature creation UI offers to save a new signature.
final
startPage → int?
The initial page index (zero-based) to display on open.
final
thumbnailBarMode → ThumbnailBarMode?
Where and how the page thumbnail bar is displayed.
final
userInterfaceViewMode → UserInterfaceViewMode?
When the viewer toolbar and overlays are shown.
final
webConfig → Object?
Web-specific options.
final

Methods

copyWith({ScrollDirection? scrollDirection, PageLayoutMode? pageLayoutMode, PageTransition? pageTransition, bool? firstPageAlwaysSingle, UserInterfaceViewMode? userInterfaceViewMode, ThumbnailBarMode? thumbnailBarMode, AppearanceMode? appearanceMode, int? startPage, bool? enableTextSelection, bool? enableAnnotationEditing, bool? enableFormEditing, bool? disableAutosave, bool? enableInstantComments, double? minimumZoomScale, double? maximumZoomScale, SignatureSavingStrategy? signatureSavingStrategy, SignatureCreationConfiguration? signatureCreationConfiguration, AndroidViewConfiguration? androidConfig, IOSViewConfiguration? iosConfig, Object? webConfig, Map<String, String>? aiAssistantConfiguration, String? password}) → NutrientViewConfiguration
Returns a copy of this configuration with the given fields replaced.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited