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 中 元素有明确宽高与
outline: none，否则 iOS 上可能无焦点响应让 WKWebView 支持 document.execCommand 等旧 API
iOS 16.4+ 默认禁用
document.execCommand（很多传统 HTML5 编辑器如medium-editor、wysihtml5依赖它），直接调用会静默失败。必须启用实验性 WebKit 功能：
立即学习“前端免费学习笔记（深入）”；
- 在
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 = 'Hello
'") - 获取当前 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 小版本更新而行为突变。
- 在
