Gradient Background

Fixed gradient slide background fill.

Metadata

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

Field index

Field	Type	Req.	Description
tone	enum	—	Whether the background is dark or light, which picks the color map (dark1 or light1) so text, lines and neutrals read on it. Without a tone a picture or gradient takes the deck's variant, else counts as light. `tone` · Allowed values `"dark""light"`
type	const	yes	Fixed gradient background fill. `type` · Allowed values `"gradient"`
gradient	object	yes	Gradient fill definition.
opacity	number	—	Background opacity from 0 (fully transparent) to 1 (fully opaque).

`tone`

typeenumrequirednodefault—

Whether the background is dark or light, which picks the color map (dark1 or light1) so text, lines and neutrals read on it. Without a tone a picture or gradient takes the deck's variant, else counts as light.

tone · Allowed values: "dark""light"

tone.json

{
  "tone": "dark"
}

`type`

typeconstrequiredyesdefault—

Fixed gradient background fill.

type · Allowed values: "gradient"

type.json

{
  "type": "gradient"
}

`gradient`

typeobjectrequiredyesdefault—

Gradient fill definition.

gradient.stops[].color · Named choices (see schema for other values and constraints): "accent1""accent2""accent3""accent4""accent5""accent6""dark1""dark2""light1""light2""hyperlink""followedHyperlink""primary""secondary""accent""background""surface""surfaceAlt""text""textSecondary"

`opacity`

typenumberrequirednodefault—

Background opacity from 0 (fully transparent) to 1 (fully opaque).

Complete definition constraints

Schema constraints

{
  "type": "object",
  "description": "Fixed gradient slide background fill.",
  "required": [
    "type",
    "gradient"
  ],
  "properties": {
    "tone": {
      "type": "string",
      "enum": [
        "dark",
        "light"
      ],
      "description": "Whether the background is dark or light, which picks the color map (dark1 or light1) so text, lines and neutrals read on it. Without a tone a picture or gradient takes the deck's variant, else counts as light."
    },
    "type": {
      "type": "string",
      "const": "gradient",
      "description": "Fixed gradient background fill."
    },
    "gradient": {
      "type": "object",
      "description": "Gradient fill definition.",
      "properties": {
        "angle": {
          "type": "number",
          "description": "Gradient angle in degrees (0 = left-to-right, 90 = top-to-bottom)."
        },
        "stops": {
          "type": "array",
          "minItems": 2,
          "description": "Ordered list of color stops along the gradient. A gradient needs at least two stops.",
          "items": {
            "type": "object",
            "description": "Color stop along the gradient.",
            "required": [
              "color",
              "position"
            ],
            "properties": {
              "color": {
                "$ref": "#/$defs/ColorRef",
                "description": "Stop color: a hex string, a color-scheme slot or role name, or a var:<id> variable reference (a ColorRef).",
                "examples": [
                  "#1E40AF",
                  "#22D3EE"
                ]
              },
              "position": {
                "type": "number",
                "minimum": 0,
                "maximum": 1,
                "description": "Stop position along the gradient, from 0 (start) to 1 (end)."
              }
            }
          }
        }
      }
    },
    "opacity": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Background opacity from 0 (fully transparent) to 1 (fully opaque)."
    }
  }
}