檢視原始碼就像使用者可以檢視在網頁瀏覽器顯示 HTML 頁面的原始碼,使用者也可以檢視 HTML 類型 AIR 應用程式的原始碼。Adobe® AIR® SDK 包含一個 AIRSourceViewer.js JavaScript 檔案,可加至應用程式中以方便使用者檢視原始碼。 載入、設定和開啟來源檢視器「來源檢視器」程式碼包含在 JavaScript 檔案 AIRSourceViewer.js 中,該檔案位於 AIR SDK 架構目錄內。若要在應用程式中使用「來源檢視器」,請將 AIRSourceViewer.js 複製至應用程式專案目錄,然後在應用程式的主要 HTML 檔案中使用指令碼標籤載入該檔案: <script type="text/javascript" src="AIRSourceViewer.js"></script> AIRSourceViewer.js 檔案定義一個名為 SourceViewer 的類別,您可以從 JavaScript 程式碼中呼叫 air.SourceViewer 來存取該類別。 SourceViewer 類別定義 3 個方法:getDefault()、setup() 和 viewSource()。
備註: 使用「來源檢視器」的程式碼必須位於應用程式安全執行程序中 (在應用程式目錄內的一個檔案中)。
例如,下列 JavaScript 程式碼可實體化「來源檢視器」物件,並開啟「來源檢視器」視窗,其中列出所有原始檔案。 var viewer = air.SourceViewer.getDefault(); viewer.viewSource(); 設定來源檢視器config() 方法可將指定的設定套用至「來源檢視器」。這個方法有一個參數:configObject。configObject 物件具有屬性,用來定義「來源檢視器」的組態設定。這些屬性是 default、exclude、initialPosition、modal、typesToRemove 和 typesToAdd。 default字串指定要顯示在「來源檢視器」中之初始檔案的相對路徑。 例如,下列 JavaScript 程式碼可開啟「來源檢視器」視窗,其中包含 index.html 檔案當做初始顯示的檔案。 var viewer = air.SourceViewer.getDefault(); var configObj = {}; configObj.default = "index.html"; viewer.viewSource(configObj); exclude字串陣列指定要從「來源檢視器」清單排除的檔案或目錄。路徑是相對於應用程式目錄。不支援萬用字元。 例如,下列 JavaScript 程式碼可開啟「來源檢視器」視窗,其中列出 AIRSourceViewer.js 檔案以外的所有原始檔案,以及 Images 和 Sounds 子目錄中的檔案: var viewer = air.SourceViewer.getDefault(); var configObj = {}; configObj.exclude = ["AIRSourceViewer.js", "Images" "Sounds"]; viewer.viewSource(configObj); initialPosition這個陣列包含兩個數字,指定「來源檢視器」視窗的初始 x 和 y 座標。 例如,下列 JavaScript 程式碼會在螢幕座標 [40, 60] (X = 40, Y = 60) 的位置開啟「來源檢視器」視窗。 var viewer = air.SourceViewer.getDefault(); var configObj = {}; configObj.initialPosition = [40, 60]; viewer.viewSource(configObj); modal這個 Boolean 值指定「來源檢視器」是否開啟為強制回應 (true) 或非強制回應 (false) 視窗。依預設「來源檢視器」視窗為強制回應視窗。 例如,下列 JavaScript 程式碼容許使用者同時可以和「來源檢視器」視窗以及任何應用程式視窗互動的方式開啟「來源檢視器」視窗: var viewer = air.SourceViewer.getDefault(); var configObj = {}; configObj.modal = false; viewer.viewSource(configObj); typesToAdd這個字串陣列指定要在預設包含的類型之外,另外加入至「來源檢視器」清單的檔案類型。 依預設「來源檢視器」清單列出下列檔案類型:
typesToExclude這個字串陣列指定要從「來源檢視器」排除的檔案類型。 依預設「來源檢視器」清單列出下列檔案類型:
開啟來源檢視器您應該包含連結、按鈕或選單命令等使用者介面元素,以便當使用者選取時呼叫「來源檢視器」程式碼。例如,下列簡單應用程式會在使用者按一下連結時開啟「來源檢視器」。 <html> <head> <title>Source Viewer Sample</title> <script type="text/javascript" src="AIRSourceViewer.js"></script> <script type="text/javascript"> function showSources(){ var viewer = air.SourceViewer.getDefault(); viewer.viewSource() } </script> </head> <body> <p>Click to view the source files.</p> <input type="button" onclick="showSources()" value="View Source" /> </body> </html> 來源檢視器使用者介面當應用程式呼叫 SourceViewer 物件的 viewSource() 方法時,AIR 應用程式會開啟「來源檢視器」視窗。該視窗包含一個原始檔案和目錄的清單 (在左邊),和一個顯示所選檔案之原始碼的區域 (在右邊): 目錄列出在括號內。使用者可以按一下括號來展開或收合目錄的清單。 「來源檢視器」可以顯示具有可辨識之副檔名的文字檔案 (例如,HTM、JS、TXT、XML 和其他格式),或具有可辨識之影像副檔名的影像檔案 (JPG、JPEG、PNG 和 GIF) 的原始碼。如果使用者選取沒有可辨識副檔名的檔案,將會顯示錯誤訊息(「無法從這個檔案類型擷取文字內容」)。 任何透過 setup() 方法排除的原始檔案將不會列示出來 (請參閱載入、設定和開啟來源檢視器)。 |
![]() |