[转]关于event的两个常被忽略的api：isDefaultPrevented()和preventDefault()

今天在robert penner（as3 singal的作者）的一篇blog文中顺藤摸瓜到了darron schall的另外一篇blog文(Creating Default, Cancelable Event Handlers)，仔细看了一下，忽然有种相见恨晚的感觉。

 

确实是啊~rober penner的singal我不是第一天就知道了，之后再arpg的demo里面也有用过，只可惜今天才认真看了一下penner的这篇文章，也很可惜在schall发布这个文章的两年后才看到，真遗憾

 

好了，下面来谈谈这两个api的官方documentation描述：

 

preventDefault

public function preventDefault():void

如果可以取消事件的默认行为，则取消该行为。

许多事件都有默认执行的关联行为。例如，如果用户在文本字段中键入一个字符，则默认行为就是在文本字段中显示该字符。 由于可以取消 TextEvent.TEXT_INPUT 事件的默认行为，因此您可以使用 preventDefault() 方法来防止显示该字符。

不可取消行为的一个示例是与 Event.REMOVED 事件关联的默认行为，只要 Flash Player 从显示列表中删除显示对象，就会生成该事件。 由于无法取消默认行为（删除元素），因此 preventDefault() 方法对此默认行为无效。

您可以使用 Event.cancelable 属性来检查是否可以防止与特定事件关联的默认行为。 如果 Event.cancelable 的值为 true，则可以使用 preventDefault() 来取消事件；否则，preventDefault() 无效。

 

另请参见

flash.events.Event.isDefaultPrevented()
Event.cancelable

 

isDefaultPrevented

()

方法

public function isDefaultPrevented():Boolean

检查是否已对事件调用 preventDefault() 方法。如果已调用 preventDefault() 方法，则返回 true；否则返回 false。

另请参见

flash.events.Event.preventDefault()

 

关于api的作用我解析不够权威，所以粘贴了官方文档，而我对schall的文章例子也不是非常感兴趣，所以我举一个我以前用到的实战例子，怎么实现文本输入限制字数的功能

 

当然,as3 api的textfeidl提供了一个maxChars的api，不过这个中看不中用大家也知道的~

 

以前我的实现方法是

监听textfield的TextEvent.TEXT_INPUT事件和Event.CHANGE事件:

input事件触发时，判断一下当前是否合法（超出长度），没有超出长度则保存一个合法的字符串

change事件触发时，判断一下新的字符是否合法，不合法的话，替换回原来保存的合法字符串

如下：

private function init():void {
   _inputTf = new TextField();
   _inputTf.width = 100;
   _inputTf.border = true
   _inputTf.type = TextFieldType.INPUT;

   _inputTf.addEventListener(TextEvent.TEXT_INPUT, onTextInput);
   _inputTf.addEventListener(Event.CHANGE, onChange);

   this.addChild(_inputTf);
  }

  private function onTextInput(event:TextEvent):void {
   if (StringUtils.checkStringNum(_inputTf.text) <= 6) {
    _tempStr = _inputTf.text;
   }
  }

  private function onChange(event:Event):void {
   var curNum:int = StringUtils.checkStringNum(_inputTf.text);
   if (curNum > 6) {
    _inputTf.text = _tempStr;
   }
  }

 

现在发现textinput这个事件的cancelable是为true的，则表明可以通过preventDefault来取消默认行为（textfield的默认行为是显示文字），于是，新的处理方法为：

 

private function init():void {
   _inputTf = new TextField();
   _inputTf.width = 100;
   _inputTf.border = true
   _inputTf.type = TextFieldType.INPUT;

   _inputTf.addEventListener(TextEvent.TEXT_INPUT, onTextInput2);

   this.addChild(_inputTf);
  }

  private function onTextInput2(event:TextEvent):void {
   if (StringUtils.checkStringNum(_inputTf.text + event.text) > 6) {
    event.preventDefault();
    //这里也可以添加一些截取文本的逻辑，例如拷贝进来10个字符，截掉其中的6个
   }
  }

 

现在就一个事件处理器就能解决，而且StringUtils.checkStringNum方法也少调用一次了，非常不错~

 

btw：关于isDefaultPrevented ()这个api的使用，可以看schall的例子，多数用于我们自定义自己默认的事件行为的实现上有应用到，而且发出来的事件也要把cancelable设置为true

 

 

扩展一下：

 

1.EventDispatcher.dispatchEvent()这个api是有个Boolean的返回值的

返回

Boolean — 如果成功调度了事件，则值为 true。 值 false 表示失败或对事件调用了 preventDefault()。

这篇文章的应用思想不错，check it out

 

2.常用的可以取消的事件有(cancelable为true):

FocusEvent.MOUSE_FOCUS_CHANGE
FocusEvent.KEY_FOCUS_CHANGE

TextEvent.TEXT_INPUT