WKWebView加载HTML5富文本编辑器需确保baseURL正确、启用document.execCommand（调试期设环境变量）、延迟注入内容并监听消息回调、解决focus与键盘遮挡问题。

WKWebView 中加载 HTML5 富文本编辑器页面

iOS 原生不提供可直接调用的 HTML5 富文本编辑器组件，必须通过 WKWebView 加载本地或远程 HTML 页面实现。关键不是“调用编辑器”，而是“让 WebView 正确加载并交互富文本页面”。

常见错误是直接把 contenteditable 页面丢进 loadHTMLString:baseURL: 却忽略 base URL 设置，导致 JS/CSS 加载失败、编辑区域不可编辑。

• HTML 文件（如 editor.html）需放在 Bundle Resources 中，用 Bundle.main.path(forResource:ofType:) 获取路径
• baseURL 必须设为该 HTML 所在目录的 URL，否则相对路径的 script 和 style 会 404
• 确保 HTML 中 <div contenteditable="true"> 元素有明确宽高与 outline: none，否则 iOS 上可能无焦点响应

让 WKWebView 支持 document.execCommand 等旧 API

iOS 16.4+ 默认禁用 document.execCommand（很多传统 HTML5 编辑器如 medium-editor、wysihtml5 依赖它），直接调用会静默失败。

必须启用实验性 WebKit 功能：

立即学习“前端免费学习笔记（深入）”；

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

• 在 WKWebViewConfiguration 初始化后，设置：

  configuration.preferences.setValue(true, forKey: "interactiveFormValidationEnabled")

• 更关键的是添加启动参数（仅限调试阶段）：Xcode Scheme → Run → Arguments → Environment Variables，加 WEBKIT_ENABLE_COMMAND_EXECUTION=1
• 生产环境应迁移到 Document.execCommand 的替代方案，如 insertHTML + getSelection + Range 操作，或改用现代编辑器如 Tiptap（基于 ProseMirror）

从 Swift 向 HTML5 编辑器注入内容与获取编辑结果

不能靠 webView.evaluateJavaScript(_:completionHandler:) 随意读写，需确保 DOM 已就绪且编辑器初始化完成。

• 注入初始内容：等 webView(_: didFinishNavigation:) 触发后，再执行

  webView.evaluateJavaScript("document.getElementById('editor').innerHTML = '<p>Hello</p>'")

• 获取当前 HTML：用 evaluateJavaScript 调用封装好的 JS 方法，例如 getEditorHTML()，避免直接读 innerHTML（可能含冗余标签）
• 监听编辑变化：在 HTML 中用 input 或 blur 事件触发 window.webkit.messageHandlers.editorChanged.postMessage(...)，Swift 端需提前注册 WKScriptMessageHandler

键盘遮挡、光标定位与 focus 失败问题

iOS 上 WKWebView 内 contenteditable 元素 focus 后，软键盘弹出常导致视图未滚动、光标被遮挡，甚至首次 focus 失败。

• 在 HTML 中给编辑容器加 tabindex="0"，并在 JS 中显式调用 element.focus()，比依赖点击更可靠
• 监听 keyboardWillShow 通知，手动调整 WKWebView 的 frame.origin.y 或外层 UIScrollView 的 contentOffset
• 避免在 viewWillAppear 中立即 focus；改在 webView(_: didFinishNavigation:) 后延迟 0.1 秒再调用 JS focus
• 部分机型（如 iOS 17.2）对 contenteditable 的 scrollIntoView 支持不稳定，建议用 element.scrollIntoView({ behavior: 'smooth', block: 'nearest' }) 并 fallback 到手动计算偏移

真正难的不是加载一个编辑器，而是让 focus、键盘、JS 交互、内容同步这四件事在各种 iOS 版本上稳定协同——每个环节都可能因 WebKit 小版本更新而行为突变。