MagicAjax - 糟糕的文档不如不写文档

昨天下了MagicAjax0.2.2-release看了看Example觉得还算不错，打开MA跟随的Docs看了看，然后打开VS2005准备操刀一下。

因为使用MA的无刷新效果总是在浏览器的可见客户区的右上角出现一个Loading ...的提示条，但自己觉得颜色不是很好看，想改一下，发现MA是把scripts都搞到dll里去了，然后通过实现httpModules把scripts再Export出来，具体是在编译时生成一个WebResource.axd(在运行时才动态生成)。可是自己想改script，看看文档的Configuration一节

ScriptPath

Type: string
Default: null (omitted)
Description: MagicAjax's script files are embedded in the dll and are put on page using script tags like this: 

    <script type="text/javascript" src="AjaxCallObject.js.aspx"></script>
If you set ScriptPath to a value, the src attribute of the script tag will contain the path of ScriptPath. That way you can use your own modified versions of MagicAjax's script files. Example: 
    <magicAjax ScriptPath="~/script" />

在Core里找到script文件夹，添加到工程目录里，然后按照文档设置web.config文件，再把AjaxCallObject.js中的

function CreateWaitElement() {
    var elem = document.getElementById('__AjaxCall_Wait');    
    if (!elem) {        
        elem = document.createElement("div");
        elem.id = '__AjaxCall_Wait';        
        elem.style.position = 'absolute';        
        elem.style.height = 17;        
        elem.border = "1px";
        elem.style.paddingLeft = "3px";
        elem.style.paddingRight = "3px";
        elem.style.fontSize = "11px";
        elem.style.borderColor = "#ffffff";
        elem.style.borderSize = "1px";
        elem.style.backgroundColor = "DimGray";
        elem.style.color = "#ffffff";
        elem.innerHTML = 'Loading ';
        elem.style.visibility = 'hidden';        
        document.body.insertBefore(elem, document.body.firstChild);        
    }
    waitElement = elem;    
}

一段代码做一些修改，比如elem.style.color="#000000";这样再出现Loading ...时字体应该是黑的了吧？
嘿，这一运行，还真没成功！！！

肯定不是script的错！玩了N的js，再把这搞错也太说不过去了！

判断问题出现在config里。

<?xml version="1.0"?>
<configuration>
    <configSections>
        <section name="magicAjax" type="MagicAjax.Configuration.MagicAjaxSectionHandler, MagicAjax"/>
    </configSections>
    <magicAjax ScriptPath="~/script">
        <pageStore/>
    </magicAjax>
    <system.web>
        <authentication mode="Forms" />
..
        <httpModules>
            <add name="MagicAjaxModule" type="MagicAjax.MagicAjaxModule, MagicAjax"/>
        </httpModules>
    </system.web>
</configuration>

路径没问题，XML大小写敏感，拼写都是按文档写的，没问题，靠，Where？

最后，幸好MA开源的，找到MA的代码工程，打开一看：靠，靠，靠！
看到MagicAjaxConfiguration.cs

        public MagicAjaxConfiguration(XmlNode xml)
        {
            // Default values
            _scriptPath = null; // Null implicates that the embedded javascripts will be used (default)
            _compareMode = OutputCompareMode.HashCode;
            _tracing = false;
            PageStoreMode mode = PageStoreMode.NoStore;
            bool unloadStoredPage = false;
            int cacheTimeout = 5;
            int maxPages = 5;
            bool maxPagesLimitAlert = false;

            if (xml != null)
            {
                XmlAttribute attrib = (XmlAttribute)xml.Attributes.GetNamedItem("scriptPath");

倒，是scriptPath呀！！！
又看看文档，它真的是写的<magicAjax ScriptPath="~/script" />不是我的错！！！


该死的文档，不如不写！！！

准备，好好研究下MA的代码，因为昨晚发现把Loading改称中文出来的是乱码，是编码格式的问题。
如果，在浏览时把编码改为“简体中文”这样Loading条就正常显示了，可是页面其他中文都乱码了，应该把MA的Encoding改了。太晚了……就睡了，今天下午看看有时间的话来搞它！

我以后要么不写文档，写就负责任的写！