Annotations and Native Text

Editable annotations are durable overlays. Imported text remains native until a visible text span is promoted through the Facade.

Insert annotations

const highlight = page.insertAnnotation({  annotationType: univerAPI.Enum.PdfAnnotationType.HIGHLIGHT,  left: 36,  top: 72,  width: 180,  height: 18,  markup: {    color: '#fde047',    opacity: 0.6,  },})

Facade insertion supports highlight, underline, strikeout, squiggly, and ink annotations. Ink requires non-empty paths; other core annotation subtypes are not accepted by this insertion API.

Read annotation data and style

const markup = highlight.getMarkup()const style = highlight.getStyle()highlight.setStyle({  stroke: { color: '#ca8a04', width: 1 },  opacity: 0.75,})

getMarkup() and getInk() return detached geometry in PDF points. setStyle() updates supported fill, stroke, and opacity fields; opacity must be between 0 and 1.

Replace imported native text

const matchingSpan = page  .getTextSpans()  .find((span) => span.getText().includes('Draft'))if (matchingSpan) {  const textBox = matchingSpan.replaceText('Final')  textBox.setTextStyle({ bold: true })}

getTextSpans() returns snapshots of currently visible, unsuppressed native text. replaceText() atomically suppresses the source operation and inserts an editable FPdfTextBox at the captured position.

An FPdfTextSpan is a snapshot handle. After replacement it is stale, so enumerate getTextSpans() again before the next native-text operation.