NuGet
Awaited authoring API overview
The Avalonia edition exposes native framework controls and awaited document services. Use the operation suited to the currently visible content and await its actual result.
| Member | Use |
|---|---|
Content | Load/export HTML, inspect elements and edit authored body style. |
Selection | Read/set the visible Source draft or rendered selection using UTF-16 positions. |
Formatting | Format editable Design content or use the six supported Source tag wrappers. |
StateQuery | Read formatting and command availability. |
Editor | Use current-view clipboard, history, deletion, scrolling, search, print and focus operations. |
Caret | Read actual offsets and available geometry; navigate the visible editing surface. |
Dialog | Open native authoring workflows and customize ten typed fresh-window factories. |
MailMerge | Insert, discover and merge template fields. |
TableAuthoringService | Create/revise tables and cells. |
Search | Find/replace in rendered content or the visible source draft. |
BodyHtml and DocumentHtml support binding. The native Border uses Child for its visual layout. Content is the replaceable awaited authoring service.
var found = await editor.Search.FindNextAsync("renewal", wholeWord: true);
var replacements = await editor.Search.ReplaceAllAsync("renewal", "extension", wholeWord: true);
string bodyCss = await editor.Content.GetBodyStyleAsync();Next/previous search does not wrap automatically. Replace current requires the current selected match; replace all precomputes a bounded plan and reports the actual count. Read-only and preview allow search while rejecting replacement. Source replacements stay in the visible draft and source undo history.
Mode, editing entitlement, document identity and selection identity determine whether a mutation can apply. A null/blank SetAttributeValueOfAnElementAsync value removes that supported attribute; a missing element leaves the document unchanged.
Hyperlink and property APIs
SetHyperlinkAsync accepts the shared HyperLinkDialogInputs model; RemoveHyperlinkAsync removes the selected anchor while retaining its child content. HrefUrl, Bookmark, Title, InnerHtml and optional Target describe the authored hyperlink. Native file-link browsing requires an actual picker grant. ShowCtrlClickTooltipOnHyperlinks controls the shared hint when an accepted link has no title. TableAuthoringService.SetTablePropertiesAsync and SetCellPropertiesAsync apply the shared complete property models as guarded undoable changes.
Replaceable services and notifications
Content, Editor, Caret, Formatting, Selection, StateQuery and Dialog are non-null replaceable native interfaces. MailMerge, TableAuthoringService and Search are additional services. Mode, file and spelling events follow acknowledged work; Pasting performs synchronous bounded inspection before insertion. Passive element-click/mousedown notifications contain copied data, never executable DOM objects.
Content also exposes XHTML/XML export, one-undo local-image embedding and unsent email construction. Native APIs are awaited adaptations; MSHTML COM objects and arbitrary Internet Explorer commands are not part of this edition.