¶ Przeglądarka
Przeglądarka to kontrolka która umożliwia wyświetlanie zawartości strony internetowej bez konieczności opuszczania skryptu. Jest to praktyczne narzędzie, które pozwala na integrację przeglądarki internetowej bezpośrednio w skrypcie, co może być przydatne np. w przypadku skryptów które wymagają wyświetlania stron internetowych lub interakcji z nimi.
Ikona kontrolki w zasobniku:
¶ Użycie
Kontrolka przeglądarki umożliwia:
Wyświetlanie stron internetowych: Użytkownik może przeglądać różne strony internetowe bez konieczności opuszczania aplikacji.
Interakcję z zawartością: Kontrolka przeglądarki pozwala na interakcję z elementami zawartości strony internetowej, takimi jak przyciski, formularze itp.
Manipulację zawartością: Możliwe jest również manipulowanie zawartością wyświetlanej strony, np. poprzez zmianę zawartości elementów HTML lub wykonywanie innych operacji na stronie.
Obsługę zdarzeń: Kontrolka przeglądarki umożliwia również reagowanie na różne zdarzenia, takie jak załadowanie strony, kliknięcie w link, wprowadzenie danych do formularza itp.
Wygląd przykładowej kontrolki Przeglądarka w skrypcie :
¶ Właściwości
|
Ogólne |
|
| Nazwa | Nazwa kontrolki umożliwiająca jej identyfikację np. w wyrażeniach zależności pól. |
| Nagłówek | Dodatkowy tekst opisujący przeznaczenie kontrolki (możliwe jest stosowanie formatowania za pomocą tagów BBCode). |
| Pozycja nagłówka | Określa położenie nagłówka względem kontrolki, możliwe wartości to po lewej lub na górze. |
| Szerokość nagłówka | Określa szerokość nagłówka (jeśli nagłówek jest po lewej zwiększenie szerokości nagłówka powoduje zmniejszenie szerokości kontrolki). |
| Wymagalny | Określa, czy wypełnienie kontrolki jest wymagalne. Jeśli kontrolke przeglądarka ustawimy jako wymagalne (true), to walidator nie pozwoli przejść na kolejną stronę skryptu, jeśli wartość pozostanie pusta. |
| Wartość domyślna |
Ustawienie wartości domyślnej może być pomocne dla użytkownika, sugerując oczekiwaną lub popularną wartość do wpisania. Wartość domyślna może zapewnić wygodę dla użytkownika, zwłaszcza jeśli wymaga się często powtarzających się lub standardowych danych. Wartość domyślna jest wyświetlana w kontrolce tylko wtedy, gdy użytkownik nie wprowadził jeszcze swojej własnej wartości. Jeśli użytkownik rozpocznie wpisywanie danych, wartość domyślna zostanie zastąpiona wprowadzanymi przez niego informacjami. Wartość domyślna może być wprowadzona jako stała lub jako nazwa zmiennej której wartość zostanie ustawiona programowo (np. wartość z bazy danych). |
| Wysokość | Określa szerokość kontrolki podaną w pixelach. |
| Powiększenie | Określa wartość powiększenia wyświetlanej zawartości w procentach |
| Zapisz do zmiennej | Pozwala programowo zapisać wartość z kontrolki do zmiennej. Wartość ze zmiennej może być zapisana do bazy lub wykorzystana w kolejnych krokach skryptu. Szczegółowy opis jak pobrać wartość bezpośrednio ze strony html wyświetlanej w kontrolce przegladarka do zmiennej podano w opisie właściwości: Skrypt on unload Uwaga: Nie zapisanie zawartości pola Data do zmiennej nie oznacza utraty tej informacji po zamknięciu sesji skryptu. Wszystkie wartości pól edycyjnych są zapisywane w bazie danych bez względu na to, czy są przypisane do zmiennych, czy nie. |
|
Html |
|
| Url |
Adres url strony która ma być wyświetlona w kontrolce. Uwaga: url ma pierwszeństwo przed Html, jeśli wypełniono obie właściwości to kontrolka będzie wyświetlała zawartość html pobraną z podanego adresu url. |
| Zakoduj parametry | Kodowanie parametrów HTML polega na zamianie znaków specjalnych na ich odpowiedniki kodu HTML. Na przykład, & zostaje zamienione na &, < na <, > na >, " na ", a ' na ' lub '. |
| POST | Określa czy żądanie do serwera http będzie wykonane metodą POST(true) lub GET (false). |
| Html |
Kod html, który ma być przetworzony. Możliwe jest dodawanie stylów css oraz kodu java script. Uwaga: url ma pierwszeństwo przed Html, jeśli wypełniono obie właściwości to kontrolka będzie wyświetlała zawartość html pobraną z podanego adresu url. |
| Skrypt onInit |
Skrypt w języku javaScript jaki ma zostać wykonany przy zdarzeniu OnInit wyświetlanej strony.
|
| Skrypt onLoad |
Skrypt w języku javaScript jaki ma zostać wykonany przy zdarzeniu OnLoad wyświetlanej strony.
|
| Skrypt onUnload |
Skrypty onUnload są używane do wykonania określonych działań przed opuszczeniem strony przez użytkownika.
|
| Włącz walidajcę skryptem | Właściwość powiązana z właściwością “Skrypt walidacyjny”, wartość (true) powoduje aktywację skryptu walidacyjnego, wartość (false) powoduje ignorowanie skryptu walidacyjnego |
| Skrypt walidacyjny | Zadaniem skryptu walidacyjnego jest zapewnić, że dane wprowadzane przez użytkowników są poprawne i spełniają określone kryteria. Skrypty mogą upewnić się, że użytkownik wypełnił wszystkie wymagane pola formularza, lub że dane zostały przesłane do serwera. |
|
Wygląd |
|
| Widoczne | Domyślnie wartość tej właściwości jest ustawiona na widoczny (true), co oznacza, że kontrolka jest widoczna w skrypcie dla użytkownika. Jeśli wartość tej właściwości zostanie zmieniona na niewidoczny (false), kontrolka stanie się niewidoczna dla użytkownika, ale wciąż będzie istniała na stronie skryptu i możliwy będzie dostęp do jej właściwości np. w wyrażeniach zależności pól. |
| Kolor tła | Określa kolor tła kontrolki (chodzi o obszar otaczający kontrolkę i samą kontrolke). Możliwe jest podanie koloru w formacie szesnastkowym lub wybór z wbudowanej palety barw. |
| Szerokość | Określa szerokość kontrolki podaną w pixelach. |
| Margines | Określa odstęp między kontrolką a sąsiednimi elementami w skrypcie. Można określić osobno każdy z marginesów: lewy, górny, prawy, dolny. |
| Podpowiedź | Umożliwia wprowadzenie tekstu który będzie pokazywany w momencie, gdy użytkownik najedzie kursorem na kontrolkę |
|
Tekst |
|
| Rozmiar czcionki | Definiuje rozmiar czcionki tekstu wyświetlanego w kontrolce Data |
| Kolor czcionki | Definiuje kolor tekstu wyświetlanego w kontrolce. Można użyć tej właściwości, aby zmienić kolor tekstu na dowolny inny niż domyślny. |
| Czcionka | Określa czcionkę, w której tekst jest wyświetlany w kontrolce. |
| Grubość czcionki | Określa sposób wyróżnienia tekstu. |
¶ Przykłady skryptów:
Skrypt onInit
dla strony: google.pl
działanie: wypełnia pole wyszkiwania tekstem “on init” + aktualna data):
window.location = 'https://www.google.pl/search?&q=on init ' + new Date().toString()
Skrypt onInit
dla strony: dowolna
diałanie: ustawia adres url strony do wyświetlenia w kontrolce:
window.location = ‘https://www.wp.pl’
Skrypt OnLoad
dla strony: strony z elementem html o id="lst-ib" (np input type=text)
działanie: ustawiania wartości dla skryptu ( przekazanie danych z zewnętrznego źródła) do skryptu działającego w kontrolce. Do elementu o id “lst-ib” dodane zostaje zdarzenie przy zwolnieniu klawisza. Efektem wykonania skryptu będzie przypisanie wartości z elementu “lst-ib” do zmiennej (podanej we właściwości “Zapisz do zmiennej” w skrypcie agenta )
document.getElementById("lst-ib").addEventListener("keyup", function()
{
window.external.SetOutScriptValue(this.value);
});
Skrypt onLoad
dla strony: google.pl
działanie: wypełnia pole wyszkiwania tekstem “on load” + aktualna data). Następnie symuluje kliknięcie przycisku wyszukaj.
document.getElementsByName("q")[0].value = "on load " + new Date().toString();
document.getElementById("tsf").submit();
Skrypt onUnload
dla strony: strony z elementem html typu select o id="idWyniki"
działanie: Efektem wykonania skryptu będzie przypisanie wartości z elementu “idWyniki” do zmiennej (podanej we właściwości “Zapisz do zmiennej” w skrypcie agenta )
window.external.setValue(document.getElementById('idWyniki').options[document.getElementById('idWyniki').selectedIndex].text)
Skrypt onUnload
dla strony: dowolna
działanie: Efektem wykonania skryptu będzie wyświetlenie komunikatu z aktualną datą dla agenta
alert(new Date().toString())
Skrypt walidacyjny
dla strony: google.pl
działanie: Skrypt sprawdza czy użytkownik wpisał tekst w pole wyszukiwania. Jeśli użytkownik nie wpisał tekstu w pole wyszukiwania to zostanie wyświetlony tekst informacyjny “proszę wpisać tekst w pole wyszukiwania” oraz nie będzie możliwe przejście do kolejnej strony skryptu.
(function(){
if(!document.getElementsByName("q")[0].value)
return "proszę wpisać tekst w pole wyszukiwania";
else
return null;})()
Skrypt walidacyjny
dla strony: strony z elementem html o id="wiek" (np input type=text)
działanie: Skrypt sprawdza czy użytkownik wpisał tekst w pole o id="wiek" wartość liczbową większą lub równą 18. Jeśli użytkownik nie wpisał liczby lub wpisał liczbę mniejszą niż18 to zostanie wyświetlony tekst informacyjny “Wymagany jest wiek powyżej 18 lat” oraz nie będzie możliwe przejście do kolejnej strony skryptu.
document.getElementById('wiek').value>=18 ? null: 'Wymagany jest wiek powyżej 18 lat '