形状与文本

Slides 使用共享 Shape 引擎提供可编辑形状、连接线和形状文本。FSlide.insertShape() 返回由 Slides 命令管线驱动的形状 Facade。

插入形状

TypeScript

const slide = univerAPI.getActivePresentation()?.getActiveSlide()if (!slide) {  throw new Error('No active slide')}const shape = slide.insertShape({  shapeType: univerAPI.Enum.ShapeTypeEnum.RoundRect,  transform: { left: 80, top: 64, width: 320, height: 120 },  visible: true,  selectable: true,  shapeData: {    fill: {      fillType: univerAPI.Enum.ShapeFillEnum.SolidFill,      color: '#dbeafe',    },  },})

Shape 宿主适配器不可用或输入无法创建时，insertShape() 可能返回 null。插入形状前，请注册 Slides 配置所需的 Shape 依赖。

添加富文本

TypeScript

if (shape) {  const richText = univerAPI.newRichText()    .text('Quarterly ')    .bold('review')  shape.getText()    .setRichText(richText)    .setHorizontalAlign(univerAPI.Enum.HorizontalAlign.CENTER)    .setVerticalAlign(univerAPI.Enum.VerticalAlign.MIDDLE)}

使用 slide.getShape(id) 或 slide.getShapes() 获取形状。通用元素方法可更新位置、尺寸、可见性、名称和描述；slide.deleteElement(shape) 会删除形状。

编辑形状文字

使用下方或前面示例中 insertShape() 返回的形状对象。getText() 返回实时的 FShapeText 对象，可通过 getPlainText() 读取纯文本、setText() 替换全部文字，并设置字体、颜色和对齐方式。

TypeScript

if (!shape) throw new Error('Shape is not available')const shapeText = shape.getText()console.log(shapeText.getPlainText())shapeText  .setText('Quarterly review')  .setFontSize(18)  .setColor('#2563eb')  .setBold(true)  .setHorizontalAlign(univerAPI.Enum.HorizontalAlign.CENTER)  .setVerticalAlign(univerAPI.Enum.VerticalAlign.MIDDLE)

setText() 会替换已有文字；同一形状需要多种文字样式时，使用 setRichText()。编辑现有富文本时，先调用 getRichText()?.copy()，修改构建器后再传给 setRichText()，仅修改构建器不会自动写回。更多选项见文字样式和文本框内边距与布局。

TypeScript

const richText = univerAPI.newRichText()  .text('Quarterly ')  .bold('review')shapeText.setRichText(richText)

形状格式刷

选中源形状，启用格式刷，再选择目标形状。格式刷复制填充、描边、效果及受支持的文字格式，保留目标的标识、几何信息、文字内容和公式绑定。清除格式会恢复插入时的默认样式。SmartArt 不参与此操作；对应的形状 UI 插件会自动注册该行为。

你觉得这篇文档如何？