SVGTextContentElement: getSubStringLength()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die getSubStringLength()-Methode des SVGTextContentElement-Interfaces repräsentiert die berechnete Länge des formatierten Textfortschrittsabstandes für einen Teilstring von Text innerhalb des Elements.

Beachten Sie, dass diese Methode nur die Breiten der Glyphen im Teilstring und jeglichen zusätzlichen Abstand berücksichtigt, der durch die CSS-Eigenschaften letter-spacing und word-spacing eingefügt wird. Visuelle Abstandsänderungen, die durch das x-Attribut vorgenommen werden, werden ignoriert.

Syntax

js
SVGTextContentElement.getSubStringLength(index, length)

Parameter

index

Ein integer; der Startindex des Teilstrings.

length

Ein integer; die Anzahl der Zeichen, die im Teilstring enthalten sein sollen.

Rückgabewert

Ein float.

Ausnahmen

IndexSizeError DOMException

Wird ausgelöst, wenn der index größer als der höchste Index ist oder length negativ ist.

Beispiele

Die Länge eines Teilstrings ermitteln

html
<svg width="300" height="100">
  <text id="exampleText" x="10" y="50" font-size="16">Hello, SVG World!</text>
</svg>
js
const textElement = document.getElementById("exampleText");

// Get the length of a substring starting at character 0 with 5 characters
const substringLength = textElement.getSubStringLength(0, 5);

console.log(substringLength); // Output: 35.55

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGTextContentElement__getSubStringLength

Browser-Kompatibilität

BCD tables only load in the browser