Repository navigation
Releases
Releases · KlockTX/KlockEditor
KlockEditor v3.0.0 — Markdown-native WYSIWYG
Markdown 原生所见即所得
- 新增 ProseMirror + prosemirror-markdown WYSIWYG 模式
editorMode: source | wysiwyg、getEditorMode()、setEditorMode()- Markdown 仍是唯一公共 API、表单镜像和保存格式
- 支持标题、段落、粗体、斜体、删除线、代码、代码块、链接、图片、引用、有序/无序列表、分隔线
- 对任务列表、表格、脚注、数学公式、原始 HTML 等暂不完全可逆语法,切换前提示并保留源码模式
双发行版
- Editor-only:自包含前端 WYSIWYG bundle、离线预览和文档
- Full:额外包含 PHP Parsedown 预览、上传端点和第三方许可证
验证
- npm audit 生产依赖 0 漏洞
- 24 项 miniMarkdown 测试 + 4 组 WYSIWYG round-trip fixtures
- JS/PHP 语法检查、浏览器 source↔WYSIWYG↔Markdown 回写验证通过
HTML 富文本双模式最后版本为 v1.0.2。
KlockEditor v2.2.0 — Editor-only + Full
双发行版:Editor-only 纯前端 Markdown 编辑器;Full 额外包含 PHP Parsedown 预览、图片上传与许可证。新增 AbortController 预览竞态修复、setContent onChange、严格 MIME 校验、SafeMode、双包构建脚本。HTML 富文本双模式最后版本为 v1.0.2。详见 README。
KlockEditor v2.1.0 — Markdown editing feel
Markdown 编辑手感升级
- 列表 / 引用回车自动续行;有序列表自动递增;空项回车退出列表;代码块与 IME 输入受保护
- 工具栏随光标位置高亮(粗体、斜体、删除线、代码、标题、列表、任务、引用)
- 任务列表
- [ ]/- [x]语法与工具栏转换,预览渲染只读复选框 - 删除线
~~text~~语法、工具栏按钮、Ctrl/Cmd+Shift+X快捷键 - 底部字符 / 词 / 行实时统计,
statusBar: false可隐藏 - 粘贴 URL 到选中文本自动生成
[选中文本](URL)
测试:24 项断言全部通过;PHP 与 JavaScript 语法检查通过。
完整变更见 CHANGELOG.md。
KlockEditor v2.0.0 — Markdown-only
破坏性变更
移除 HTML 富文本模式,专注 Markdown。 KlockEditor 现在是纯 Markdown 编辑器(textarea + 分屏实时预览):
- 删除 contenteditable 编辑区、HTML 工具栏、源码模式与 Markdown/HTML 切换标签
setType()保留为兼容性空操作(传非'markdown'值时输出控制台警告),getType()恒返回'markdown'onChange/onSave回调签名从(content, type)简化为(content)- 需要旧版双模式行为请继续使用 v1.0.2
收益
- 核心体积缩减约 27%(js 782→566 行,css 517→439 行)
- 移除
document.execCommand富文本命令路径与selectionchange全局监听
保留能力
Markdown 工具栏全量命令、三视图(编辑/分屏/预览)、全屏(Esc 退出)、可撤销的工具栏写入(Ctrl+Z)、IME 组合输入守卫、预览三级渲染链(previewFn → previewUrl → 内置迷你渲染器,服务端失败自动回退)、拖拽/粘贴图片上传、深色模式、CSS 变量主题化、UMD/CommonJS/TypeScript 声明、npm test(20 项断言)。
完整变更见 CHANGELOG.md。
KlockEditor v1.0.2
修复
- 撤销栈:Markdown 工具栏操作(加粗/列表/表格等)改用
execCommand('insertText')写入(计入浏览器撤销栈,Ctrl+Z可撤销,不支持时回退setRangeText),不再直接赋value清空撤销栈 - IME 组合输入守卫:拼音/假名组词期间不再误触发
onChange与预览刷新,中文输入不再产生半截拼音的自动保存
新增
- 工具栏状态同步:HTML 富文本模式下光标处于粗体/斜体/下划线/删除线内时,对应按钮自动高亮
- TypeScript 类型声明
klock-editor.d.ts(CommonJS 引入与window.KlockEditor全局均有类型) - 单元测试
test/mini-markdown.test.js(零依赖,npm test,20 项断言),新增package.json
完整变更见 CHANGELOG.md。
KlockEditor v1.0.1
安全
server/upload.php不再放行 SVG(内嵌脚本会导致存储型 XSS),MIME 黑名单补image/svg+xml- 新增
server/uploads/.htaccess纵深防御:禁脚本执行、禁目录列举、活动内容强制按纯文本下载 server/preview.php脚注 id HTML 转义、脚注正文统一走渲染管线,修复属性注入- 内置迷你渲染器增加 URL 协议白名单(http/https、相对路径、锚点、mailto),阻断
javascript:/data:协议注入
修复
- HTML 源码模式切换后富文本区不隐藏的问题(CSS
display:flex覆盖了[hidden]属性) previewUrl请求失败或响应异常时自动回退内置迷你渲染器,离线双击demo.html仍可预览- 全屏模式支持 Esc 退出
- 有序 / 无序列表按钮支持多行选区批量添加前缀
destroy()在最后一个实例销毁时清理全局 toast 容器
完整变更见 CHANGELOG.md。