highcharts
Version:
JavaScript charting framework
434 lines (433 loc) • 18.4 kB
JavaScript
/* *
*
* (c) 2010-2020 Torstein Honsi
*
* License: www.highcharts.com/license
*
* !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
*
* */
import H from '../../Globals.js';
import U from '../../Utilities.js';
import AST from '../HTML/AST.js';
var doc = H.doc, SVG_NS = H.SVG_NS;
var attr = U.attr, erase = U.erase, isString = U.isString, objectEach = U.objectEach, pick = U.pick;
/**
* SVG Text Builder
* @private
* @class
* @name Highcharts.TextBuilder
*/
var TextBuilder = /** @class */ (function () {
function TextBuilder(svgElement) {
var textStyles = svgElement.styles;
this.renderer = svgElement.renderer;
this.svgElement = svgElement;
this.width = svgElement.textWidth;
this.textLineHeight = textStyles && textStyles.lineHeight;
this.textOutline = textStyles && textStyles.textOutline;
this.ellipsis = Boolean(textStyles && textStyles.textOverflow === 'ellipsis');
this.noWrap = Boolean(textStyles && textStyles.whiteSpace === 'nowrap');
this.fontSize = textStyles && textStyles.fontSize;
}
/**
* Build an SVG representation of the pseudo HTML given in the object's
* svgElement.
*
* @private
*
* @return {void}.
*/
TextBuilder.prototype.buildSVG = function () {
var wrapper = this.svgElement;
var textNode = wrapper.element, renderer = wrapper.renderer, textStr = pick(wrapper.textStr, '').toString(), hasMarkup = textStr.indexOf('<') !== -1, childNodes = textNode.childNodes, textCache, i = childNodes.length, tempParent = this.width && !wrapper.added && renderer.box;
var regexMatchBreaks = /<br.*?>/g;
// The buildText code is quite heavy, so if we're not changing something
// that affects the text, skip it (#6113).
textCache = [
textStr,
this.ellipsis,
this.noWrap,
this.textLineHeight,
this.textOutline,
this.fontSize,
this.width
].join(',');
if (textCache === wrapper.textCache) {
return;
}
wrapper.textCache = textCache;
delete wrapper.actualWidth;
// Remove old text
while (i--) {
textNode.removeChild(childNodes[i]);
}
// Simple strings, add text directly and return
if (!hasMarkup &&
!this.ellipsis &&
!this.width &&
(textStr.indexOf(' ') === -1 ||
(this.noWrap && !regexMatchBreaks.test(textStr)))) {
textNode.appendChild(doc.createTextNode(this.unescapeEntities(textStr)));
// Complex strings, add more logic
}
else if (textStr !== '') {
if (tempParent) {
// attach it to the DOM to read offset width
tempParent.appendChild(textNode);
}
// Step 1. Parse the markup safely and directly into a tree
// structure.
var ast = new AST(textStr);
// Step 2. Do as many as we can of the modifications to the tree
// structure before it is added to the DOM
this.modifyTree(ast.nodes);
ast.addToDOM(wrapper.element);
// Step 3. Some modifications can't be done until the structure is
// in the DOM, because we need to read computed metrics.
this.modifyDOM();
// Add title if an ellipsis was added
if (this.ellipsis &&
(textNode.textContent || '').indexOf('\u2026') !== -1) {
wrapper.attr('title', this.unescapeEntities(wrapper.textStr || '', ['<', '>']) // #7179
);
}
if (tempParent) {
tempParent.removeChild(textNode);
}
}
// Apply the text outline
if (isString(this.textOutline) && wrapper.applyTextOutline) {
wrapper.applyTextOutline(this.textOutline);
}
};
/**
* Modify the DOM of the generated SVG structure. This function only does
* operations that cannot be done until the elements are attached to the
* DOM, like doing layout based on rendered metrics of the added elements.
*
* @private
*
* @return {void}
*/
TextBuilder.prototype.modifyDOM = function () {
var _this = this;
var wrapper = this.svgElement;
var x = attr(wrapper.element, 'x');
// Modify hard line breaks by applying the rendered line height
[].forEach.call(wrapper.element.querySelectorAll('tspan.highcharts-br'), function (br) {
if (br.nextSibling && br.previousSibling) { // #5261
attr(br, {
// Since the break is inserted in front of the next
// line, we need to use the next sibling for the line
// height
dy: _this.getLineHeight(br.nextSibling),
x: x
});
}
});
// Constrain the line width, either by ellipsis or wrapping
var width = this.width || 0;
if (!width) {
return;
}
// Insert soft line breaks into each text node
var modifyTextNode = function (textNode, parentElement) {
var text = textNode.textContent || '';
var words = text
.replace(/([^\^])-/g, '$1- ') // Split on hyphens
// .trim()
.split(' '); // #1273
var hasWhiteSpace = !_this.noWrap && (words.length > 1 || wrapper.element.childNodes.length > 1);
var dy = _this.getLineHeight(parentElement);
var lineNo = 0;
var startAt = wrapper.actualWidth;
if (_this.ellipsis) {
if (text) {
_this.truncate(textNode, text, void 0, 0,
// Target width
Math.max(0,
// Substract the font face to make room for the
// ellipsis itself
width - parseInt(_this.fontSize || 12, 10)),
// Build the text to test for
function (text, currentIndex) {
return text.substring(0, currentIndex) + '\u2026';
});
}
}
else if (hasWhiteSpace) {
var lines = [];
// Remove preceding siblings in order to make the text length
// calculation correct in the truncate function
var precedingSiblings = [];
while (parentElement.firstChild &&
parentElement.firstChild !== textNode) {
precedingSiblings.push(parentElement.firstChild);
parentElement.removeChild(parentElement.firstChild);
}
while (words.length) {
// Apply the previous line
if (words.length && !_this.noWrap && lineNo > 0) {
lines.push(textNode.textContent || '');
textNode.textContent = words.join(' ')
.replace(/- /g, '-');
}
// For each line, truncate the remaining
// words into the line length.
_this.truncate(textNode, void 0, words, lineNo === 0 ? (startAt || 0) : 0, width,
// Build the text to test for
function (t, currentIndex) {
return words
.slice(0, currentIndex)
.join(' ')
.replace(/- /g, '-');
});
startAt = wrapper.actualWidth;
lineNo++;
}
// Reinsert the preceding child nodes
precedingSiblings.forEach(function (childNode) {
parentElement.insertBefore(childNode, textNode);
});
// Insert the previous lines before the original text node
lines.forEach(function (line) {
// Insert the line
parentElement.insertBefore(doc.createTextNode(line), textNode);
// Insert a break
var br = doc.createElementNS(SVG_NS, 'tspan');
br.textContent = '\u200B'; // zero-width space
attr(br, { dy: dy, x: x });
parentElement.insertBefore(br, textNode);
});
}
};
// Recurse down the DOM tree and handle line breaks for each text node
var modifyChildren = (function (node) {
var childNodes = [].slice.call(node.childNodes);
childNodes.forEach(function (childNode) {
if (childNode.nodeType === Node.TEXT_NODE) {
modifyTextNode(childNode, node);
}
else {
// Reset word-wrap width readings after hard breaks
if (childNode.className.baseVal
.indexOf('highcharts-br') !== -1) {
wrapper.actualWidth = 0;
}
// Recurse down to child node
modifyChildren(childNode);
}
});
});
modifyChildren(wrapper.element);
};
/**
* Get the rendered line height of a <text>, <tspan> or pure text node.
*
* @param {DOMElementType|Text} node The node to check for
*
* @return {number} The rendered line height
*/
TextBuilder.prototype.getLineHeight = function (node) {
var fontSizeStyle;
// If the node is a text node, use its parent
var element = node.nodeType === Node.TEXT_NODE ?
node.parentElement :
node;
if (!this.renderer.styledMode) {
fontSizeStyle =
element && /(px|em)$/.test(element.style.fontSize) ?
element.style.fontSize :
(this.fontSize || this.renderer.style.fontSize || 12);
}
return this.textLineHeight ?
parseInt(this.textLineHeight.toString(), 10) :
this.renderer.fontMetrics(fontSizeStyle, element || this.svgElement.element).h;
};
/**
* Transform a pseudo HTML AST node tree into an SVG structure. We do as
* much heavy lifting as we can here, before doing the final processing in
* the modifyDOM function. The original data is mutated.
*
* @private
*
* @param {ASTNode[]} nodes The AST nodes
*
* @return {void}
*/
TextBuilder.prototype.modifyTree = function (nodes) {
var _this = this;
var modifyChild = function (node, i) {
var tagName = node.tagName;
var styledMode = _this.renderer.styledMode;
var attributes = node.attributes || {};
// Apply styling to text tags
if (tagName === 'b' || tagName === 'strong') {
if (styledMode) {
attributes['class'] = 'highcharts-strong'; // eslint-disable-line dot-notation
}
else {
attributes.style = 'font-weight:bold;' + (attributes.style || '');
}
}
else if (tagName === 'i' || tagName === 'em') {
if (styledMode) {
attributes['class'] = 'highcharts-emphasized'; // eslint-disable-line dot-notation
}
else {
attributes.style = 'font-style:italic;' + (attributes.style || '');
}
}
// Modify attributes
if (isString(attributes.style)) {
attributes.style = attributes.style.replace(/(;| |^)color([ :])/, '$1fill$2');
}
if (tagName === 'br') {
attributes['class'] = 'highcharts-br'; // eslint-disable-line dot-notation
node.textContent = '\u200B'; // zero-width space
// Trim whitespace off the beginning of new lines
var nextNode = nodes[i + 1];
if (nextNode && nextNode.textContent) {
nextNode.textContent =
nextNode.textContent.replace(/^ +/gm, '');
}
}
if (tagName !== '#text' && tagName !== 'a') {
node.tagName = 'tspan';
}
node.attributes = attributes;
// Recurse
if (node.children) {
node.children
.filter(function (c) { return c.tagName !== '#text'; })
.forEach(modifyChild);
}
};
nodes.forEach(modifyChild);
// Remove empty spans from the beginning because SVG's getBBox doesn't
// count empty lines. The use case is tooltip where the header is empty.
while (nodes[0]) {
if (nodes[0].tagName === 'tspan' && !nodes[0].children) {
nodes.splice(0, 1);
}
else {
break;
}
}
};
/*
* Truncate the text node contents to a given length. Used when the css
* width is set. If the `textOverflow` is `ellipsis`, the text is truncated
* character by character to the given length. If not, the text is
* word-wrapped line by line.
*/
TextBuilder.prototype.truncate = function (textNode, text, words, startAt, width, getString) {
var svgElement = this.svgElement;
var renderer = svgElement.renderer, rotation = svgElement.rotation;
// Cache the lengths to avoid checking the same twice
var lengths = [];
// Word wrap can not be truncated to shorter than one word, ellipsis
// text can be completely blank.
var minIndex = words ? 1 : 0;
var maxIndex = (text || words || '').length;
var currentIndex = maxIndex;
var str;
var actualWidth;
var getSubStringLength = function (charEnd, concatenatedEnd) {
// charEnd is used when finding the character-by-character
// break for ellipsis, concatenatedEnd is used for word-by-word
// break for word wrapping.
var end = concatenatedEnd || charEnd;
var parentNode = textNode.parentNode;
if (parentNode && typeof lengths[end] === 'undefined') {
// Modern browsers
if (parentNode.getSubStringLength) {
// Fails with DOM exception on unit-tests/legend/members
// of unknown reason. Desired width is 0, text content
// is "5" and end is 1.
try {
lengths[end] = startAt +
parentNode.getSubStringLength(0, words ? end + 1 : end);
}
catch (e) {
'';
}
// Legacy
}
else if (renderer.getSpanWidth) { // #9058 jsdom
textNode.textContent = getString(text || words, charEnd);
lengths[end] = startAt +
renderer.getSpanWidth(svgElement, textNode);
}
}
return lengths[end];
};
svgElement.rotation = 0; // discard rotation when computing box
actualWidth = getSubStringLength(textNode.textContent.length);
if (startAt + actualWidth > width) {
// Do a binary search for the index where to truncate the text
while (minIndex <= maxIndex) {
currentIndex = Math.ceil((minIndex + maxIndex) / 2);
// When checking words for word-wrap, we need to build the
// string and measure the subStringLength at the concatenated
// word length.
if (words) {
str = getString(words, currentIndex);
}
actualWidth = getSubStringLength(currentIndex, str && str.length - 1);
if (minIndex === maxIndex) {
// Complete
minIndex = maxIndex + 1;
}
else if (actualWidth > width) {
// Too large. Set max index to current.
maxIndex = currentIndex - 1;
}
else {
// Within width. Set min index to current.
minIndex = currentIndex;
}
}
// If max index was 0 it means the shortest possible text was also
// too large. For ellipsis that means only the ellipsis, while for
// word wrap it means the whole first word.
if (maxIndex === 0) {
// Remove ellipsis
textNode.textContent = '';
// If the new text length is one less than the original, we don't
// need the ellipsis
}
else if (!(text && maxIndex === text.length - 1)) {
textNode.textContent = str || getString(text || words, currentIndex);
}
}
// When doing line wrapping, prepare for the next line by removing the
// items from this line.
if (words) {
words.splice(0, currentIndex);
}
svgElement.actualWidth = actualWidth;
svgElement.rotation = rotation; // Apply rotation again.
};
/*
* Un-escape HTML entities based on the public `renderer.escapes` list
*
* @private
*
* @param {string} inputStr The string to unescape
* @param {Array<string>} [except] Exceptions
*
* @return {string} The processed string
*/
TextBuilder.prototype.unescapeEntities = function (inputStr, except) {
objectEach(this.renderer.escapes, function (value, key) {
if (!except || except.indexOf(value) === -1) {
inputStr = inputStr.toString().replace(new RegExp(value, 'g'), key);
}
});
return inputStr;
};
return TextBuilder;
}());
export default TextBuilder;