функциятаString или invalid
примерvar a = URL.getQuery("cgi-bin/WAP/tel.pl;3;2?x=1&y=3");
// a = "x=1&y=3"
o функцията getScheme връща протоколния спецификатор от зададен URL адрес; при отсъствие на протокол, резултатът е празен низ
o резюме:
синтаксис getScheme(url)
параметър typeof(url) = String
стойност на
функциятаString или invalid
var a = URL.getSceme("ftp://courses.fmi.uni-
пример
sofia.bg:80/WAP_WML/ex/ex1.zip");
// a = "ftp"
12. Библиотека URL; функции getReferer, getBase и isValid
o функцията getReferer връща кратка форма на относителния URL адрес, от който е извършено обръщнието към текущия WMLScript компилационен модул – обикновено това е името на заредения WML документ
o резюме:
синтаксис getReferer()
стойност на функцията String пример var a = URL.getReferer(); // a = "ex7-09_07.wml#card2"
o функцията getBase връща абсолютния URL адрес на текущия WMLScript компилационен модул
o резюме:
синтаксис getBase()
стойност на функцията String
примерvar a = URL.getBase(); // a = "http://courses.fmi.uni- sofia.bg/WAP_WML/ex7-09_07.wmls"
o функцията isValid проверява дали зададения абсолютен или относителен URL адрес е синтактично верен
o резюме:
синтаксис isValid(url)
параметри typeof(url) = String
стойност на
функциятаBoolean или invalid
Стр. 20 от 25
WAP/WML 9
примери
o пример:
var a = URL.isValid(“http:/courses.uni-sofia.bg/ex.wmls#f1");
// a = false
var b = URL.isValid(“http://courses.uni-sofia.bg/ex.wmls#f1");
o тази библиотека съдържа функции, с които се проверява или установява съдържанието на променливите в даден WML документ и да се извършва обмен между документите в браузера
o функцията getCurrentCard връща URL адреса на WML картата, която която текущо се интерпретира от браузера; адресът е абсолютен когато WML документа и компилационния модул със скрипт кода са разположени на различни сървери, а когато са на един сървер, адресът е относителен (спрямо WMLSсript файла)
o резюме:
синтаксис getCurrentCard()
стойност на
функциятаString или invalid
примерvar a = WMLBrowser.getCurrentCard(); // a = "ex07-
09_13.wmlc#card1"
Стр. 21 от 25
WAP/WML 9
o функцията getVar връща конвертираната до низ стойност на зададена променлива, която е дефинирана във викащия функцията WML документ, променливата може и да е текст, въведен в потребителска форма или избол на опция в меню
o резюме:
синтаксис getVar(var_id)
параметър typeof(var_id) = String
стойност на
функциятаString или invalid
пример var a = WMLBrowser.getVar(“URL”); // a ="ex07-09_13.wmlc#card1"
o функцията setVar записва нова стойност на зададена променлива, която е дефинирана във викащия функцията WML документ като връща стойност true ако операцията е изпълнена успешно
o резюме:
синтаксис setVar(var_id,value)
параметър typeof(var_id, value) = String
стойност на
функциятаBoolean или invalid
пример var a = WMLBrowser.setVar(varname,result); // a = "true"
o функцията newContext изтрива стека на заредените карти и установява начални стойности на променливите т.е. представлява семантичен аналог на атрибута necontext в WML командата ; предходни задания за преход като go() и prev(), които са в процес на зареждане, не се влияят от тази функция. Функцията връща празен низ
o резюме:
синтаксис newContext()
стойност на
функциятаString или invalid
пример var a = WMLBrowser.newContext(); // a = ""
o функцията prev предизвиква зареждане на предходната карта от стека на браузера в момента на връщане от WMLScript интерпретатора към режим браузер, което семантично дублира WML командата
; когато в програмния блок на скрипт функцията са декларирани обръщения към prev и go функциите, след връщане в режим браузер се изпълнява последната от тях. Функцията връща празен низ
o резюме:
синтаксис prev()
стойност на
функциятаString или invalid
пример var a = WMLBrowser.prev(); // a = ""
o функцията refresh предизвиква опресняване на потребителския интерфейс на браузера като се отразява новото състояние на контекста. Тя обикновено се ползва
Стр. 22 от 25
WAP/WML 9 като последна команда в програмния блок на скрипт функциите и е семантичен аналог на WML командата . Функцията връща празен низ при успешно изпълнение или низ с кратко съобщение за грешка, а когато микробраузера не поддържа тази функция - invalid
o резюме:
синтаксис refresh()
стойност на
функциятаString или invalid
пример var a = WMLBrowser.refresh(); // a = ""
o функцията go предизвиква зареждане и преход към зададен URL адрес в момента на връщане от WMLScript интерпретатора към режим браузер, което семантично дублира WML командата ; при няколко функции за преход (prev и go) след връщане в режим браузер се изпълнява последната от тях. Функцията връща празен низ
o резюме:
синтаксис go(url)
параметър typeof(url) = String
стойност на
функциятаString или invalid
пример var a = WMLBrowser.go(U_R_L); // a =""
o пример:
"http://www.wapforum.org/DTD/wml_1.1.xml">
Choose the target URL:
WMLBrowser.getCC: $(result2)'>$(result1)
WMLBrowser.go (URL): $(targetURL)
WMLBrowser.go (rslt): $(result2) ^^
WMLScript код във файла ex7-09_13.wmls:
extern function examineCard(result) {
var myCard = WMLBrowser.getCurrentCard(); WMLBrowser.setVar(result,myCard); WMLBrowser.refresh();}
14. Библиотека Dialogs; функции alert, confirm и prompt
Стр. 23 от 25
WAP/WML 9
o тази библиотека съдържа функции, с които се създава интерктивен потребителски интерфейс
o функцията alert изобразява съобщение на екрана и изчаква позитивна потребителска реакция – натискане на бутон с етикет ОК; тя се използва най-често за обратна връзка при интерпретация на текст и стойности, въведени от потребителя. Функцията връща празен низ
o резюме:
синтаксис alert(msg)
параметър typeof(msg) = String
стойност на
функциятаString или invalid
пример var a = Dialogs.alert(“Must be non-negative”); // a =""
o функцията confirm изобразява съобщение на екрана и изчаква позитивна или негативна потребителска реакция – натискане на бутони със съответен етикет, чиято семантика е OK или Cancel. Функцията връща true ако потребителят избере позитивната опция и false в противен случай
функциятаBoolean или invalid
пример var a = Dialogs.confirm(“Delete?”, “Yes”, “No”); // a = false
o функцията prompt изобразява диалогов прозорец, в който потребителят може да въвежда или да редактира текст; първият параметър се интерпретира като етикет на прозореца, а вторият като текст, който се изобразява в прозореца и може да бъде редактиран. Функцията връща потребителския низ
o резюме:
синтаксис prompt(label, defaultInput)
параметри typeof(label, defaultInput) = String
стойност на
функциятаString или invalid
пример var a = Dialogs.prompt(“Age?”, “18..35 Years”); // a = 22
o пример:
"http://www.wapforum.org/DTD/wml_1.1.xml">
Your input:
Opening Dialog ...$(result2) ^^
Opening Prompt ...$(result3) ^^
Стр. 24 от 25
WAP/WML 9
WMLScript код във файла ex7-09_14.wmls:
extern function openAlert(input) {
for (var i = 0; i < String.length(input); i++) {
if (String.charAt(input,i) == ":") { Dialogs.alert("Don't use colon"); return;
}
}
}
extern function openDialog(result) {
var doContinue = Dialogs.confirm("Continue?", "Yes","No");
// Yes is OK,
// No is Cancel if (doContinue) {
WMLBrowser.setVar(result," we continued");
}
else {
WMLBrowser.setVar(result," we didn't continue");
} WMLBrowser.refresh();
}
extern function openInput(result) {
var length = Dialogs.prompt("Length:"," cm"); WMLBrowser.setVar(result,length); WMLBrowser.refresh();