Atrybuty
- responseText - odpowiedź z serwera jako tekst
- responseXML - odpowiedź z serwera w formacie XML
- responseJSON - odpowiedź z serwera w formacie JSON
- getJSON - pobranie odpowiedzi z serwera w formacie JSON (wartość domyślna: false)
- async - asynchroniczne wysyłanie zapytań (wartość domyślna: true)
- method - metoda wysyłania zapytań ("GET", "POST" lub "HEAD") (wartość domyślna: "GET")
- encoding - kodowanie znaków wysyłanych metodą POST (wartość domyślna: "utf-8")
- contentType - typ zawartości (MIME) wysyłanej w zapytaniu (wartość domyślna: "text/plain")
- username - nazwa użytkownika potrzebna do autoryzacji po stronie serwera (wartość domyślna: "")
- password - hasło potrzebne do autoryzacji po stronie serwera (wartość domyślna: "")
- evalScripts - wykonywanie skryptów znajdujących się w odebranej odpowiedzi (wartość domyślna: false)
- evalResponse - wykonywanie skryptów załadowanych bezpośrednio z pliku .js (wartość domyślna: false)
- resetForm - resetowanie wartości pól formularza po wysłaniu zapytania (wartość domyślna: true)
- disableForm - blokowanie pól formularza przy wysyłaniu formularza do czasu otrzymania odpowiedzi (wartość domyślna: true)
- retryNum - ilość prób ponownego wysłania zapytania podczas problemów z połączeniem (wartość domyślna: 3)
- timeout - ilość czasu w milisekundach, która musi upłynąć aby ponowić próbę wysłania zapytania (wartość domyślna: 5000)
- clearParams - czyszczenie parametrów po pomyślnym odebraniu odpowiedzi (wartość domyślna: true)
- clearHeader - czyszczenie danych w nagłówku po pomyślnym odebraniu odpowiedzi (wartość domyślna: true)
- status - numer statusu
- statusText - nazwa statusu
- OnComplete() - funkcja wywoływana podczas zakończenia pobierania odpowiedzi
- OnSuccess() - funkcja wywoływana podczas pomyślnego zakończenia obsługi zapytania
- OnError() - funkcja wywoływana podczas wystąpienia błędu
- OnAbort() - funkcja wywoływana po przekroczeniu ilości prób wznawiania wysyłania zapytania
- OnRetry() - funkcja wywoływana podczas wznawiania wysyłania zapytania po przerwaniu
- OnTimeout() - funkcja wywoływana po przekroczeniu czasu wysyłania zapytania
- OnStateChange() - funkcja wywoływana podczas zmiany statusu połączenia
- OnLoading() - funkcja wywoływana podczas ładowania odpowiedzi
- OnLoaded() - funkcja wywoływana po załadowaniu odpowiedzi
- OnInteractive() - funkcja wywoływana podczas etapu interaktywnego
Metody
- Send(url, [target]) - wysyła zapytanie AJAX do serwera
- url - adres, gdzie wysłane ma zostać zapytanie
- target - element, do którego załadowana zostanie zawartość odpowiedzi responseText
- SendForm(form, [url, method]) - wysyła zapytanie AJAX do serwera zawierające wartości wszystkich pól danego formularza
- form - identyfikator formularza lub element formularza
- url - adres, gdzie wysłane ma zostać zapytanie (jeśli ten argument zostanie pominięty, pobrana zostanie wartość atrybutu action z elementu formularza)
- method - metoda wysłania zapytania (jeśli ten argument zostanie pominięty, pobrana zostanie wartość atrybutu method z elementu formularza lub w przypadku jego braku zapytanie zostanie wysłane metodą POST)
- AddParam(name, value) - dodaje parametr do zapytania
- name - nazwa parametru
- value - wartość parametru
- AddHeader(name, value) - dodaje dane do nagłówka
- name - nazwa pola
- value - wartość
- RemoveParam(name) - usuwa parametr
- RemoveHeader(name) - usuwa dane z nagłówka
- Set(attr) - ustawia przekazane atrybuty (patrz Uwagi)
- attr - obiekt zawierający pary "atrybut: wartość"
- Set(name, value) - ustawia wartość atrybutu
- name - nazwa atrybutu
- value - nowa wartość
Opis
Obiekt służący do obsługi zapytań AJAX.
Uwagi
- Po ustawieniu atrybutu evalScripts na true wywoływane będą wszystkie skrypty znajdujące się w odpowiedzi pomiędzy tagami <script></script>, zarówno te znajdujące się bezpośrednio w pliku jak i ładowanie z zewnątrz, przykładowo jeśli w odebranej odpowiedzi znajdują się poniższe tagi <script>:
<script type="text/javascript" src="script.js"></script>
<script type="text/javascript">
alert("Dynamicznie załadowany skrypt");
</script>
Wywołane zostaną skrypty znajdujące się w pliku script.js oraz funkcja alert.
- Funkcja Set może zostać wywołana z jednym parametrem będącym obiektem zawierającym pary "atrybut: wartość" do ustawienia w obiekcie Request, funkcja ta przydatna jest przede wszystkim w przypadku korzystania z tych samych ustawień w kilku obiektach Request, przykładowo:
var config = {
username : "lorem",
password : "ipsum",
encoding : "iso-8859-2",
evalScripts : true
}
mint.Request().Set(config).Send("first_request.php");
mint.Request().Set(config).Send("second_request.php");
|