Lista odnośników
Lista odnośników jest kolejnym rozwiązaniem (poza wykorzystaniem
parametru 35 i
36 w pliku konfiguracyjnym
oraz
Listy slajdów) umożliwiającym zaawansowaną obsługę linkowania w galerii.
Lista odnośników jest plikiem JavaScript (z rozszerzeniem *.js) i ma następującą składnię
(1)function VG_links(){
this.links=Array(
slajd_nr, adres,
...
)
}
slajd_nr – jest numerem kolejnym slajdu,
adres – jest linkiem przypisanym do slajdu o numerze slajd_nr.
Zwróćmy uwagę na fakt, że kolejne parametry są oddzielane przecinkami, ale po ostatnim parametrze przecinka nie ma. Parametry występują zawsze parami.
Pierwszy parametr z pary oznacza zawsze numer slajdu, którego dotyczy drugi parametr. Drugi parametr może być liczbą lub tekstem. Jeśli drugi parametr z pary jest liczbą, to oznacza on numer slajdu, do którego przeniesie nas galeria, jeśli klikniemy slajd o numerze, do którego ta informacja została przypisana.
Jeśli natomiast drugi parametr z pary jest tekstem, to zastępuje on odnośnik przypisany parametrem
link jak to opisano na stronie
Lista slajdów.
Przygotujmy plik
images_links_1.js jak niżej:
(2)function VG_images(){
this.tab=Array(
"ver_pl_1.png | ver_en_1.png",
"ver_pl_2.png | ver_en_2.png",
"ver_pl_3.png | ver_en_3.png"
)
}
oraz plik
links_1.js jak niżej:
(3)function VG_links(){
this.links=Array(
0, 1,
1, 0,
2, "https://foto.3n.com.pl,_blank | https://photo3n.com,_blank"
)
}
Aby uruchomić ten przykład musimy przygotować plik config_links_1.js, w którym wskażemy przygotowany plik links_1.js:
(4)function VG_myconfig(){
this.my_file_images="images_links_1.js";
this.my_file_links="links_1.js";
this.my_link_mode=1;
}
Poniższe kody uruchamiają nasz przykład (zakładamy, że mamy na stronie div-a o id='gal') w dwóch wersjach językowych:
(5)
new VG_start(document.getElementById('gal'), 'config_links_1.js', 0);
(6)
new VG_start(document.getElementById('gal'), 'config_links_1.js', 1);
Kliknij kod
(5) i
(6).
Zauważ, że kliknięcie w slajd pierwszy przenosi nas na slajd drugi, a kliknięcie w slajd drugi na pierwszy. Slajd trzeci natomiast ma przypisany odnośnik tekstowy w dwóch językach i przenosi nas odpowiednio na polsko- lub angielskojęzyczną wersję innej strony.
Ponadto odnośniki tekstowe mają zdefiniowany (po przecinku) parametr
_blank, który powoduje otwarcie strony z odnośnika trzeciego w nowej zakładce.
Gdyby parametr ten nie był określony, galeria skorzysta z
parametru 34 pliku konfiguracyjnego celem ustalenia docelowego okna odnośnika.
Odnośniki zawarte w omawianym tu pliku mają najwyższy priorytet i nadpisują odnośniki zawarte w pliku ze slajdami. Z kolei odnośniki zawarte w pliku ze slajdami mają priorytet wyższy od odnośników zawartych w pliku konfiguracyjnym.