babylonjs-gui 7.15.1 → 7.16.0

package/babylon.gui.d.ts

@@ -3942,7 +3942,11 @@ declare module BABYLON.GUI {
         /**
          * Wrap the text word-wise and clip the text when the text's height is larger than the Control.height, and shrink the last line with trailing … .
          */
-        WordWrapEllipsis = 3
+        WordWrapEllipsis = 3,
+        /**
+         * Use HTML to wrap the text. This is the only mode that supports east-asian languages.
+         */
+        HTML = 4
     }
     /**
      * Class used to create text block control
@@ -3978,6 +3982,16 @@ declare module BABYLON.GUI {
          * Function used to split a string into words. By default, a string is split at each space character found
          */
         wordSplittingFunction: BABYLON.Nullable<(line: string) => string[]>;
+        /**
+         * This function will be called when a new HTML element is generated to be used for word wrapping.
+         * This is only used when wrapping mode HTML is selected.
+         * Using this function you can adjust word-break, overflow-wrap, hyphens, or any other CSS properties of the HTML element, language-dependent.
+         */
+        adjustWordWrappingHTMLElement: BABYLON.Nullable<(element: HTMLElement) => void>;
+        /**
+         * Gets or sets a boolean indicating if the HTML element generated for word wrapping should be reused or removed after each wrapping.
+         */
+        reuseHTMLForWordWrapping: boolean;
         /**
          * Return the line list (you may need to use the onLinesReadyObservable to make sure the list is ready)
          */
@@ -4103,6 +4117,8 @@ declare module BABYLON.GUI {
         protected _applyStates(context: BABYLON.ICanvasRenderingContext): void;
         private _linesTemp;
         protected _breakLines(refWidth: number, refHeight: number, context: BABYLON.ICanvasRenderingContext): object[];
+        private _htmlElement;
+        protected _parseHTMLText(refWidth: number, refHeight: number, context: BABYLON.ICanvasRenderingContext): string[];
         protected _parseLine(line: string | undefined, context: BABYLON.ICanvasRenderingContext): object;
         private _getCharsToRemove;
         protected _parseLineEllipsis(line: string | undefined, width: number, context: BABYLON.ICanvasRenderingContext): object;