Powrót do spisu komponentów: Tools
Przykładowa mapa procesu: Tools hyperlink 2017-04-11.zip
Przeznaczenie:
Akcja służy do wstawiania hiperłączy w wybranych kolumnach tabeli dynamicznej. Nowe strony otwierają się w nowym oknie.
Jeśli chcemy użyć akcji na większej ilości kolumn w tabeli to należy uzupełnić również parametry w sekcji "Ustaw więcej kolumn" - nie należy ustawiać wielu osobnych akcji w tabeli.
Parametry:
Parametr | Opis | Typ | Uwagi |
---|---|---|---|
Wybrana kolumna w tabeli dynamicznej* | Zmienna w tabeli dynamicznej, która ma zawierać hiperłącza. | VARIABLE |
|
URI* | Funkcja zwracająca linki stron dla poszczególnych komórek w wybranej kolumnie. Aby uzyskać różne wartości należy skorzystać ze zmiennej kontekstowej opisanej poniżej. | FUNCTON | |
Alias łącza* | Funkcja zwracająca wyświetlane aliasy dla poszczególnych komórek w wybranej kolumnie. Aby uzyskać różne wartości należy skorzystać ze zmiennej kontekstowej opisanej poniżej | FUNCTION | |
URI [opcjonalnie] | Lista stron internetowych, które maja zostać umieszczone w tabeli dynamicznej. Każdy element będzie umieszczony w kolejnym wierszu. | STRING_ARRAY | Zastąpione przez parametr "URI". |
Alias łącza [opcjonalnie] | Lista aliasów nazw hiperłączy. Każdy element z listy odpowiada danemu elementowi z listy URI.Pole jest opcjonalne. W przypadku braku pola, nazwy odsyłaczy będą nazwą URI. | STRING_ARRAY | Zastąpione przez parametr "Alias łącza". |
Wybrana kolumna w tabeli dynamicznej | Zmienna w tabeli dynamicznej, w której wartości mają być hiperłączami (odnośniki, łącza HTML). | VARIABLE_ARRAY | Sekcja "Ustaw więcej kolumn". |
URI | Funkcja zwracająca linki stron dla poszczególnych komórek w wybranej kolumnie. Aby uzyskać różne wartości należy skorzystać ze zmiennej kontekstowej opisanej poniżej. | FUNCTION_ARRAY | Sekcja "Ustaw więcej kolumn". |
Alias łącza | Funkcja zwracająca wyświetlane aliasy dla poszczególnych komórek w wybranej kolumnie. Aby uzyskać różne wartości należy skorzystać ze zmiennej kontekstowej opisanej poniżej | FUNCTION_ARRAY | Sekcja "Ustaw więcej kolumn". |
Parametr* - parametr wymagany
Zmienne kontekstowe
"Indeks wiersza"
Zmienna kontekstowa dzięki której możliwe jest odwołanie się do innych kolumn przy tworzeniu URI lub aliasu. np. item($Indeks wiersza, $Cena) pobierze wartość odpowiadającej komórki z kolumny "Cena"
Szczegółowy opis działania:
Akcje podpinamy pod wybraną tabele dynamiczną, w parametrach ustawiamy jakiej kolumny ma dotyczyć (zmiennej tabelarycznej). W kolejnych parametrach wpisujemy adres strony internetowej i ewentualnie jego krótką nazwę. Skrypt działa w ten sposób że wartości z listy "URI:" i "Alias łącza [opcjonalnie]:" łączy razem za pomocą specjalnego znaku "=()=" i zapisuję do zmiennej "Wybrana kolumna w tabeli dynamicznej:". A potem podczas renderowania tej tablicy wstawia specjalnie przygotowany tag HTML (<a><a/>) z adresem strony i nazwą. np. dla URI : "http://www.suncode.pl" i Aliasu: "SunCode" powstanie ciąg znaków "http://www.suncode.pl=()=SunCode", który zostanie zapisany w zmiennej z parametru "Wybrana kolumna w tabeli dynamicznej:". Funkcja renderująca już sobie podzieli w taki sposób aby pod tekstem SunCode w komórce znalazł się link do wybranej strony. Wybrane strony będą się otwierać w nowej karcie. Jeżeli nie ustawimy wybranej kolumny z opcją tylko do odczytu. to jest możliwość ręcznego wpisania stron, lub zwykłego tekstu tak jak pokazuję to tabelka.
Ciąg wpisywany | Ciąg wyświetlany | Uwagi |
---|---|---|
http://www.google.pl=()=Google | Hiperłącze z aliasem | |
http://www.google.pl=()= | http://www.google.pl | Hiperłącze z pełnym adresem |
=()= | =()= | Zwykły tekst |
=()=Alias | =()=Alias | Zwykły tekst |
Zwykły tekst | Zwykły tekst | Zwykły tekst |
"" | "" | Pusty tekst |
Wzór na Hiperłącze
andres_odsyłacza=()=alias_nazwy gdzie adres_osdyłacza może być wszystko("#", "http://www.wp.pl" itp) co wpisuję się w parametrze "href=" w tagu <a> , alias_nazwy to dowolny lub pusty ciąg znaków
Przykład:
Ustawienie parametrów:
Hiperłącza w wybranej kolumnie w tabelce
Uwaga
Przez to że kolumna była edytowalna, to wiersz 7 i 8 został później dodany. Wiersz 7 jako tekst , a wiersz 8 jako hiperłącze do strony www
Add Comment