Customize the annotation toolbar in the Flutter viewer

Nutrient Flutter SDK supports annotation toolbar customization on Android and iOS. You can show or hide the toolbar, reorder tools, and group related tools.

Show the annotation toolbar

Use the annotation button in the main toolbar to show or hide the annotation toolbar.

Android	iOS

Customize annotation tool groups

Use the setAnnotationToolbarItems controller method on iOS and Android to add, remove, reorder, or group annotation tools. Each entry must be an AnnotationTool or an AnnotationToolGroup. The group’s representative sets the tool the toolbar shows when the group is collapsed. Refer to the set annotation toolbar items(opens in a new tab), annotation tool(opens in a new tab), and annotation tool group(opens in a new tab) API references for details.

NutrientDocumentView(
  documentPath: documentPath,
  onControllerReady: (controller) {
    controller.setAnnotationToolbarItems([
      AnnotationTool.inkPen,
      AnnotationTool.square,
      AnnotationTool.line,
      AnnotationToolGroup(
        representative: AnnotationTool.highlight,
        items: [
          AnnotationTool.highlight,
          AnnotationTool.underline,
          AnnotationTool.strikeOut,
        ],
      ),
    ]);
  },
)

You can call setAnnotationToolbarItems again at any time. On web, annotation tools are part of the main toolbar, so this call has no effect. Customize main toolbar grouping from the main toolbar instead. Refer to the customize the main toolbar guide.

For a runnable example, open annotation_toolbar_customization_example in the Catalog app.

Customize annotation presets

The legacy method-channel API supports default annotation tool properties, such as color and thickness, through setAnnotationConfigurations and typed configuration classes like InkAnnotationConfiguration and MarkupAnnotationConfiguration. The Nutrient Flutter SDK version six controller doesn’t implement this API yet. For deeper preset customization in SDK version six, refer to the platform adapters guide to access the native SDK APIs directly.