/** * @module ol/style/Text */ import Fill from './Fill.js'; import {toSize} from '../size.js'; /** * @typedef {'point' | 'line'} TextPlacement * Default text placement is `'point'`. Note that * `'line'` requires the underlying geometry to be a {@link module:ol/geom/LineString~LineString}, * {@link module:ol/geom/Polygon~Polygon}, {@link module:ol/geom/MultiLineString~MultiLineString} or * {@link module:ol/geom/MultiPolygon~MultiPolygon}. */ /** * @typedef {'left' | 'center' | 'right'} TextJustify */ /** * The default fill color to use if no fill was set at construction time; a * blackish `#333`. * * @const {string} */ const DEFAULT_FILL_COLOR = '#333'; /** * @typedef {Object} Options * @property {string} [font] Font style as CSS `font` value, see: * https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/font. Default is `'10px sans-serif'` * @property {number} [maxAngle=Math.PI/4] When `placement` is set to `'line'`, allow a maximum angle between adjacent characters. * The expected value is in radians, and the default is 45° (`Math.PI / 4`). * @property {number} [offsetX=0] Horizontal text offset in pixels. A positive will shift the text right. * @property {number} [offsetY=0] Vertical text offset in pixels. A positive will shift the text down. * @property {boolean} [overflow=false] For polygon labels or when `placement` is set to `'line'`, allow text to exceed * the width of the polygon at the label position or the length of the path that it follows. * @property {TextPlacement} [placement='point'] Text placement. * @property {number} [repeat] Repeat interval. When set, the text will be repeated at this interval, which specifies * the distance between two text anchors in pixels. Only available when `placement` is set to `'line'`. Overrides 'textAlign'. * @property {number|import("../size.js").Size} [scale] Scale. * @property {boolean} [rotateWithView=false] Whether to rotate the text with the view. * @property {number} [rotation=0] Rotation in radians (positive rotation clockwise). * @property {string|Array} [text] Text content or rich text content. For plain text provide a string, which can * contain line breaks (`\n`). For rich text provide an array of text/font tuples. A tuple consists of the text to * render and the font to use (or `''` to use the text style's font). A line break has to be a separate tuple (i.e. `'\n', ''`). * **Example:** `['foo', 'bold 10px sans-serif', ' bar', 'italic 10px sans-serif', ' baz', '']` will yield "**foo** *bar* baz". * **Note:** Rich text is not supported for `placement: 'line'` or the immediate rendering API. * @property {CanvasTextAlign} [textAlign] Text alignment. Possible values: `'left'`, `'right'`, `'center'`, `'end'` or `'start'`. * Default is `'center'` for `placement: 'point'`. For `placement: 'line'`, the default is to let the renderer choose a * placement where `maxAngle` is not exceeded. * @property {TextJustify} [justify] Text justification within the text box. * If not set, text is justified towards the `textAlign` anchor. * Otherwise, use options `'left'`, `'center'`, or `'right'` to justify the text within the text box. * **Note:** `justify` is ignored for immediate rendering and also for `placement: 'line'`. * @property {CanvasTextBaseline} [textBaseline='middle'] Text base line. Possible values: `'bottom'`, `'top'`, `'middle'`, `'alphabetic'`, * `'hanging'`, `'ideographic'`. * @property {import("./Fill.js").default|null} [fill] Fill style. If none is provided, we'll use a dark fill-style (#333). Specify `null` for no fill. * @property {import("./Stroke.js").default} [stroke] Stroke style. * @property {import("./Fill.js").default} [backgroundFill] Fill style for the text background when `placement` is * `'point'`. Default is no fill. * @property {import("./Stroke.js").default} [backgroundStroke] Stroke style for the text background when `placement` * is `'point'`. Default is no stroke. * @property {Array} [padding=[0, 0, 0, 0]] Padding in pixels around the text for decluttering and background. The order of * values in the array is `[top, right, bottom, left]`. */ /** * @classdesc * Set text style for vector features. * @api */ class Text { /** * @param {Options} [options] Options. */ constructor(options) { options = options || {}; /** * @private * @type {string|undefined} */ this.font_ = options.font; /** * @private * @type {number|undefined} */ this.rotation_ = options.rotation; /** * @private * @type {boolean|undefined} */ this.rotateWithView_ = options.rotateWithView; /** * @private * @type {number|import("../size.js").Size|undefined} */ this.scale_ = options.scale; /** * @private * @type {import("../size.js").Size} */ this.scaleArray_ = toSize(options.scale !== undefined ? options.scale : 1); /** * @private * @type {string|Array|undefined} */ this.text_ = options.text; /** * @private * @type {CanvasTextAlign|undefined} */ this.textAlign_ = options.textAlign; /** * @private * @type {TextJustify|undefined} */ this.justify_ = options.justify; /** * @private * @type {number|undefined} */ this.repeat_ = options.repeat; /** * @private * @type {CanvasTextBaseline|undefined} */ this.textBaseline_ = options.textBaseline; /** * @private * @type {import("./Fill.js").default} */ this.fill_ = options.fill !== undefined ? options.fill : new Fill({color: DEFAULT_FILL_COLOR}); /** * @private * @type {number} */ this.maxAngle_ = options.maxAngle !== undefined ? options.maxAngle : Math.PI / 4; /** * @private * @type {TextPlacement} */ this.placement_ = options.placement !== undefined ? options.placement : 'point'; /** * @private * @type {boolean} */ this.overflow_ = !!options.overflow; /** * @private * @type {import("./Stroke.js").default} */ this.stroke_ = options.stroke !== undefined ? options.stroke : null; /** * @private * @type {number} */ this.offsetX_ = options.offsetX !== undefined ? options.offsetX : 0; /** * @private * @type {number} */ this.offsetY_ = options.offsetY !== undefined ? options.offsetY : 0; /** * @private * @type {import("./Fill.js").default} */ this.backgroundFill_ = options.backgroundFill ? options.backgroundFill : null; /** * @private * @type {import("./Stroke.js").default} */ this.backgroundStroke_ = options.backgroundStroke ? options.backgroundStroke : null; /** * @private * @type {Array|null} */ this.padding_ = options.padding === undefined ? null : options.padding; } /** * Clones the style. * @return {Text} The cloned style. * @api */ clone() { const scale = this.getScale(); return new Text({ font: this.getFont(), placement: this.getPlacement(), repeat: this.getRepeat(), maxAngle: this.getMaxAngle(), overflow: this.getOverflow(), rotation: this.getRotation(), rotateWithView: this.getRotateWithView(), scale: Array.isArray(scale) ? scale.slice() : scale, text: this.getText(), textAlign: this.getTextAlign(), justify: this.getJustify(), textBaseline: this.getTextBaseline(), fill: this.getFill() ? this.getFill().clone() : undefined, stroke: this.getStroke() ? this.getStroke().clone() : undefined, offsetX: this.getOffsetX(), offsetY: this.getOffsetY(), backgroundFill: this.getBackgroundFill() ? this.getBackgroundFill().clone() : undefined, backgroundStroke: this.getBackgroundStroke() ? this.getBackgroundStroke().clone() : undefined, padding: this.getPadding() || undefined, }); } /** * Get the `overflow` configuration. * @return {boolean} Let text overflow the length of the path they follow. * @api */ getOverflow() { return this.overflow_; } /** * Get the font name. * @return {string|undefined} Font. * @api */ getFont() { return this.font_; } /** * Get the maximum angle between adjacent characters. * @return {number} Angle in radians. * @api */ getMaxAngle() { return this.maxAngle_; } /** * Get the label placement. * @return {TextPlacement} Text placement. * @api */ getPlacement() { return this.placement_; } /** * Get the repeat interval of the text. * @return {number|undefined} Repeat interval in pixels. * @api */ getRepeat() { return this.repeat_; } /** * Get the x-offset for the text. * @return {number} Horizontal text offset. * @api */ getOffsetX() { return this.offsetX_; } /** * Get the y-offset for the text. * @return {number} Vertical text offset. * @api */ getOffsetY() { return this.offsetY_; } /** * Get the fill style for the text. * @return {import("./Fill.js").default} Fill style. * @api */ getFill() { return this.fill_; } /** * Determine whether the text rotates with the map. * @return {boolean|undefined} Rotate with map. * @api */ getRotateWithView() { return this.rotateWithView_; } /** * Get the text rotation. * @return {number|undefined} Rotation. * @api */ getRotation() { return this.rotation_; } /** * Get the text scale. * @return {number|import("../size.js").Size|undefined} Scale. * @api */ getScale() { return this.scale_; } /** * Get the symbolizer scale array. * @return {import("../size.js").Size} Scale array. */ getScaleArray() { return this.scaleArray_; } /** * Get the stroke style for the text. * @return {import("./Stroke.js").default} Stroke style. * @api */ getStroke() { return this.stroke_; } /** * Get the text to be rendered. * @return {string|Array|undefined} Text. * @api */ getText() { return this.text_; } /** * Get the text alignment. * @return {CanvasTextAlign|undefined} Text align. * @api */ getTextAlign() { return this.textAlign_; } /** * Get the justification. * @return {TextJustify|undefined} Justification. * @api */ getJustify() { return this.justify_; } /** * Get the text baseline. * @return {CanvasTextBaseline|undefined} Text baseline. * @api */ getTextBaseline() { return this.textBaseline_; } /** * Get the background fill style for the text. * @return {import("./Fill.js").default} Fill style. * @api */ getBackgroundFill() { return this.backgroundFill_; } /** * Get the background stroke style for the text. * @return {import("./Stroke.js").default} Stroke style. * @api */ getBackgroundStroke() { return this.backgroundStroke_; } /** * Get the padding for the text. * @return {Array|null} Padding. * @api */ getPadding() { return this.padding_; } /** * Set the `overflow` property. * * @param {boolean} overflow Let text overflow the path that it follows. * @api */ setOverflow(overflow) { this.overflow_ = overflow; } /** * Set the font. * * @param {string|undefined} font Font. * @api */ setFont(font) { this.font_ = font; } /** * Set the maximum angle between adjacent characters. * * @param {number} maxAngle Angle in radians. * @api */ setMaxAngle(maxAngle) { this.maxAngle_ = maxAngle; } /** * Set the x offset. * * @param {number} offsetX Horizontal text offset. * @api */ setOffsetX(offsetX) { this.offsetX_ = offsetX; } /** * Set the y offset. * * @param {number} offsetY Vertical text offset. * @api */ setOffsetY(offsetY) { this.offsetY_ = offsetY; } /** * Set the text placement. * * @param {TextPlacement} placement Placement. * @api */ setPlacement(placement) { this.placement_ = placement; } /** * Set the repeat interval of the text. * @param {number|undefined} [repeat] Repeat interval in pixels. * @api */ setRepeat(repeat) { this.repeat_ = repeat; } /** * Set whether to rotate the text with the view. * * @param {boolean} rotateWithView Rotate with map. * @api */ setRotateWithView(rotateWithView) { this.rotateWithView_ = rotateWithView; } /** * Set the fill. * * @param {import("./Fill.js").default} fill Fill style. * @api */ setFill(fill) { this.fill_ = fill; } /** * Set the rotation. * * @param {number|undefined} rotation Rotation. * @api */ setRotation(rotation) { this.rotation_ = rotation; } /** * Set the scale. * * @param {number|import("../size.js").Size|undefined} scale Scale. * @api */ setScale(scale) { this.scale_ = scale; this.scaleArray_ = toSize(scale !== undefined ? scale : 1); } /** * Set the stroke. * * @param {import("./Stroke.js").default} stroke Stroke style. * @api */ setStroke(stroke) { this.stroke_ = stroke; } /** * Set the text. * * @param {string|Array|undefined} text Text. * @api */ setText(text) { this.text_ = text; } /** * Set the text alignment. * * @param {CanvasTextAlign|undefined} textAlign Text align. * @api */ setTextAlign(textAlign) { this.textAlign_ = textAlign; } /** * Set the justification. * * @param {TextJustify|undefined} justify Justification. * @api */ setJustify(justify) { this.justify_ = justify; } /** * Set the text baseline. * * @param {CanvasTextBaseline|undefined} textBaseline Text baseline. * @api */ setTextBaseline(textBaseline) { this.textBaseline_ = textBaseline; } /** * Set the background fill. * * @param {import("./Fill.js").default} fill Fill style. * @api */ setBackgroundFill(fill) { this.backgroundFill_ = fill; } /** * Set the background stroke. * * @param {import("./Stroke.js").default} stroke Stroke style. * @api */ setBackgroundStroke(stroke) { this.backgroundStroke_ = stroke; } /** * Set the padding (`[top, right, bottom, left]`). * * @param {Array|null} padding Padding. * @api */ setPadding(padding) { this.padding_ = padding; } } export default Text;