with one click
content-render-first-paint
// 修复或排查 `markdown-flow-ui` 的 `ContentRender` 在关闭打字机效果时首屏空白、helper 行先于正文出现等首次渲染时序问题时使用本技能。
// 修复或排查 `markdown-flow-ui` 的 `ContentRender` 在关闭打字机效果时首屏空白、helper 行先于正文出现等首次渲染时序问题时使用本技能。
保持 `markdown-flow-ui` 中基于 iframe 的幻灯片(`Slide`)步骤常驻挂载,通过 CSS `display` 切换可见性。当幻灯片导航需要降低 iframe 重载耗时、要把 `is_renderable` 驱动的卸载渲染改为“隐藏但已挂载”策略、或在预加载改造中保持 `is_new`、`diff`、交互步骤语义不变时使用本技能。
为 `markdown-flow-ui` 的 `ContentRender` 新增或更新“后端整句到达、前端按固定节奏做打字机输出”的 story 时使用本技能。
修改 `markdown-flow-ui` 的 `MarkdownFlowEditor` 国际化语言时使用本技能,尤其适用于新增 locale、补充编辑器文案资源、以及让上游项目传入的语言配置安全落到编辑器内部的场景。
为 `markdown-flow-ui` 的幻灯片(`Slide`)新增或更新可模拟流式播放的 `story` 时使用本技能,尤其适用于通过 `StreamingSlidePreview` 渲染、且为单元素 iframe 承载 `html` 的幻灯片场景。
统一 `markdown-flow-ui` 中 `ContentRender`、`IframeSandbox`、`Slide` 等场景的 loading 遮罩表现时使用本技能。
当调整 `markdown-flow-ui` 的 `Slide` 移动端播放器控制栏,尤其涉及 `playerCustomActions` 的桥接型节点、占位空槽和 more icon 入口时使用本技能。
| name | content-render-first-paint |
| description | 修复或排查 `markdown-flow-ui` 的 `ContentRender` 在关闭打字机效果时首屏空白、helper 行先于正文出现等首次渲染时序问题时使用本技能。 |
当 ContentRender 关闭打字机效果时,正文应在首次 render 同步可见,不要依赖 useEffect 二次补内容。
displayContent 一类中间态是否以空字符串初始化,并在 useEffect 中补齐正文。typingSpeed、enableTypewriter、onTypeFinished 这类兼容参数或中间态 hook;直接让 ContentRender 走同步全量渲染,避免首屏和状态机再次耦合。console.log 或调试输出。