ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Fiori Elements 里的长文本不该挤成一行,@UI.multiLineText 如何让描述字段真正拥有多行语义

2026/8/7 8:22:16 拓冰建站 浏览量
Fiori Elements 里的长文本不该挤成一行,@UI.multiLineText 如何让描述字段真正拥有多行语义

最近在做 SAP Fiori Elements 页面时,有一类字段很容易被低估。数据库里看起来只是一个普通字符串,OData 服务里看起来也只是一个普通 Property,可一旦真正放到业务页面上,问题就来了。

产品描述、采购备注、销售订单客户说明、审批意见、维修记录、拒绝原因,这些内容和产品编号、公司代码、币种、状态完全不是一类数据。

产品编号可能只有十几个字符,放进普通的Input很自然。订单描述却可能有几百个字符,甚至包含人工输入的换行。如果仍然让 Fiori Elements 把它当成单行字段处理,结果通常很别扭。编辑时只能看到一小截内容,需要不断左右移动光标。显示时大段文字挤在狭窄区域里,业务人员很难快速阅读。字段的数据没有错,OData 服务也没有错,真正缺失的是一层 UI 语义。

SAP 为这个问题准备的方案非常直接,就是@UI.multiLineText

SAP RAP 官方文档对这个注解给出的定位很明确。一个字段被@UI.multiLineText标记后,它应该由支持多行文本输入的 UI 控件呈现,典型控件就是 Text Area。这个注解的作用范围是元素级,也就是直接描述某一个 CDS Element 的 UI 属性。

原始代码非常短。

... define view Product as select from ... { @UI.identification: [ { position: 10 } ] key ProductID, @UI.identification: [