SAPUI5 (11) - 数据绑定之属性绑定 (Property binding)

数据绑定指将 Model 的数据绑定到 UI,如果是双向绑定 (two-way binding),则任何一方的变化会反映在另外一方; 如果是单向绑定 (one-way binding),则方向是从 Model 到 UI,即 Model 数据的变化会反映在 UI,但 UI 的变化不会自动到 Model,需要手工提交。

我们先以一个例子来看一看绑定后的效果。页面上有两个控件: sap.m.Textsap.m.Inputsap.m.Input 用于输入, sap.m.Text 用于显示 sap.m.Input 输入变更后,与 sap.m.Input 同步的数据。

数据

数据来自 json 文件,包含两个供应商主数据的基本信息。

{
    "Suppliers": [
        {
            "ID" : 1,
            "Name" : "Exotic Liquids",
            "Address": {
                "Street": "NE 228th",
                "City": "Sammamish",
                "State": "WA",
                "ZipCode": "98074",
                "Country": "USA"
            }
        },
        {
            "ID" : 2,
            "Name" : "Tokyo Traders",
            "Address": {
                "Street": "NE 40th",
                "City": "Redmond",
                "State": "WA",
                "ZipCode": "98052",
                "Country": "USA"
            }
        }
    ]
}

index.html

<!DOCTYPE HTML>
<html>
    <head>
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta http-equiv='Content-Type' content='text/html;charset=UTF-8'/>

        <script src="resources/sap-ui-core.js"
                id="sap-ui-bootstrap"
                data-sap-ui-libs="sap.m, sap.ui.layout"
                data-sap-ui-theme="sap_bluecrystal"
                data-sap-ui-compactVersion="Edge"
                data-sap-ui-bindingSyntax="Complex">
        </script>       
        
        <!-- application area -->
        <script src="jscode/app1.js">           
        </script>

    </head>
    <body class="sapUiBody sapUiResponsiveMargin" role="application">
        <div id="content"></div>
    </body>
</html>

将代码文件写在app1.js中,这样index.html就可以保持不变。

app1.js

/**
 * openui5 application area
 */

sap.ui.getCore().attachInit(function() {
    // application data
    var oModel = sap.ui.model.json.JSONModel();
    oModel.loadData("models/suppliers.json");   

    sap.ui.getCore().setModel(oModel);
    
    var oText = new sap.m.Text({text: "{/Suppliers/0/Name}"});
    var oInput = new sap.m.Input({value: "{/Suppliers/0/Name}"});
    
    oText.placeAt("content");
    oInput.placeAt("content");
});

将json数据的第一个供应商name同时绑定到sap.m.Input的value属性和sap.m.Text的Text属性,这样,当Input的value改变时,Text的text属性也随之改变。

属性绑定的方法

  • 在构造器的setting中设置(如上面的示例)
  • bindProperty()方法
  • 控件的bindXXX()方法

sap.ui.base.ManagedObject类提供bindProperty()方法,因为控件都继承自ManagedObject,所以可以利用这个方法绑定数据。

语法:bindProperty(sName, oBindingInfo): [sap.ui.base.ManagedObject]

Bind a property to the model. The Setter for the given property will be called with the value retrieved from the data model. This is a generic method which can be used to bind any property to the model. A managed object may flag properties in the metamodel with bindable="bindable" to get typed bind methods for a property. A composite property binding which may have multiple paths (also known as Calculated Fields) can be declared using the parts parameter. Note a composite binding is read only (One Way).

注意方法的第二个参数是一个object类型的对象,称为binding information,包括path, model, formatter等信息。

比如刚才对sap.m.Text的text属性绑定,可以这样写:

var oText = new sap.m.Text();
oText.bindProperty("text", "/Suppliers/0/Name");

如果要明确指定使用单向绑定:

var oText = new sap.m.Text();
oText.bindProperty("text", {
    path: "/Suppliers/0/Name",
    mode: sap.ui.model.BindingMode.OneWay
});

使用unbindProperty()方法解绑。

bindProperty是一个通用的方法(generic method),对于具体的控件来说,还会提供bindXXX方法和unbindXXX方法(XXX为属性名)。以sap.m.Text来说,提供了bindText()unbindText()方法。sap.m.Input来说,提供了bindValue()unbindValue()方法:

var oText = new sap.m.Text();
oText.bindText("/Suppliers/0/Name");

var oInput = new sap.m.Input();
oInput.bindValue("/Suppliers/0/Name");

绑定路径及复杂绑定

最后给出一个显示供应商及地址的代码,注意以下要点:

  1. 属性绑定的路径
  2. 供应商地址使用复杂绑定(complex binding)的写法
  3. 使用sap.m.Panel控件实现布局(layout)

页面显示第一个供应商的信息,界面如下:

项目文件结构如下:

index.html

<!DOCTYPE HTML>
<html>
    <head>
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta http-equiv='Content-Type' content='text/html;charset=UTF-8'/>

        <script src="resources/sap-ui-core.js"
                id="sap-ui-bootstrap"
                data-sap-ui-libs="sap.m, sap.ui.layout"
                data-sap-ui-theme="sap_bluecrystal"
                data-sap-ui-compactVersion="Edge"
                data-sap-ui-preload="async"
                data-sap-ui-bindingSyntax="complex"
                data-sap-ui-resourceroots='{"stone.demo": "./"}'>
        </script>       
        
        <!-- application area -->
        <script src="jscode/app_supplier_info.js">              
        </script>

    </head>
    <body class="sapUiBody" role="application">
        <div id="content"></div>
    </body>
</html>

Application area代码写在app_supplier_info.js中,注意bootstrap中增加了data-sap-ui-bindingSyntax="complex"声明,表示需要使用复杂绑定的语法。所谓复杂绑定,就是在控件中,可以对绑定的数据进行计算,比如说,西方的地址包括street, city, zip code, state, country等,我们使用一个控件来显示这些信息。如果没有这句申明,数据就会显示不出来。

app_supplier_info.js

/**
 * openui5 application area
 * show supplier information
 * 
 * Written by Stone Wang on Jan 08, 2017
 */

sap.ui.getCore().attachInit(function() {                
    
    // application data
    var oModel = sap.ui.model.json.JSONModel();
    oModel.loadData("models/suppliers.json");   

    sap.ui.getCore().setModel(oModel);      

    sap.ui.xmlview({
        viewName: "stone.demo.view.supplier_info"
    }).placeAt("content");  

});

supplier_info.view.xml

<core:View xmlns:core="sap.ui.core" 
           xmlns:mvc="sap.ui.core.mvc" 
           xmlns:l="sap.ui.layout"
           xmlns="sap.m"
           xmlns:html="http://www.w3.org/1999/xhtml">
    
    <Panel headerText="供应商信息" class="sapUiResponsiveMargin" width="auto">
        <content>
            <Text text="Supplier Id:" class="sapUiSmallMargin" />
            <Text text="{/Suppliers/0/ID}" width="5px" class="sapUiSmallMargin" />
            <Text text="Supplier name:" class="sapUiSmallMargin" />
            <Text text="{/Suppliers/0/Name}" width="100px" class="sapUiSmallMargin" />
        </content>
    </Panel>
    
    <Panel class="sapUiResponsiveMargin" width="auto">
        <content>
            <l:VerticalLayout>
                <Label text="Address:" class="sapUiSmallMargin" />
                <Text text="{/Suppliers/0/Address/Street}, \n
                            {/Suppliers/0/Address/ZipCode} {/Suppliers/0/Address/City}, \n
                            {/Suppliers/0/Address/State}, {/Suppliers/0/Address/Country}"  
                      class="sapUiSmallMargin" />
            </l:VerticalLayout>
        </content>
    </Panel>
    
</core:View>

地址使用的是复杂绑定:

<Text text="{/Suppliers/0/Address/Street}, \n
            {/Suppliers/0/Address/ZipCode} {/Suppliers/0/Address/City}, \n
            {/Suppliers/0/Address/State}, {/Suppliers/0/Address/Country}"  
    class="sapUiSmallMargin" />
  • 供应商信息使用两个sap.m.Panel来显示。
  • 在地址中,有换行\n和逗号,通过复杂绑定,实现了一个控件显示地址中Street, City, Zip code, State, Country等多个信息,并且按西方地址的习惯多行显示。
  • 在控件的class属性中,Panel用sapUiResponsiveMargin,其他控件用sapUiSmallMargin,页面更加美观。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,602评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,442评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,878评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,306评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,330评论 5 373
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,071评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,382评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,006评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,512评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,965评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,094评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,732评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,283评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,286评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,512评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,536评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,828评论 2 345

推荐阅读更多精彩内容