第23步:自定义格式器

自定义格式器实现数据模型属性的本地化

最新推荐文章于 2023-09-19 17:36:37 发布

翻译最新推荐文章于 2023-09-19 17:36:37 发布 · 233 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://sapui5.hana.ondemand.com/#/topic/0f8626ed7b7542ffaa44601828db20de

SAPUI5 专栏收录该内容

40 篇文章

订阅专栏

说明

如果我们想用更复杂的逻辑来格式化数据模型的属性，我们还可以编写自定义格式化函数。现在，我们将使用自定义格式化程序添加本地化状态，因为数据模型中的状态是一种技术性很强的格式。

预览

在这里插入图片描述

状态现在用自定义格式化程序显示了

代码

你可以在演练-第23步查看和下载所有文件。

webapp/model/formatter.js (New)

sap.ui.define([], function () {
	"use strict";
	return {
		statusText: function (sStatus) {
			var resourceBundle = this.getView().getModel("i18n").getResourceBundle();
			switch (sStatus) {
				case "A":
					return resourceBundle.getText("invoiceStatusA");
				case "B":
					return resourceBundle.getText("invoiceStatusB");
				case "C":
					return resourceBundle.getText("invoiceStatusC");
				default:
					return sStatus;
			}
		}
	};
});

我们在应用程序项目中创建一个新的文件夹model。新的格式化程序文件被放置在应用程序的model文件夹中，因为格式化程序正在处理数据属性并格式化它们以便在UI上显示。到目前为止，我们还没有任何模型相关的工件，除了Invoices.json文件，我们现在将webapp/model文件夹添加到我们的应用程序中。这一次，我们没有从任何基对象扩展，只是返回一个JavaScript对象，其中包含sap.ui.define调用中的格式化器函数。

函数statusText从数据模型获取技术状态作为输入参数，并返回从resourceBundle文件读取的人类可读的文本。

webapp/controller/InvoiceList.controller.js
在这里插入图片描述

sap.ui.define([
	"sap/ui/core/mvc/Controller",
	"sap/ui/model/json/JSONModel",
	"../model/formatter"
], function (Controller, JSONModel, formatter) {
	"use strict";
	return Controller.extend("sap.ui.demo.walkthrough.controller.InvoiceList", {
		formatter: formatter,
		onInit : function () {
			var oViewModel = new JSONModel({
				currency: "EUR"
			});
			this.getView().setModel(oViewModel, "view");
		}
	});
});

要加载格式化程序函数，必须将其添加到InvoiceList.controller.js中。在这个控制器中，我们首先向自定义formatter模块添加一个依赖项。控制器只是将加载的格式化器函数存储在本地属性格式化器中，以便能够在视图中访问它们。

webapp/view/InvoiceList.view.xml
在这里插入图片描述

<mvc:View
	controllerName="sap.ui.demo.walkthrough.controller.InvoiceList"
	xmlns="sap.m"
	xmlns:mvc="sap.ui.core.mvc">
	<List
			headerText="{i18n>invoiceListTitle}"
		class="sapUiResponsiveMargin"
		width="auto"
		items="{invoice>/Invoices}">
		<items>
			<ObjectListItem
				title="{invoice>Quantity} x {invoice>ProductName}"
				number="{
					parts: [{path: 'invoice>ExtendedPrice'}, {path: 'view>/currency'}],
					type: 'sap.ui.model.type.Currency',
					formatOptions: {
						showMeasure: false
					}
				}"
				numberUnit="{view>/currency}"
				numberState="{=	${invoice>ExtendedPrice} > 50 ? 'Error' : 'Success' }">
				<firstStatus>
					<ObjectStatus text="{
						path: 'invoice>Status',
						formatter: '.formatter.statusText'
					}"/>
				</firstStatus>
			</ObjectListItem>
		</items>
	</List>
</mvc:View>

我们使用firstStatus聚合向objectisttitem添加一个状态，该状态将显示发票的状态。使用绑定语法的预留属性格式化器指定自定义格式化器函数。格式化程序名称前面的 “.” 表示在当前视图的控制器中查找该函数。在那里，我们定义了一个属性formatter，它保存了我们的formatter函数，因此我们可以通过.formatter.statusText访问它。

webapp/i18n/i18n.properties
在这里插入图片描述

# App Descriptor
appTitle=Hello World
appDescription=A simple walkthrough app that explains the most important concepts of SAPUI5

# Hello Panel
showHelloButtonText=Say Hello
helloMsg=Hello {0}
homePageTitle=Walkthrough
helloPanelTitle=Hello World
openDialogButtonText=Say Hello With Dialog
dialogCloseButtonText=Ok

# Invoice List
invoiceListTitle=Invoices
invoiceStatusA=New
invoiceStatusB=In Progress
invoiceStatusC=Done

我们向资源包中添加三个新条目，以反映翻译后的状态文本。这些文本现在根据发票的状态显示在objectistitem的number属性下面。

章节