用户体验与宿主集成
hostLayoutAutoSize
控制是否启用宿主尺寸自动同步(ResizeObserver、视口补高、inner 包装)。
hostLayoutAutoSize
默认开启:在挂载点插入 sveditor-host-inner,用 ResizeObserver 同步宽高;必要时用语义视口高度补高(fillFromTop),便于工具栏固定、正文滚动。设为 false 则 React 直接挂在宿主上,无上述逻辑,需自行保证高度。
选项
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
hostLayoutAutoSize | boolean | true | 仅 false 关闭;undefined 视为开启 |
SVeditor.create({
el: '#editor',
hostLayoutAutoSize: false,
});关闭后须自行给挂载节点确定高度(如父级 flex + min-h-0 + height: 100% / calc)。
开启时摘要:宿主加类 sveditor-host;监听 resize / scroll 与 visualViewport;宿主带内联 height(含数字)时以布局测量为准;尊重 max-height / min-height。
适合关闭:嵌入异常(如 iframe / Shadow DOM 测量不准)、或你已全部接管布局。
详见 EditorOptions。