Module: ol/style/文本

ol/style/文本


Classes

文本

Type Definitions

Options{Object}

Properties:
Name Type Description
font string | undefined

字体样式，作为 CSS font 值，参见：https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/font。默认为 '10px sans-serif'
maxAngle number
(defaults to Math.PI/4)

当 placement 设置为 'line' 时，允许相邻字符之间的最大角度。预期值以弧度为单位，默认为 45°（Math.PI / 4）。
offsetX number
(defaults to 0)

水平文本偏移量（像素）。正值将使文本向右偏移。
offsetY number
(defaults to 0)

垂直文本偏移量（像素）。正值将使文本向下偏移。
overflow boolean
(defaults to false)

对于多边形标签或当 placement 设置为 'line' 时，允许文本超出标签位置处多边形的宽度或其跟随路径的长度。
placement 文本Placement
(defaults to 'point')

文本放置。
repeat number | undefined

重复间隔。设置后，文本将按此间隔重复，间隔指定两个文本锚点之间的距离（像素）。仅在 placement 设置为 'line' 时可用。覆盖 'textAlign'。
scale number | Size | undefined

比例。
rotateWithView boolean
(defaults to false)

文本是否随视图旋转。
keepUpright boolean
(defaults to true)

是否可以将文本旋转 180° 以防止倒置渲染。
rotation number
(defaults to 0)

旋转角度（弧度，正值为顺时针）。
text string | Array.<string> | undefined

文本内容或富文本内容。对于纯文本，提供一个字符串，可以包含换行符（\n）。对于富文本，提供文本/字体元组的数组。元组由要渲染的文本和要使用的字体组成（或 '' 使用文本样式的字体）。换行必须是单独的元组（即 '\n', ''）。示例：['foo', 'bold 10px sans-serif', ' bar', 'italic 10px sans-serif', ' baz', ''] 将生成 "foo bar baz"。注意：富文本不支持 placement: 'line' 或即时渲染 API。
textAlign Canvas文本Align | undefined

文本对齐方式。可能的值：'left'、'right'、'center'、'end' 或 'start'。placement: 'point' 时默认为 'center'。placement: 'line' 时，默认让渲染器选择不超过 maxAngle 的放置位置。
justify 文本Justify | undefined

文本框内的文本对齐。如果未设置，文本向 textAlign 锚点对齐。否则，使用 'left'、'center' 或 'right' 选项在文本框内对齐文本。注意：justify 在即时渲染和 placement: 'line' 时被忽略。
textBaseline Canvas文本Baseline
(defaults to 'middle')

文本基线。可能的值：'bottom'、'top'、'middle'、'alphabetic'、'hanging'、'ideographic'。
fill Fill | null | undefined

填充样式。如果未提供，将使用深色填充样式 (#333)。指定 null 表示不填充。
stroke Stroke | undefined

描边样式。
backgroundFill Fill | undefined

当 placement 为 'point' 时文本背景的填充样式。默认无填充。
backgroundStroke Stroke | undefined

当 placement 为 'point' 时文本背景的描边样式。默认无描边。
padding Array.<number>
(defaults to [0, 0, 0, 0])

文本周围用于去重叠和背景的内边距（像素）。数组中值的顺序为 [top, right, bottom, left]。
declutterMode DeclutterMode | undefined

去重叠模式：declutter、obstacle、none

文本Justify{'left'} {'center'} {'right'}

文本Placement{'point'} {'line'}

默认文本放置方式为 'point'。注意 'line' 要求底层几何图形为 LineString、Polygon、MultiLineString 或 MultiPolygon。