OPF
SpecDefinition referenceView source

Image Placement

Bleeds an image block to one edge of the slide: the image takes a band along that edge, edge to edge, and the headings and other content compose in the rest of the slide at the normal padding. Only top-level blocks (slides.N.blocks.I) can be placed, at most one per edge; a layout's image placeholder may carry the same placement for the slide's image. Bands are taken in block order, each spanning the free area left by earlier ones. Placement is the only mechanism that moves content aside; a background never does. A slide whose only body is placed images is composed like a cover: its headings center in the free area. In a right-to-left deck 'left' is the start side, drawn at the right.

Metadata

Definition
#/$defs/ImagePlacement
Form
object
Source
spec/schemas/opf.schema.json

Field index

FieldTypeReq.Description
edgeenumyesThe slide edge the image bleeds to.
edge · Allowed values
"left""right""top""bottom"
sizenumber—Share of the slide width (left, right) or height (top, bottom) given to the band. Default 0.5.
insetboolean—Draw the frame inside the slide padding on every side of the band, like a card, instead of edge to edge. Default false.

edge

typeenumrequiredyesdefault—

The slide edge the image bleeds to.

edge · Allowed values
"left""right""top""bottom"
Field fragment · edge.json
{
  "edge": "left"
}

size

typenumberrequirednodefault—

Share of the slide width (left, right) or height (top, bottom) given to the band. Default 0.5.

inset

typebooleanrequirednodefault—

Draw the frame inside the slide padding on every side of the band, like a card, instead of edge to edge. Default false.

Complete definition constraints
Exact schema constraints
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "edge"
  ],
  "description": "Bleeds an image block to one edge of the slide: the image takes a band along that edge, edge to edge, and the headings and other content compose in the rest of the slide at the normal padding. Only top-level blocks (slides.N.blocks.I) can be placed, at most one per edge; a layout's image placeholder may carry the same placement for the slide's image. Bands are taken in block order, each spanning the free area left by earlier ones. Placement is the only mechanism that moves content aside; a background never does. A slide whose only body is placed images is composed like a cover: its headings center in the free area. In a right-to-left deck 'left' is the start side, drawn at the right.",
  "properties": {
    "edge": {
      "type": "string",
      "enum": [
        "left",
        "right",
        "top",
        "bottom"
      ],
      "description": "The slide edge the image bleeds to."
    },
    "size": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 0.9,
      "description": "Share of the slide width (left, right) or height (top, bottom) given to the band. Default 0.5."
    },
    "inset": {
      "type": "boolean",
      "description": "Draw the frame inside the slide padding on every side of the band, like a card, instead of edge to edge. Default false."
    }
  },
  "examples": [
    {
      "edge": "left",
      "size": 0.45
    },
    {
      "edge": "right",
      "size": 0.4,
      "inset": true
    }
  ]
}