html2pptx/reference/coordinate.md

坐标与尺寸参数 (Coordinate Props)

坐标与尺寸参数用于指定元素在幻灯片上的位置和大小。

---

Coord 类型

type Coord = number | `${number}%`

• number：英寸值

  • 说明：以英寸为单位的数值
  • 示例：1.5（1.5 英寸）、10（10 英寸）

• ${number}%：百分比

  • 说明：相对于幻灯片尺寸的百分比
  • 示例：'50%'（一半宽度/高度）、'100%'（全宽/全高）

---

PositionProps

所有可放置元素通用的位置属性。

• x：水平位置

  • 类型：Coord
  • 单位：英寸或百分比
  • 示例：10.25、'75%'

• y：垂直位置

  • 类型：Coord
  • 单位：英寸或百分比
  • 示例：10.25、'75%'

• w：宽度

  • 类型：Coord
  • 单位：英寸或百分比
  • 示例：10.25、'75%'

• h：高度

  • 类型：Coord
  • 单位：英寸或百分比
  • 示例：10.25、'75%'

---

标准布局尺寸

布局常量名	宽度	高度	宽高比
LAYOUT_4x3	10"	7.5"	4:3
LAYOUT_16x9	10"	5.625"	16:9
LAYOUT_16x10	10"	6.25"	16:10
LAYOUT_WIDE	13.33"	7.5"	~16:9

可通过 pptx.defineLayout({ name, width, height }) 自定义布局。

px 换算参考

在 96dpi 屏幕上的参考换算关系：

• 1 英寸 = 96px
• 1pt = 1/72 英寸 ≈ 1.33px
• 1cm ≈ 0.394 英寸

---

Margin 类型

type Margin = number | [number, number, number, number]

• number：统一边距

  • 说明：四边使用相同值
  • 单位：pt
  • 示例：0（无边距）、10（四边 10pt）

• [top, right, bottom, left]：四边独立边距

  • 说明：按上右下左（TRBL）顺序分别设置
  • 单位：pt
  • 示例：[10, 5, 10, 5]（上下 10pt、左右 5pt）

---

Color 类型

type HexColor = string         // 6 位十六进制，无 # 前缀
type ThemeColor = 'tx1' | 'tx2' | 'bg1' | 'bg2'
                | 'accent1' | 'accent2' | 'accent3'
                | 'accent4' | 'accent5' | 'accent6'
type Color = HexColor | ThemeColor

十六进制颜色 (HexColor)

• 格式：6 位十六进制值，不含 # 前缀
• 示例：'FF0000'（红色）、'0088CC'（蓝色）、'FFFFFF'（白色）

主题色 (ThemeColor)

值	说明	PowerPoint 名称
'tx1'	文字 1	Theme Color Text 1
'tx2'	文字 2	Theme Color Text 2
'bg1'	背景 1	Theme Color Background 1
'bg2'	背景 2	Theme Color Background 2
'accent1'	强调色 1	Accent 1
'accent2'	强调色 2	Accent 2
'accent3'	强调色 3	Accent 3
'accent4'	强调色 4	Accent 4
'accent5'	强调色 5	Accent 5
'accent6'	强调色 6	Accent 6

可通过 pptx.SchemeColor.XXX 常量引用：

• pptx.SchemeColor.text1 → 'tx1'
• pptx.SchemeColor.background1 → 'bg1'
• pptx.SchemeColor.accent1 → 'accent1'

---

对齐类型

HAlign

type HAlign = 'left' | 'center' | 'right' | 'justify'

值	说明
'left'	左对齐
'center'	居中对齐
'right'	右对齐
'justify'	两端对齐

VAlign

type VAlign = 'top' | 'middle' | 'bottom'

值	说明
'top'	顶部对齐
'middle'	垂直居中
'bottom'	底部对齐

---

其他常用类型

ChartAxisTickMark

type ChartAxisTickMark = 'none' | 'inside' | 'outside' | 'cross'

ChartLineCap

type ChartLineCap = 'flat' | 'round' | 'square'

SHAPE_NAME

形状名称类型，包含约 180 种 PowerPoint 形状的字面量联合类型。

CHART_NAME

type CHART_NAME = 'area' | 'bar' | 'bar3D' | 'bubble' | 'doughnut' | 'line' | 'pie' | 'radar' | 'scatter'