Learning in public — this reference is being written in the open. Unfinished pages are excluded from search engines.
paged.IDML Reference
Scripting (paged.*)

Settable paths & id grammar

The property paths accepted by paged.set, and the id grammar for addressing elements — generated from the engine's scripting catalog.

Tier: ProProIIIreference

In short how you address an element (the id grammar) and what you can change on it (the settable paths, the second argument to paged.set). Both are generated from the engine catalog and stay in lockstep with the mutation layer.

Addressing elements

  • textFrame:<id> e.g. textFrame:u123A text frame. Same scheme: rectangle:/oval:/polygon:/graphicLine:/group:.
  • group:<id> e.g. group:u88A group. `paged.set("group:<id>", "groupTransform", [a,b,c,d,tx,ty])` moves it as a unit.
  • storyRange:<storyId>@<start>..<end> e.g. storyRange:Story/u1@0..6A character range within a story (half-open). storyId comes from paged.stories()[].selfId.

Settable property paths

Grouped by theme, with the IDML type hint and description where a path maps to a known attribute. Each group links to its runnable showcase.

175 of 175 settable paths — the second argument to paged.set(id, path, value), grouped by theme.

Anchored objects & text wrap demo ▸

frameTextWrapMode
frameTextWrapOffsets
frameTextWrapContourType
frameTextWrapContourIncludeInside
frameTextWrapInvert
anchoredPosition
anchorPoint
anchoredXOffset
anchoredYOffset
anchoredHorizontalReference
anchoredVerticalReference
anchoredHorizontalAlignment
anchoredVerticalAlignment
anchoredSpineRelative
anchoredLockPosition

Tables & cells demo ▸

appliedCellStyle
appliedTableStyle
cellFillColor
cellFillTint
cellInsetTop
cellInsetLeft
cellInsetBottom
cellInsetRight
cellVerticalJustification
cellTopEdgeStrokeColor
cellTopEdgeStrokeWeight
cellTopEdgeStrokeTint
cellBottomEdgeStrokeColor
cellBottomEdgeStrokeWeight
cellBottomEdgeStrokeTint
cellLeftEdgeStrokeColor
cellLeftEdgeStrokeWeight
cellLeftEdgeStrokeTint
cellRightEdgeStrokeColor
cellRightEdgeStrokeWeight
cellRightEdgeStrokeTint
tableRowCount
tableColumnCount

Text & paragraph demo ▸

characterFontSizepointsFont size in points.
characterLeadingpoints | AutoLine leading.
characterTracking1/1000 emLetter tracking.
characterFillColorswatch refText fill swatch.
paragraphSpaceBeforepointsSpace above the paragraph.
paragraphSpaceAfterpointsSpace below the paragraph.
paragraphFirstLineIndent
appliedParagraphStylestyle refThe paragraph style applied to the range.
appliedCharacterStylestyle refThe character style applied to the range.
frameInsetSpacing
paragraphJustificationenumParagraph alignment/justification.
paragraphStyleNextStyle
paragraphAppliedNumberingList
textFrameColumnCount
textFrameColumnGutter
textFrameColumnBalance
textFrameVerticalJustification
textFrameAutoSizing
textFrameFirstBaseline

Effects demo ▸

frameDropShadow
frameDropShadowMode
frameDropShadowXOffset
frameDropShadowYOffset
frameDropShadowSize
frameDropShadowOpacity
frameDropShadowColor
frameInnerShadow
frameInnerShadowBlendMode
frameInnerShadowColor
frameInnerShadowOpacity
frameInnerShadowAngle
frameInnerShadowDistance
frameInnerShadowSize
frameInnerShadowChoke
frameInnerShadowNoise
frameOuterGlow
frameOuterGlowBlendMode
frameOuterGlowColor
frameOuterGlowOpacity
frameOuterGlowSpread
frameOuterGlowSize
frameOuterGlowNoise
frameInnerGlow
frameInnerGlowBlendMode
frameInnerGlowColor
frameInnerGlowOpacity
frameInnerGlowChoke
frameInnerGlowSize
frameInnerGlowSource
frameInnerGlowNoise
frameBevel
frameBevelStyle
frameBevelTechnique
frameBevelDepth
frameBevelDirection
frameBevelSize
frameBevelSoften
frameBevelAngle
frameBevelAltitude
frameBevelHighlightColor
frameBevelShadowColor
frameBevelHighlightOpacity
frameBevelShadowOpacity
frameSatin
frameSatinBlendMode
frameSatinColor
frameSatinOpacity
frameSatinAngle
frameSatinDistance
frameSatinSize
frameSatinInvert
frameFeather
frameFeatherWidth
frameFeatherCornerType
frameFeatherNoise
frameFeatherChoke
frameDirectionalFeather
frameDirectionalFeatherLeftWidth
frameDirectionalFeatherRightWidth
frameDirectionalFeatherTopWidth
frameDirectionalFeatherBottomWidth
frameDirectionalFeatherAngle
frameDirectionalFeatherNoise
frameDirectionalFeatherChoke

Corners & fitting demo ▸

frameFittingCrops
frameFittingType
frameFittingReferencePoint
frameAutoFit
frameCornerOptionTopLeft
frameCornerOptionTopRight
frameCornerOptionBottomLeft
frameCornerOptionBottomRight
frameCornerRadiusTopLeft
frameCornerRadiusTopRight
frameCornerRadiusBottomLeft
frameCornerRadiusBottomRight

Strokes & dashes demo ▸

frameStrokeColorswatch refStroke swatch.
frameStrokeWeightpointsStroke weight in points.
frameStrokeEndCap
frameStrokeStartArrowhead
frameStrokeEndArrowhead
frameGradientStrokeAngle
frameGradientStrokeLength
frameStrokeType
frameStrokeJoin
frameStrokeMiterLimit
frameStrokeAlignment
frameStrokeGapColor
frameStrokeGapTint
frameStrokeDashArray
frameOverprintStroke

Fills & gradients demo ▸

frameFillColorswatch refFill swatch (e.g. Color/Red).
frameFillTint0–100Fill tint percentage.
frameGradientFillAngle
frameGradientFillLength
frameOverprintFill

Transform & geometry demo ▸

frameBounds[t,l,b,r] pointsPage-local bounds in points.
frameTransformaffine [a,b,c,d,e,f]The frame's affine placement transform.
imageContentTransform
framePathPoint
pathPointInsert
pathPointRemove
pathPointCurveType
framePath
frameRotationAngle
frameScaleX
frameScaleY
frameFlipH
frameFlipV

Blend & opacity demo ▸

frameOpacity
frameNonprinting
frameBlendMode

Styles, layers & visibility demo ▸

appliedObjectStyle
appliedConditions
pluginMetadata
elementVisible
elementLocked

On this page