理解 Flex itemRenderer - 第 3 部分: 通信

原文地址：http://www.adobe.com/cn/devnet/flex/articles/itemrenderers_pt3.html

 

在本系列的第 2 部分中, 我向您展示了如何使用 MXML 和 ActionScript 创建外部 itemRenderer。在我用过的示例中, 有一个调度自定事件 BuyBookEvent 的 Button－这样应用程序可以对它作出响应。本文进一步讨论与 itemRenderer 的通信。

我坚信有一条规则是永远不能违背的: 不能抓住 itemRenderer 的实例不放, 更改它 (设置公共属性) 或调用它的公共方法。这对我而言是一个禁忌。itemRenderer 是很难弄清的, 我在第 1 部分中说到了其中的缘由: itemRenderer 是循环使用的。抓住一个会破坏 Flex 框架。

请将这条规则谨记在心, 您可以使用 itemRenderer 完成以下操作:

• itemRenderer 可以通过它的列表所有者调度事件。 (您已经看到过冒泡; 这个做法更好, 接下来您就会看到。)
• itemRenderer 可以使用静态类成员。其中包括 Application.application。如果您的值“全局”存储在应用程序对象中, 您可以通过这种方式获得它们。
• itemRenderer 可以使用拥有它的列表的公共成员。接下来您就会看到。
• itemRenderer 可以使用数据记录中的任何内容。例如, 记录中的某个项目不用于直接显示, 但它却影响 itemRenderer 的行为方式。

本系列包含以下文章:

• 第 1 部分: 内联渲染器
• 第 2 部分: 外部渲染器
• 第 3 部分: 通信
• 第 4 部分: 状态和过渡
• 第 5 部分: 效率

要求

为了充分利用本文, 您需要以下软件和文件:

Flex Builder 3

必要条件

要从本文中受益, 您最好熟悉 Flex Builder 和 ActionScript 3.0。

动态更改 itemRenderer

以下是上一篇文章中用于 TileList 的 MXML itemRenderer。我将使它对外部源 (我将这个文件称为 BookItemRenderer.mxml) 的更改作出反应, 从而使它更生动:

<?xml version="1.0" encoding="utf-8"?>
<mx:HBox xmlns:mx="http://www.adobe.com/2006/mxml" width="250" height="115" >
	
	<mx:Script>
	<!--[CDATA[		
	]]>
	</mx:Script>
	
	<mx:Image id="bookImage" source="{data.image}" />
	<mx:VBox height="115" verticalAlign="top" verticalGap="0">
		<mx:Text text="{data.title}" fontWeight="bold" width="100%"/>
		<mx:Spacer height="20" />
		<mx:Label text="{data.author}" />
		<mx:Label text="Available {data.date}" />
		<mx:Spacer height="100%" />
		<mx:HBox width="100%" horizontalAlign="right">
			<mx:Button label="Buy" fillColors="[0x99ff99,0x99ff99]">
				<mx:click>
				<![CDATA[
					var e:BuyBookEvent = new BuyBookEvent();
					e.bookData = data;
					dispatchEvent(e);
				]]-->
				</mx:click>
			</mx:Button>
		</mx:HBox>
	</mx:VBox>
</mx:HBox> 

假设您在 TileList 中显示一个商品目录。您还有一个 Slider (不属于 itemRenderer), 它允许用户给出一个价格范围; 在此范围之外的所有商品应变灰 (itemRenderer 的 alpha 值应改变)。您需要告知所有 itemRenderer 标准已改变, 这样它们可以修改自己的 alpha 值。

覆盖 set data 可能如下:

override public function set data( value:Object ) : void
{
    super.data = value;
    if( data.price < criteria ) alpha = 0.4;
	else alpha = 1;
} 

问题是: 如何更改标准值？itemRenderer 的“最佳做法”是始终让它们处理为自己手头的数据。在本例中, 将测试标准作为数据的一部分不可能也不切实际。所以这在数据外留下了一个位置。您有两个选择:

• 列表本身的一部分。即, 您的列表 (List、DataGrid、TileList 或其他) 可以是扩展列表控制并且将这个标准作为公共成员的类。
• 作为全局数据的应用程序的一部分。

我选择第一个: 扩展一个类并将这个标准作为该类的一部分。毕竟, 这个类将用于显示数据, 而标准是显示内容的一部分。对于本例, 我将扩展 TileList 并将标准作为公共数据成员。

package
{
	
	import mx.controls.TileList;
	
	public class CatalogList extends TileList
	{
		public function CatalogList()
		{
			super();
		}
		
		private var _criteria:Number = 10;
		
		public function get critera() : Number
		{
			return _criteria;
		}
		
		public function set criteria( value:Number ) : void
		{
			_criteria = value;
		}		
	}
} 

这个办法是, itemRenderer 外的控制可以通过更改列表控制上的这个属性来修改标准。

listData

itemRenderer 可以访问另一块数据: 列表本身的相关信息以及它们渲染哪个行哪个列 (如果在面向列的控制中)。这称为 listData, 在 BookItemRenderer.mxml itemRenderer 示例中可以这样使用它:

override public function set data( value:Object ) : void
{
    super.data = value;
    var criteria:Number = (listData.owner as MyTileList).criteria;
    if( data.price < criteria ) alpha = 0.4;
else alpha = 1;
} 

将这个代码放入上述示例 BooktItemRenderer.mxml 代码的 <mx:Script> 块中。

itemRenderer 的 listData property 有一个 owner 字段, 它是 itemRenderer 所属的控制。在本例中, 所有者是 MyTileList 控制－我的 TileList 扩展。将所有者字段转换为 MyTileList 即可取走标准。

IDropInListItemRenderer

当 itemRenderer 类实施 IDropInListItemRenderer 接口时, 即可访问 listData。不幸的是, UI 容器组件不实施提供 listData 访问权的接口。Button 和 Label 等控制组件提供这一访问权, 但对于容器, 您必须自己实施接口。

实施这个接口很简单, 您可以在 Flex 文档中找到说明。您必须为 BookItemRenderer 类执行以下操作:

1. 由类实施接口。

   <mx:HBox xmlns:mx="http://www.adobe.com/2006/mxml" ...
   implements="mx.controls.listClasses.IDropInListItemRenderer"> 

2. 将 set 和 get 函数添加到 itemRenderer 文件的 <mx:Script> 块。

   import mx.controls.listClasses.BaseListData;
   
       private var _listData:BaseListData;
       public function get listData() : BaseListData
       {
       return _listData;
       }
       public function set listData( value:BaseListData ) : void
       {
       _listData = value;
       } 

当列表控制看到 itemRenderer 实施 IDropInListItemRenderer 接口时, 它将创建一个 listData 项目并将它指派到每个 itemRenderer 实例。

invalidateList()

在我的类中设置这个标准并不像指派值这么简单。那样做无法告知 Flex 框架数据已更改。标准更改必须触发一个事件。以下是对 set criteria() 函数的修改内容:

public function set criteria( value:Number ) : void
		{
			_criteria = value;
			
			invalidateList();
		} 

注意, 一旦设置 _criteria 值, 它会调用 invalidateList()。这将使用 dataProvider 的值重置所有 itemRenderer 并调用它们的 set data 函数。

随后的流程如下:

1. itemRenderer 在它的列表所有者中查找要使用的标准, 以帮助它决定如何渲染数据。
2. 列表所有者类是某个 Flex 列表类的扩展, 它包含 itemRenderer 读取以及外部代码－另一个控制或 ActionScript 代码 (可能是从远程调用接收数据产生的) 设置的公共属性。
3. 设置列表属性时, 它调用列表的 invalidateList() 方法。这触发了 itemRenderer 刷新, 使它们重置自己的数据 (并返回第 1 步)。

活动

在之前的文章中, 我向您展示了如何借助事件冒泡使 itemRenderer 与应用程序的其余部分通信。我认为这相当快。但我认为还有更好的方法, 它符合 itemRenderer 负责展示数据、控制负责处理数据的想法。

MyTileList 控制的构思是, 它是可售书籍目录的可见视图。当用户选中一本书籍并要购买它时, 列表控制应当将这个信息发送给应用程序。换言之:

<CatalogList bookBuy="addToCart(event)" />

万事俱备, 事件冒泡并跳过 MyTileList。冒泡方法没有将事件 (bookBuy) 与列表控制 (MyTileList) 关联在一起, 允许您将控制移到应用程序的其他部分。例如, 如果您在主 Application 中写入 bookBuy 的事件侦听器, 您无法将列表控制移到应用程序的其他部分。如果要移动, 您还得移动那个事件处理函数。另一方面, 如果您将事件与控制关联在一起, 只是移动控制。

我们这样看: 假设 Button 上的单击事件并不是 Button 调度的事件, 但由于按钮中的某个内容而冒泡。您将无法使用: <mx:Button click="doLogin()" label="Log in" />; 您必须将 doLogin() 函数放在其他位置, 这会使应用程序更难使用。

希望我已经说服您, 以下是如何将这个示例从冒泡更改为从列表控制调度。

1. 将元数据添加到 CatalogList 控制, 告知编译器控制负责调度事件:

   import events.BuyBookEvent;
   	import mx.controls.TileList;
   
   	[Event(name="buyBook",type="events.BuyBookEvent")]
   	
   	public class CatalogList extends TileList
   	{​ 

2. 将一个函数添加到 CatalogList 进行事件调度。itemRenderer 实例将调用这个函数:

   public function dispatchBuyEvent( item:Object ) : void
   		{
   			var event:BuyBookEvent = new BuyBookEvent();
   			event.bookData = item;
   			dispatchEvent( event );
   		}
   		
   	} 

3. 将 itemRenderer 中的 Buy 按钮代码更改为调用该函数:

   <mx:Button label="Buy" fillColors="[0x99ff99,0x99ff99]">
       <mx:click>
       <!--[CDATA[
           (listData.owner as CatalogList).dispatchBuyEvent(data);
       ]]-->
       </mx:click>
       </mx:Button> 

现在, itemRenderer 中的 Button 可以使用记录数据 (或适合此操作的其他任何内容) 轻松调用列表控制中的函数, 并将与应用程序其余部分协调的职责转交给列表控制。

本例中的列表控制使用数据调度事件。应用程序可以使用 ActionScript 为这个事件添加事件侦听器, 也可以使用 MXML (因为 CatalogList.as 文件中的 [Event] 元数据) ; 使用 [Event] 元数据使开发人员能更轻松地使用您的代码。

后续工作

itemRenderer 应使用事件进行任何操作通信。自定事件允许您将信息随事件传递, 这样事件使用者无需再通过 itemRenderer 获取数据。

itemRenderers 应通过覆盖它们的 set data 函数对数据更改作出“反应”。在该函数中, 它们可以访问其 listData.owner 中的值。它们还可以访问存储在静态类或通过 Application.application 存储在主应用程序中的数据。

在下一篇文章中, 我们将讨论如何将状态并入 itemRender 中。

关于作者

Peter Ent 是 Adobe 的一名计算机科学家，目前正在进行 Genesis 项目。在此之前，Peter 担任过 Adobe 客户关怀的 Flex 支持工程师以及技术客户经理。加入 Adobe 之前，Peter 曾在 State Street and Fidelity Investments 的金融服务行业工作。他还在两家新成立的公司构建过用于成像和分子建模的软件应用程序。Peter 获得美国雪城大学的计算机科学理科学士学位。访问 Peter 的博客*。