代码之家  ›  专栏  ›  技术社区  ›  Amarghosh

使用带可绑定metatag和mxml的ASDoc

  •  2
  • Amarghosh  · 技术社区  · 15 年前

    我正在使用ASDoc创建flex项目的文档,但是在bindable metatag方面有一些问题。

    • public Bindable

    例如:

    //This is documented correctly
    [Bindable("someEvent")]
    /*
    * public bindable with event name
    * */
    public var test1:String;
    
    //This is not documented at all
    [Bindable]
    /*
    * public bindable without event name
    * */
    public var test2:String;  
    
    • ASDoc在 protected Bindable 值(如果可绑定标记没有关联的事件名称)。

    //This is documented correctly as test3  
    [Bindable("someEvent")]  
    /*  
    * protected bindable with event name  
    * */  
    protected var test3:String;  
    
    //But this is documented as _110251490test4  
    [Bindable]  
    
    /*  
    * protected bindable without event name  
    * */  
    protected var test4:String;
    

    总而言之,ASDoc并不满意 Bindable 没有事件名称的标记。看起来,最简单的解决方案是在声明可绑定的内容时指定事件名。但是 flex docs say that

    全部替换 [Bindable] 实例 [Bindable("blah")] 在生成asdoc之前,然后将它们改回来是我唯一能想到的解决方法。但我觉得应该有更好的办法。

    土砖 bug tracker

    有人能解释一下这个问题吗?

    Adobe blog says ASDoc现在也支持mxml,但是当我尝试使用最新的(flex3.4)ASDoc时,我的mxml ASDoc注释(嵌入在中)没有出现在生成的html页面中。有人知道最新的asdoc是否可以单独下载?

    2 回复  |  直到 15 年前
        1
  •  1
  •   Richard Szalay    15 年前

    虽然我不能帮助您解决问题,但问题是[Bindable](没有事件名)围绕属性生成包装代码(我相信是一个单独的属性)。这段代码显然在扰乱asdoc。

        2
  •  0
  •   Gregor Kiddie    15 年前

    你没有提供任何Jira号码来检查,但是。。。

    推荐文章