|
Bir web tarayıcısındaki bir HTML sayfasının kaynak kodunu yalnızca tek bir kullanıcı görüntüleyebilir, kullanıcılar HTML tabanlı AIR uygulamasının kaynak kodunu görüntüleyebilirler. Adobe® AIR® SDK, kaynak kodunuzu son kullanıcılara göstermek için uygulamanızda kullanabileceğiniz bir AIRSourceViewer.js JavaScript dosyası içerir.
Kaynak Görüntüleyicisi'ni yükleme, yapılandırma ve açma
Kaynak Görüntüleyicisi kodu AIR SDK'nin çerçeveler dizininde bulunan AIRSourceViewer.js adlı bir JavaScript dosyasına dahil edilir. Kaynak Görüntüleyicisi'ni uygulamanızda kullanmak için, AIRSourceViewer.js dosyasını uygulama proje dizininize kopyalayın ve dosyayı uygulamanızdaki ana HTML dosyası aracılığıyla yükleyin:
<script type="text/javascript" src="AIRSourceViewer.js"></script>
AIRSourceViewer.js dosyası
air.SourceViewer
öğesini çağırarak JavaScript kodundan erişebileceğiniz SourceViewer adlı bir sınıfı tanımlar.
SourceViewer sınıfı üç yöntem tanımlar:
getDefault()
,
setup()
ve
viewSource()
.
|
Yöntem
|
Açıklama
|
|
getDefault()
|
Statik bir yöntem. Başka yöntemler çağırmak için kullanabileceğiniz bir SourceViewer örneği gönderir.
|
|
setup()
|
Yapılandırma ayarlarını Kaynak Görüntüleyicisi'ne uygular. Ayrıntılı bilgi için, bkz.
Kaynak Görüntüleyicisi'ni yapılandırma
|
|
viewSource()
|
Kullanıcının ana bilgisayar uygulamasının kaynak dosyalarını tarayıp açabileceği yeni bir pencere açar.
|
Not:
Kaynak Görüntüleyicisi'ni kullanan kod uygulama güvenlik sanal alanında olmalıdır (uygulama dizininde bulunan bir dosyada.)
Örneğin, aşağıdaki JavaScript kodu bir Kaynak Görüntüleyicisi kodu başlatır ve tüm kaynak dosyalarını listeleyen bir Kaynak Görüntüleyicisi penceresi açar:
var viewer = air.SourceViewer.getDefault();
viewer.viewSource();
Kaynak Görüntüleyicisi'ni yapılandırma
config()
yöntemi verilen ayarları Kaynak Görüntüleyicisi'ne uygular. Bu yöntem tek bir parametre alır:
configObject
.
configObject
nesnesi Kaynak Görüntüleyicisi'ne ilişkin ayarları tanımlayan özelliklere sahiptir. Bu özellikler,
default
,
exclude
,
initialPosition
,
modal
,
typesToRemove
ve
typesToAdd
özellikleridir.
default
Kaynak Görüntüleyicisi'nde görüntülenecek ilk dosyaya giden göreceli yolu belirleyen dize.
Örneğin, aşağıdaki JavaScript kodu Kaynak Görüntüleyicisi penceresini gösterilen ilk dosya olarak index.html dosyasıyla açar:
var viewer = air.SourceViewer.getDefault();
var configObj = {};
configObj.default = "index.html";
viewer.viewSource(configObj);
hariç tut
Kaynak Görüntüleyicisi listesinden hariç tutulacak bir dizeler dizisi. Yollar uygulama diziniyle ilişkilidir. Joker karakterler desteklenmez.
Örneğin, aşağıdaki JavaScript kodu Kaynak Görüntüleyicisi penceresini açar ve AIRSourceViewer.js dosyası ve Görüntüler ve Sesler alt dizinlerindeki dosyalar dışındaki tüm kaynak dosyaları listeler:
var viewer = air.SourceViewer.getDefault();
var configObj = {};
configObj.exclude = ["AIRSourceViewer.js", "Images" "Sounds"];
viewer.viewSource(configObj);
initialPosition
İki sayı içeren ve Kaynak Görüntüleyicisi penceresinin x ve y koordinatlarını belirleyen bir dizi.
Örneğin, aşağıdaki JavaScript kodu Kaynak Görüntüleyicisi penceresini [40, 60] (X = 40, Y = 60) ekran koordinatlarında açar:
var viewer = air.SourceViewer.getDefault();
var configObj = {};
configObj.initialPosition = [40, 60];
viewer.viewSource(configObj);
modal
Kaynak Görüntüleyicisi'nin bir modal (true) pencere mi yoksa modal olmayan (false) bir pencere mi olması gerektiğini belirleyen bir Boolean değeri. Varsayılan olarak, Kaynak Görüntüleyicisi penceresi modsaldır.
Örneğin, aşağıdaki JavaScript kodu, Kaynak Görüntüleyicisi penceresini kullanıcının hem Kaynak Görüntüleyicisi penceresiyle hem de herhangi bir uygulama penceresiyle etkileşebileceği şekilde açar:
var viewer = air.SourceViewer.getDefault();
var configObj = {};
configObj.modal = false;
viewer.viewSource(configObj);
typesToAdd
Kaynak Görüntüleyicisi'nde bulunan varsayılan türlere ek olarak dahil edilecek dosya türlerini belirleyen bir dizeler dizisi.
Varsayılan olarak, Kaynak Görüntüleyicisi aşağıdaki dosya türlerini listeler:
-
Metin dosyaları: TXT, XML, MXML, HTM, HTML, JS, AS, CSS, INI, BAT, PROPERTIES, CONFIG
-
Görüntü dosyaları: JPG, JPEG, PNG, GIF
Hiç bir değer belirli değilse, varsayılan tüm türler dahil edilir (
typesToExclude
özelliğinde belirtilenler hariç).
Örneğin, aşağıdaki Kaynak Görüntüleyicisi penceresini açan JavaScript kodu VCF ve VCARD dosyalarını içerir:
var viewer = air.SourceViewer.getDefault();
var configObj = {};
configObj.typesToAdd = ["text.vcf", "text.vcard"];
viewer.viewSource(configObj);
Listelediğiniz her dosya türü için, "metin" (metin dosya türleri için) veya "görüntü" (görüntü dosya türleri için) dosyası olduğunu belirtmeniz gerekir.
typesToExclude
Kaynak Görüntüleyicisi'nden hariç tutulacak dosya türlerini belirleyen dizeler dizisi.
Varsayılan olarak, Kaynak Görüntüleyicisi aşağıdaki dosya türlerini listeler:
-
Metin dosyaları: TXT, XML, MXML, HTM, HTML, JS, AS, CSS, INI, BAT, PROPERTIES, CONFIG
-
Görüntü dosyaları: JPG, JPEG, PNG, GIF
Örneğin, aşağıdaki JavaScript kodu, GIF veya XML dosyalarını listelemeden Kaynak Görüntüleyicisi penceresini açar:
var viewer = air.SourceViewer.getDefault();
var configObj = {};
configObj.typesToExclude = ["image.gif", "text.xml"];
viewer.viewSource(configObj);
Listelediğiniz her dosya türü için,
"metin"
(metin dosya türleri için) veya
"görüntü"
(görüntü dosya türleri için) dosyası olduğunu belirtmeniz gerekir.
Kaynak Görüntüleyicisi'ni Açma
Kullanıcı onu seçtiğinde Kaynak Görüntüleyicisi kodunu çağıran bir bağlantı, düğme veya menü komutu gibi bir kullanıcı arabirim öğesini dahil etmelisiniz. Örneğin, aşağıdaki basit uygulama kullanıcı bir bağlantıyı tıklattığında Kaynak Görüntüleyicisi'ni açar:
<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>
Kaynak Görüntüleyicisi kullanıcı arabirimi
Uygulama SourceViewer nesnesinin
viewSource()
yöntemini çağırdığında, AIR uygulaması bir Kaynak Görüntüleyicisi penceresi açar. Pencere bir kaynak dosyalar ve dizinler listesi (solda) ve seçili dosyanın kaynak kodunu gösteren bir görüntüleme alanı (sağda) içerir:
Dizinler parantez içinde listelenir. Kullanıcı bir dizinin listesini genişletmek veya daraltmak için bir sol ayracı tıklatabilir.
Kaynak Görüntüleyicisi metin dosyalarına ilişkin kaynağı tanınan uzantılarla (HTML, JS, TXT, XML ve diğerleri gibi) veya tanınan görüntü uzantılarıyla (JPG, JPEG, PNG ve GIF) görüntüleyebilir. Kullanıcı tanınan bir dosya uzantısı olmayan bir dosya seçerse, bir hata mesajı görüntülenir (“Bu dosya türünden metin içeriği alınamıyor”).
setup()
yöntemiyle dahil edilen herhangi bir kaynak dosyası listelenmez (bkz.
Kaynak Görüntüleyicisi'ni yükleme, yapılandırma ve açma
).
|
|
|
