@openui5/sap.m/src/sap/m/ExpandableTextRenderer.js

OpenUI5 UI Library sap.m

/*!
 * OpenUI5
 * (c) Copyright 2026 SAP SE or an SAP affiliate company.
 * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
 */

// Provides default renderer for control sap.m.ExpandableText
sap.ui.define([
	"sap/ui/core/Lib",
	'sap/ui/core/Renderer',
	'sap/ui/core/library',
	'sap/m/HyphenationSupport',
	'./library'
], function(
	Library,
	Renderer,
	coreLibrary,
	HyphenationSupport,
	mobileLibrary
) {
	"use strict";

	// shortcut for sap.ui.core.TextDirection
	var TextDirection = coreLibrary.TextDirection;

	// shortcut for sap.ui.core.TextDirection
	var WrappingType = mobileLibrary.WrappingType;

	// shortcut for sap.m.EmptyIndicatorMode
	var EmptyIndicatorMode = mobileLibrary.EmptyIndicatorMode;

	// shortcut for library resource bundle
	var oRb = Library.getResourceBundleFor("sap.m");

	/**
	 * Text renderer.
	 *
	 * @author SAP SE
	 * @namespace
	 */
	var ExpandableTextRenderer = {
		apiVersion: 2
	};

	/**
	 * Renders the HTML for the given control, using the provided {@link sap.ui.core.RenderManager}.
	 *
	 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
	 * @param {sap.m.Text} oText An object representation of the control that should be rendered.
	 */
	ExpandableTextRenderer.render = function(oRm, oText) {
		// get control values
		var sDisplayedText = oText._getDisplayedText(),
			sTextDir = oText.getTextDirection(),
			sTooltip = oText.getTooltip_AsString(),
			sWrappingType = oText.getWrappingType(),
			sTextAlign = oText.getTextAlign(),
			bRenderWhitespace = oText.getRenderWhitespace(),
			bExpandable = oText._isExpandable(),
			bExpanded = oText.getProperty("expanded"),
			sEllipsisText = bExpanded ? " " : "... ",
			oAriaLabelledByControl = oText.getAggregation("_ariaLabelledBy");

		// start writing HTML
		oRm.openStart("div", oText);
		oRm.class("sapMExText");

		if (sWrappingType !== WrappingType.Hyphenated) {
			// no space text must break
			if (sDisplayedText && sDisplayedText.length > 0 && !/\s/.test(sDisplayedText)) {
				oRm.class("sapMExTextBreakWord");
			}
		}

		// write style and attributes
		oRm.attr("dir", sTextDir !== TextDirection.Inherit ? sTextDir.toLowerCase() : "auto");

		if (sTooltip)  {
			oRm.attr("title", sTooltip);
		}

		if (sTextAlign) {
			sTextAlign = Renderer.getTextAlign(sTextAlign, sTextDir);
			if (sTextAlign) {
				oRm.style("text-align", sTextAlign);
			}
		}

		if (bRenderWhitespace) {
			oRm.class("sapMExTextRenderWhitespaceWrap");
		}

		HyphenationSupport.writeHyphenationClass(oRm, oText);

		// finish writing HTML
		oRm.openEnd();

		oRm.openStart("span", oText.getId() + "-string");
		oRm.class("sapMExTextString");
		oRm.class("sapUiSelectable");
		oRm.openEnd();

		ExpandableTextRenderer.renderText(oRm, oText);

		oRm.close("span");

		if (bExpandable) {

			oRm.openStart("span");
			oRm.class("sapMExTextEllipsis");
			oRm.openEnd();
			oRm.unsafeHtml(sEllipsisText);
			oRm.close("span");

			oRm.renderControl(oText._getShowMoreLink());
		}

		oRm.renderControl(oAriaLabelledByControl);

		// finalize
		oRm.close("div");
	};

	ExpandableTextRenderer.renderText = function(oRm, oText) {
		if (oText.getEmptyIndicatorMode() !== EmptyIndicatorMode.Off && !oText.getText()) {
			this.renderEmptyIndicator(oRm, oText);
		} else {
			oRm.text(HyphenationSupport.getTextForRender(oText, "main"));
		}
	};

	/**
	 * Renders the empty text indicator.
	 *
	 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
	 * @param {sap.m.ExpandableText} oText An object representation of the control that should be rendered.
	 */
	ExpandableTextRenderer.renderEmptyIndicator = function(oRm, oText) {
		oRm.openStart("span");
			oRm.class("sapMEmptyIndicator");
			if (oText.getEmptyIndicatorMode() === EmptyIndicatorMode.Auto) {
				oRm.class("sapMEmptyIndicatorAuto");
			}
			oRm.openEnd();
			oRm.openStart("span");
			oRm.attr("aria-hidden", true);
			oRm.openEnd();
				oRm.text(oRb.getText("EMPTY_INDICATOR"));
			oRm.close("span");
			//Empty space text to be announced by screen readers
			oRm.openStart("span");
			oRm.class("sapUiPseudoInvisibleText");
			oRm.openEnd();
				oRm.text(oRb.getText("EMPTY_INDICATOR_TEXT"));
			oRm.close("span");
		oRm.close("span");
	};

	return ExpandableTextRenderer;
}, /* bExport= */ true);