1.17 release notes

Nutrient Web SDK 1.17 makes slot-based UI customization reactive, improves text selection accuracy, and strengthens screen reader support for annotations. It also updates GdPicture and ships a broad round of rendering, forms, and stability fixes. See the changelog for full details.

Reactive UI slot customization

This release makes the slot-based UI customization system reactive, so custom slots stay in sync with your application state and the SDK lifecycle without manual DOM bookkeeping.

• Slot callbacks now receive a helpers argument that exposes requestUpdate(). Call it from asynchronous work, event handlers, or lifecycle hooks to ask the SDK to re-invoke your slot’s render with the current parameters (but not synchronously from within render).
• A slot’s render now runs once at mount and then again automatically once the SDK instance becomes available, so getInstance() returns the live instance without extra wiring.
• Slot lifecycle timing is more predictable: Most slots fire after instance availability, while the loader and passwordPrompt slots keep their original raw mount timing because they can render before load() resolves.

NutrientViewer.load({
  // ...your existing configuration.
  ui: {
    commentThread: (getInstance, id, { requestUpdate }) => {
      const root = document.createElement("div");
      return {
        render: () => {
          // `getInstance()` is null until the instance is available;
          // `render` then runs again automatically once it is.
          root.textContent = getInstance() ? `Thread ${id}` : "Loading…";
          return root;
        },
        onMount: () => {
          // Rerun `render` whenever your own application state changes.
          myStore.subscribe(requestUpdate);
        },
      };
    },
  },
});

For more information, refer to the UI customization and supported slots guides.

Improved text selection accuracy

This release improves text selection accuracy. In Document Engine mode, this improvement requires Document Engine 1.17.0 or later once available.

Accessibility

Screen reader support is improved for annotations. When keyboard focus lands on a markup, ink, or shape annotation, the SDK now exposes the annotation’s referenced text, so assistive technologies announce the content the annotation refers to.

Other additions

• GdPicture is updated to 14.4.4. Refer to the GdPicture changelog for details.

Performance, rendering, and stability

• Fixes several Document Editor issues, including a crash when moving selected pages after a page in the same selection, inconsistent reordering when moving multiple selected pages, and a move dialog that could require two taps on mobile.
• Fixes a range of Form Creator and form field issues: Editing a field’s name no longer makes it disappear until the next click, Control/Command-click no longer silently exits the active interaction mode, Shift-click now registers on the first widget when starting a multiselection, and newly created fields can be renamed repeatedly in standalone mode.
• Fixes signature handling, including filling overlapping signature form fields, a selection flicker on filled signature fields, typed electronic signatures being cropped in RTL documents, and a raw localization key in the signature image picker.
• Fixes measurement issues, including a loupe that could stay visible after pressing Escape, fractional precision labels showing an incorrect inch suffix for non-inch units, and an error and ghost label left behind after undoing an in-progress polygon area measurement.
• Fixes several rendering issues, including thin white or colored lines in smooth background areas, squiggly text markup appearing truncated after resizing or zooming, search highlights making matched text unreadable in Safari, custom overlay items drifting from page content while scrolling, and rendering of zero-size and small pages in server-backed mode.
• Fixes text annotation autofit so disabled autofit preserves manually resized bounding boxes when changing text properties and stops text selection toolbar items from appearing in the annotation toolbar.
• Additional fixes across Instant JSON export (checkbox and radio button option labels) and standalone document loading for generic or missing MIME types.

For a full list of fixes, refer to the changelog.

For a complete list of changes, bug fixes, and improvements, refer to the changelog. For previous release notes, refer to the Web SDK 1.16 release notes. We appreciate your feedback and contributions as we continue to enhance Nutrient Web SDK.