OPF
OpenPresentation/opf
SpecDefinition referenceView source

Numbering Spec

The value of a numbering field: a style name or Numbering object for every level, or an array with one entry per level (at most 9, the native depth).

Metadata

Definition
#/$defs/NumberingSpec
Form
3 alternative forms (oneOf)
Source
spec/schemas/opf.schema.json

Field index

This definition uses the forms or value constraints below.

oneOf 1 · ref:NumberingStyle

Referenced NumberingStyle · enum

A list number style: 1, 2, 3; I, II, III; i, ii, iii; A, B, C; a, b, c. Alphabetic numbering past 26 repeats the letter as PowerPoint does (aa, bb, cc). Roman numerals stop at 3999; larger values are drawn in arabic with a numbering-adapted diagnostic.

Exact constraints for Referenced NumberingStyle
Referenced NumberingStyle schema
{
  "type": "string",
  "enum": [
    "arabic",
    "roman-upper",
    "roman-lower",
    "alpha-upper",
    "alpha-lower"
  ],
  "description": "A list number style: 1, 2, 3; I, II, III; i, ii, iii; A, B, C; a, b, c. Alphabetic numbering past 26 repeats the letter as PowerPoint does (aa, bb, cc). Roman numerals stop at 3999; larger values are drawn in arabic with a numbering-adapted diagnostic."
}
Exact constraints for oneOf 1
oneOf 1 schema
{
  "$ref": "#/$defs/NumberingStyle"
}

oneOf 2 · ref:Numbering

Referenced Numbering · object

Numbering of one list level.

FieldTypeReq.DefaultDescription
styleref:NumberingStyle——Number style. Default arabic.
style · Allowed values
"arabic""roman-upper""roman-lower""alpha-upper""alpha-lower"
startinteger——First number counted at this level. Default 1. Native PowerPoint accepts 1 to 32767.
suffixenum——Text after the number: period (1.), paren (1)) or paren-both ((1)). Default period.
suffix · Allowed values
"period""paren""paren-both"

style

typeref:NumberingStylerequirednodefault—

Number style. Default arabic.

style · Allowed values
"arabic""roman-upper""roman-lower""alpha-upper""alpha-lower"
Field fragment · style.json
{
  "style": "arabic"
}

start

typeintegerrequirednodefault—

First number counted at this level. Default 1. Native PowerPoint accepts 1 to 32767.

suffix

typeenumrequirednodefault—

Text after the number: period (1.), paren (1)) or paren-both ((1)). Default period.

suffix · Allowed values
"period""paren""paren-both"
Field fragment · suffix.json
{
  "suffix": "period"
}
Exact constraints for Referenced Numbering
Referenced Numbering schema
{
  "type": "object",
  "additionalProperties": false,
  "description": "Numbering of one list level.",
  "properties": {
    "style": {
      "$ref": "#/$defs/NumberingStyle",
      "description": "Number style. Default arabic."
    },
    "start": {
      "type": "integer",
      "minimum": 1,
      "maximum": 32767,
      "description": "First number counted at this level. Default 1. Native PowerPoint accepts 1 to 32767."
    },
    "suffix": {
      "type": "string",
      "enum": [
        "period",
        "paren",
        "paren-both"
      ],
      "description": "Text after the number: period (1.), paren (1)) or paren-both ((1)). Default period."
    }
  }
}
Exact constraints for oneOf 2
oneOf 2 schema
{
  "$ref": "#/$defs/Numbering"
}

oneOf 3 · array<ref:NumberingStyle | ref:Numbering>

Exact constraints for oneOf 3
oneOf 3 schema
{
  "type": "array",
  "minItems": 1,
  "maxItems": 9,
  "items": {
    "oneOf": [
      {
        "$ref": "#/$defs/NumberingStyle"
      },
      {
        "$ref": "#/$defs/Numbering"
      }
    ]
  }
}
Complete definition constraints
Exact schema constraints
{
  "description": "The value of a numbering field: a style name or Numbering object for every level, or an array with one entry per level (at most 9, the native depth).",
  "oneOf": [
    {
      "$ref": "#/$defs/NumberingStyle"
    },
    {
      "$ref": "#/$defs/Numbering"
    },
    {
      "type": "array",
      "minItems": 1,
      "maxItems": 9,
      "items": {
        "oneOf": [
          {
            "$ref": "#/$defs/NumberingStyle"
          },
          {
            "$ref": "#/$defs/Numbering"
          }
        ]
      }
    }
  ]
}
value · Named choices (see schema for other values and constraints)
"arabic""roman-upper""roman-lower""alpha-upper""alpha-lower"