DIV CSS 佈局教程網

JavaScript 實例教學(19):在 HotMetal Pro 6.0 裡寫腳本(5)
編輯:關於JavaScript     

寫一個檢查最後修改時間的巨集

本節要做的是:檢查檔案是否已被 HotMetal 以外的程式改動過。這個機制由三個巨集串成:On_Document_Open_Complete、On_Document_Activate 與 On_Application_Activate。前面提過,這些名稱是預定義的,不能更改——名稱本身就指定了觸發事件的時機,這種事件與巨集的關聯是隱含的,無法透過任何設定改寫。

文件開啟完成時

<MACRO name="On_Document_Open_Complete" lang="JScript"><![CDATA[

var name = ActiveDocument.LocalFullName;

if (Application.ReadableFileExists(name)) { // 若文件從未儲存過,什麼也不做
  Application.Run("On_Document_Save");
}

]]></MACRO>

先取出當前檔案的路徑(ActiveDocument.LocalFullName),檢查該檔案是否可讀;接著執行 On_Document_Save 巨集。這裡的邏輯是:新建立、還沒存檔的文件沒有磁碟上的版本可比對,所以直接跳過。

記錄時間戳

<MACRO name="On_Document_Save" lang="JScript"><![CDATA[

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile(ActiveDocument.LocalFullName);
var mod = Date.parse(f.DateLastModified);
var props = ActiveDocument.CustomDocumentProperties;

if (props.count != 0) {
  props.Add("LastMod", mod);
}

]]></MACRO>

這個巨集示範了 ActiveX 元件的使用方式:new ActiveXObject("Scripting.FileSystemObject") 建立微軟腳本庫的 FileSystemObject。接著 fso.GetFile(name) 取得磁碟上的檔案物件,再從 DateLastModified 屬性取出最後修改時間並用 Date.parse 轉成毫秒數。

然後透過 ActiveDocument 的 CustomDocumentProperties 屬性建立一個自訂屬性集合,並用名為 "LastMod" 的屬性把這個時間戳存進文件本身。也就是說,時間戳不是存在外部檔案裡,而是伴隨文件走——這是個聰明的設計。

文件被啟動時比對

<MACRO name="On_Document_Activate" lang="JScript" id="44" desc="Runs Macro: Hide_On_Document_Activate"><![CDATA[

// 只處理本地文件
if (ActiveDocument.FullName == ActiveDocument.LocalFullName) {
  var name = ActiveDocument.LocalFullName;
  if (Application.ReadableFileExists(name)) {
    var fso = new ActiveXObject("Scripting.FileSystemObject");
    var f = fso.GetFile(name);
    var newMod = Date.parse(f.DateLastModified);
    var props = ActiveDocument.CustomDocumentProperties;
    if (props.count != 0) {
      oldMod = props.Item("LastMod").value;
      if (oldMod != newMod) {
        var Yes = 6;
        var No = 7;
        var msg = "The disk version of this document has changed from the\n";
        msg += "version in memory. Do you want to re-open the document?";
        var ret = Application.MessageBox(msg, 36, "Document Changed");
        if (ret == Yes) {
          ActiveDocument.Reload();
        }
      }
    }
  }
}

]]></MACRO>

這個巨集在文件被切換到前景時執行。它比對磁碟上檔案的修改時間與記憶體中記錄的時間戳,若兩者不同就提示使用者。

幾個細節值得注意。開頭的 if (ActiveDocument.FullName == ActiveDocument.LocalFullName) 是為了排除遠端檔案——只有本地檔案才有可靠的磁碟時間可比。Application.MessageBox 的第二個參數 36 是「是/否」按鈕加上問號圖示的組合常數,回傳值用 6 代表 Yes、7 代表 No。若使用者選擇重新載入,就呼叫 ActiveDocument.Reload()。

這整套機制的價值在於解決一個真實的協作問題:多人或跨工具編輯同一個檔案時,你可能正在編輯一個已經過時的版本,而不自知。自動偵測並提示,能避免大量白工與覆蓋他人修改的風險。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved