Wybierz polecenie Plik > Nowy.
Ostatnia aktualizacja
20 gru 2021
Informacje o wykonywaniu transformacji XSL po stronie serwera w programie Dreamweaver. Tworzenie stron XSLT i konwertowanie stron HTML na strony XSLT.
Interfejs użytkownika w programie Dreamweaver i nowszych wersjach został uproszczony. Dlatego począwszy od wersji Dreamweaver niektóre opcje opisane w tym artykule mogą nie być dostępne. Więcej informacji zawiera ten artykuł.
Obieg pracy wykonywania przekształceń XSL po stronie serwera
Można wykonywać przekształcenia XSL po stronie serwera.Przeczytaj o przekształceniach XSL po stronie serwera i klienta oraz o używaniu XML i XSL ze stronami internetowymi przed tworzeniem stron, które wyświetlają dane XML.
Serwer musi być poprawnie skonfigurowany do wykonywania przekształceń po stronie serwera. Dodatkowe informacje można uzyskać od administratora serwera.
Ogólny obieg pracy wykonywania przekształceń XSL po stronie serwera wygląda następująco (każdy krok opisano w innych tematach):
1. Skonfiguruj witrynę Dreamweaver.
2.Wybierz technologię serwera i skonfiguruj serwer aplikacji.
3.Przetestuj serwer aplikacji.
Na przykład utwórz stronę wymagającą przetwarzania i upewnij się, że serwer aplikacji przetwarza stronę.
4.Utwórz fragment XSLT lub stronę albo przekonwertuj stronę HTML na stronę XSLT.
W witrynie Adobe Dreamweaver utwórz fragment XSLT lub całą stronę XSLT.
Przekonwertuj istniejącą stronę HTML na całą stronę XSLT.
5.Dołącz źródło danych XML do strony.
6.Wyświetl dane XML, wiążąc dane z fragmentem XSLT lub z całą stroną XSLT.
7.W razie potrzeby dodaj obiekt XSLT Repeating Region do tabeli lub wiersza tabeli zawierającego symbole zastępcze danych XML.
8.Wstaw odwołania.
Aby wstawić odwołanie do fragmentu XSLT na stronie dynamicznej, użyj zachowania serwera XSL Transformation.
Aby wstawić odwołanie do całej strony XSLT na stronie dynamicznej, usuń cały kod HTML ze strony dynamicznej, a następnie użyj zachowania serwera XSL Transformation.
9.Opublikuj stronę i fragment.
Opublikuj zarówno stronę dynamiczną, jak i fragment XSLT (lub całą stronę XSLT) na serwerze aplikacji. Jeśli używasz lokalnego pliku XML, trzeba będzie go również opublikować.
10.Wyświetl stronę dynamiczną w przeglądarce.
Po wykonaniu tej czynności serwer aplikacji przekształca dane XML, wstawia je na stronie dynamicznej i wyświetla w przeglądarce.
Tworzenie strony XSLT
Można tworzyć strony XSLT umożliwiające wyświetlanie danych XML na stronach internetowych. Można utworzyć całą stronę XSLT — stronę XSLT zawierającą znacznik <body> i znacznik <head> — lub można utworzyć fragment XSLT. Podczas tworzenia fragmentu XSLT tworzy się niezależny plik niezawierający znacznika body ani head — prosty fragment kodu, który jest później wstawiany na stronie dynamicznej.
Jeśli rozpoczynasz pracę od istniejącej strony XSLT, to musisz dołączyć do niej źródło danych XML.
W kategorii Pusta strona okna dialogowego Nowy dokument wybierz jedną z następujących opcji z kolumny Typ strony:
Wybierz XSLT (Cała strona), aby utworzyć całą stronę XSLT.
Opcja XSLT (Fragment) tworzy fragment XSLT.
Kliknij Utwórz i wykonaj jedną z następujących czynności w oknie dialogowym Lokalizowanie źródła XML:
- Zaznacz opcję Dołącz plik lokalny, kliknij przycisk Przeglądaj, wyszukaj lokalny plik XML na swoim komputerze i kliknij przycisk OK.
- Zaznacz opcję Dołącz plik zdalny, wpisz URL lub plik XML w sieci (np. plik pochodzący z kanału RSS) i kliknij przycisk OK.
Kliknięcie przycisku Anuluj generuje nową stronę XSLT bez dołączonego źródła danych XML.
Panel Wiązania jest wypełniony schematem źródła danych XML
Tabela poniżej opisuje elementy, które mogą się pojawić w schemacie:
Element |
Reprezentuje |
Szczegóły |
|---|---|---|
<> |
Wymagany niepowtarzalny element XML |
Element wyświetlany dokładnie raz w swoim związku nadrzędnym |
<>+ |
Powtarzalny element XML |
Element wyświetlany dokładnie raz lub częściej w swoim związku nadrzędnym |
<>+ |
Opcjonalny element XML |
Element nie wyświetlany lub wyświetlany kilka razy w swoim związku nadrzędnym |
Element nadrzędny w tekście pogrubionym |
Bieżący element kontekstowy |
Zwykle powtarzalny element po umieszczeniu kursora wewnątrz regionu powtarzalnego |
@ |
Atrybut XML |
|
Zapisz nową stronę (Plik > Zapisz) z
rozszerzeniem .xsl lub .xslt (domyślnie jest to .xsl).
Konwertowanie stron HTML na strony XSLT
Można także konwertować istniejące strony HTML na strony XSLT.Na przykład jeśli masz gotową stronę statyczną, do której chcesz dodać dane XML, możesz konwertować tę stronę na stronę XSLT zamiast tworzyć stronę XSLT i przeprojektowywać stronę od nowa.
Otwórz stronę HTML, którą chcesz przekonwertować.
Wybierz Plik > Konwertuj > XSLT
1.0.
Kopia strony zostaje otwarta w oknie Dokumentu. Nowa strona to arkusz stylów XSL zapisany z rozszerzeniem .xsl.
Dołączanie źródeł danych XML
Jeśli rozpoczynasz pracę z istniejącą stroną XSLT lub jeśli nie dołączysz źródła danych XML podczas tworzenia nowej strony XSLT w programie Dreamweaver, musisz dołączyć źródło danych XML za pomocą panelu Powiązania.
W panelu Powiązania (Okno > Powiązania)
kliknij łącze XML.
Możesz też kliknąć łącze Źródło, w prawym górnym rogu panelu Związki i dodać źródło danych XML.
Wykonaj jedną z następujących czynności:
Wybierz Dołącz plik lokalny, kliknij przycisk Przeglądaj, przejdź do lokalnego pliku XML na komputerze i kliknij OK.
Wybierz Dołącz plik zdalny i wprowadź Adres URL pliku XML w Internecie (takiego jak plik z kanału RSS).
Kliknij przycisk OK aby zamknąć okno dialogowe Odszukaj źródło XML.
Panel Powiązania zostanie wypełniony schematem źródła danych XML.
Wyświetlanie danych XML na stronach XSLT
Po utworzeniu strony XSLT i dołączeniu źródła danych XML można powiązać dane ze stroną.Aby to zrobić, dodajesz symbol zastępczy danych XML na stronę, a następnie używasz Konstruktora wyrażeń XPath lub Inspektora właściwości do formatowania wybranych danych, które będą wyświetlane na stronie.
Otwórz stronę XSLT z dołączonym źródłem danych XML.
(Opcjonalnie) Wybierz Wstaw > Tabela, aby dodać
tabelę do strony.Tabela pomoże zorganizować dane XML.
Spostrzeżenie
W większości przypadków używasz obiektu Powtarzający się region XSLT do wyświetlania powtarzających się elementów XML na stronie.W takim przypadku możesz chcieć utworzyć tabelę z jednym wierszem i jedną lub więcej kolumn lub tabelę z dwoma wierszami, jeśli chcesz dołączyć nagłówek tabeli.
W panelu Powiązania wybierz element XML i przeciągnij
go w miejsce na stronie, w którym chcesz wstawić dane.
Na stronie zostanie wyświetlony symbol zastępczy danych XML.Symbol zastępczy jest wyróżniony i ujęty w nawiasy klamrowe.Używa składni XPath (język ścieżek XML) do opisu hierarchicznej struktury schematu XML.Na przykład jeśli przeciągniesz element podrzędny title na stronę, a ten element ma elementy nadrzędne rss, channel i item, to składnia symbolu zastępczego zawartości dynamicznej będzie {rss/channel/item/title}.
Kliknij dwukrotnie symbol zastępczy danych XML na stronie, aby otworzyć Konstruktor wyrażeń XPath.Konstruktor wyrażeń XPath umożliwia formatowanie wybranych danych lub wybieranie innych elementów ze schematu XML.
(Opcjonalnie) Zastosuj style do danych XML, zaznaczając
symbol zastępczy danych XML i stosując do niego style jak do każdej innej
zawartości za pomocą Inspektora właściwości lub panelu Style CSS.Alternatywnie można użyć arkuszy stylów czasu projektowania, aby zastosować
style do fragmentów XSLT. Każda z tych metod ma swój własny zestaw
korzyści i ograniczeń.
Wyświetl podgląd pracy w przeglądarce (Plik > Podgląd w przeglądarce).
Jeśli wyświetlasz swoją kompozycję za pomocą opcji Podgląd w przeglądarce, program Dreamweaver wykona wewnętrzne przekształcenie XSL bez użycia serwera aplikacji.
Wyświetlanie powtarzalnych elementów XML
Obiekt XSLT Repeating Region pozwala wyświetlać powtarzające się elementy ze źródła danych XML na stronie internetowej. Na przykład, jeśli wyświetlasz tytuły artykułów i opisy z kanału informacyjnego, a ten kanał zawiera od 10 do 20 artykułów, każdy tytuł i opis w pliku XML prawdopodobnie byłby elementem podrzędnym powtarzającego się elementu.
Każdy region w widoku Design zawierający symbol zastępczy danych XML można zmienić na region powtarzający się. Jednak najczęstsze regiony to tabele, wiersze tabeli lub seria wierszy tabeli.
W widoku Design wybierz region zawierający
symbol zastępczy lub symbole zastępcze danych XML.
Wybór może być dowolny, włącznie z tabelą, wierszem tabeli, a nawet akapitem tekstu.
Aby dokładnie zaznaczyć region na stronie, możesz zastosować funkcję zaznaczania znaczników, dostępną w lewym dolnym rogu okna Dokument. Na przykład jeśli danym regionem jest tabela, kliknij w tabeli na stronie, a potem kliknij znacznik w obrębie funkcji zaznaczania znaczników.
Wykonaj jedną z następujących czynności:
Wybierz Wstaw > Obiekty XSLT > Repeating Region.
W kategorii XSLT panel Wstaw kliknij przycisk Repeating Region.
W XPath Expression Builder wybierz powtarzający się
element, oznaczony małym znakiem plus.
Kliknij przycisk OK.
W oknie dokumentu wokół powtarzanego regionu pojawia się cienki, z zakładkami, szary kontur.Podczas wyświetlania podglądu pracy w przeglądarce (Plik > Podgląd w przeglądarce) szary kontur znika a wybór rozszerza się, aby wyświetlić określone powtarzające się elementy w pliku XML.
Podczas dodawania obiektu XSLT Repeating Region do strony symbol zastępczy danych XML w oknie dokumentu jest obcięty. Dzieje się tak, ponieważ Dreamweaver obcina XPath dla symbolu zastępczego danych XML tak, aby był względny względem ścieżki powtarzającego się elementu.
Określanie właściwości Powtarzalnego regionu (XSL)
W inspektorze właściwości można wybrać inny węzeł XML, aby utworzyć region powtarzający się.
W polu Wybierz wprowadź nowy węzeł, a następnie
naciśnij ikonę pioruna i wybierz węzeł z drzewa schematu XML,
które się pojawi.
Edytowanie obiektu XSLT Powtarzalny region
Po dodaniu obiektu XSLT Repeating Region do regionu można go edytować przy użyciu inspektora właściwości.
Wybierz obiekt, klikając szarą kartę, która
otacza powtarzany region.
W inspektorze właściwości (Okno > Właściwości)
kliknij dynamiczną ikonę obok pola tekstowego Wybierz.
W XPath Expression Builder wprowadź zmiany
i kliknij OK.
Wstawianie fragmentów XSLT na stronach dynamicznych
Po utworzeniu fragmentu XSLT można go wstawić na dynamicznej stronie internetowej przy użyciu zachowania serwera XSL Transformation. Po dodaniu zachowania serwera do strony i wyświetleniu strony w przeglądarce serwer aplikacji wykonuje przekształcenie, które wyświetla dane XML z wybranego fragmentu XSLT.Dreamweaver obsługuje przekształcenia XSL dla stron ColdFusion, ASP lub PHP.
Jeśli chcesz wstawić zawartość całej strony XSLT na stronę dynamiczną, to procedura jest dokładnie taka sama. Przed użyciem zachowania serwera Przekształcenie XSL do wstawienia całej strony XSLT, usuń cały kod HTML ze strony dynamicznej.
Otwórz istniejącą stronę ColdFusion, ASP lub PHP.
W widoku Projekt umieść punkt wstawiania w lokalizacji, w której chcesz wstawić fragment XSLT.
Przy wstawianiu fragmentów XSLT, należy zawsze kliknąć przycisk widoku Pokaż kod i projekt po umieszczeniu kursora na stronie tak, by sprawdzić poprawne umieszczenie kursora. Jeśli nie, można kliknąć w innym miejscu w widoku Kod, aby wstawić kursor w wybranym miejscu.
W panelu Zachowania serwera (Okno > Zachowania
serwera) kliknij przycisk Plus (+) i wybierz przekształcenie XSL.
W oknie dialogowym Przekształcenie XSL kliknij przycisk Przeglądaj
i przejdź do fragmentu XSLT lub całej strony XSLT.
Program Dreamweaver wypełnia następne pole tekstowe ścieżką pliku lub adresem URL pliku XML dołączonego do określonego fragmentu. Aby to zmienić, kliknij przycisk Przeglądaj i przejdź do innego pliku.
(Opcja dodatkowa) Kliknij przycisk Plus (+), aby dodać parametr XSLT.
Kliknij przycisk OK, aby wstawić odwołanie do fragmentu XSLT na
stronie. Wybrany fragment nie może być edytowany. Możesz dwukrotnie kliknąć
fragment, aby otworzyć plik źródłowy fragmentu i go edytować.
folder includes/MM_XSLTransform/ jest również tworzony w folderze głównym witryny i zawiera plik biblioteki środowiska uruchomieniowego. Serwer aplikacji używa funkcji zdefiniowanych w tym pliku do wykonywania przekształcenia.
Prześlij stronę dynamiczną na serwer (Witryna >
Wyślij) i kliknij Tak, aby uwzględnić pliki zależne. Plik zawierający
fragment XSLT, plik XML zawierający dane i wygenerowany
plik biblioteki środowiska uruchomieniowego muszą znajdować się na serwerze, aby strona
wyświetlała się poprawnie. (Jeśli wybrano zdalny plik XML jako źródło danych,
ten plik musi znajdować się w innym miejscu w internecie.)
Usuń fragmenty XSLT ze stron dynamicznych
Fragment XSLT można usunąć ze strony, usuwając zachowanie serwera przekształcenia XSL użyte do wstawienia fragmentu.Usunięcie zachowania serwera usuwa tylko fragment XSLT — nie usuwa powiązanych plików XML, XSLT ani biblioteki środowiska uruchomieniowego.
W panelu Zachowania serwera (Okno >
Zachowania serwera) wybierz zachowanie serwera przekształcenia XSL,
które chcesz usunąć.
Kliknij przycisk Minus (-).
Zachowania serwera powinny być zawsze usuwane w ten sposób. Odręczne usuwanie wygenerowanego kodu powoduje częściowe usunięcie zachowania serwera nawet, jeśli zachowanie serwera zniknie z panelu Zachowania serwera.
Edytuj zachowania serwera przekształcenia XSL
Po dodaniu fragmentu XSLT do dynamicznej strony internetowej można edytować zachowanie serwera przekształcenia XSL w dowolnym momencie.
W panelu Zachowania serwera (Okno >
Zachowania serwera) dwukrotnie kliknij zachowanie serwera przekształcenia XSL,
które chcesz edytować.
Wprowadź określone zmiany i kliknij przycisk OK.
Tworzenie dynamicznego łącza
Można utworzyć łącze dynamiczne na stronie XSLT, które prowadzi do określonego adresu URL po kliknięciu przez użytkownika określonego słowa lub grupy słów w danych XML.Pełne instrukcje można znaleźć w erracie Dreamweaver na stronie www.adobe.com/go/dw_documentation.
Stosowanie stylów do fragmentów XSLT
Podczas tworzenia całej strony XSLT (czyli strony XSLT zawierającej znaczniki <body> i <head>) można wyświetlić dane XML na stronie, a następnie sformatować dane jak każdy inny element zawartości za pomocą inspektora właściwości lub panelu Style CSS. Jednak podczas tworzenia fragmentu XSLT do wstawienia na stronę dynamiczną (na przykład fragmentu do wstawienia na stronę ASP, PHP lub Cold Fusion) renderowanie stylów w fragmencie i na stronie dynamicznej staje się bardziej skomplikowane. Chociaż pracujesz nad fragmentem XSLT oddzielnie od strony dynamicznej, należy pamiętać, że fragment jest przeznaczony do użycia na stronie dynamicznej i że dane wyjściowe z fragmentu XSLT ostatecznie znajdują się gdzieś w znacznikach <body> strony dynamicznej. Biorąc pod uwagę ten obieg pracy, ważne jest, aby nie uwzględniać elementów <head> (takich jak definicje stylu lub łącza do zewnętrznych arkuszy stylów) we fragmentach XSLT.W przeciwnym\nrazie serwer aplikacji umieści te elementy w sekcji\n<body> strony dynamicznej, generując\nnieprawidłowy znacznik.
Na przykład można utworzyć fragment XSLT do wstawienia w stronie dynamicznej i sformatować fragment przy użyciu tego samego zewnętrznego arkusza stylów co strona dynamiczna.Jeśli dołączysz ten sam arkusz stylów\ndo fragmentu, wynikowa strona HTML będzie zawierać zduplikowane łącze\ndo arkusza stylów (jedno w sekcji <head>\nstrony dynamicznej, a drugie w sekcji <body>\nstrony, gdzie pojawia się zawartość fragmentu XSLT).Zamiast\ntego podejścia należy użyć arkuszy stylów czasu projektowania, aby odwołać się\ndo zewnętrznego arkusza stylów.
Podczas formatowania zawartości fragmentów XSLT używaj następującego\nobiegu pracy:
Na początku dołącz zewnętrzny arkusz stylów do wybranej strony dynamicznej. (Jest to najlepszy sposób stosowania stylów do zawartości dowolnej strony internetowej).
Następnie dołącz ten sam zewnętrzny arkusz stylów do wybranego fragmentu XSLT jako arkusz stylów Podczas projektowania. Jak sama nazwa wskazuje, arkusze stylów „Podczas projektowania” działają tylko w widoku Projekt programu Dreamweaver.
Po zakończeniu dwóch poprzednich czynności można utworzyć nowe style w danym fragmencie XSLT, korzystając z tego samego arkusza stylów, który został dołączony do strony dynamicznej. Wyjściowy kod HTML będzie czystszy (ponieważ odniesienie do arkusza stylów jest ważne tylko podczas pracy w programie Dreamweaver), a dany fragment będzie nadal wyświetlał odpowiednie style w widoku Projekt. Co więcej, wszystkie style zostaną zastosowane do fragmentu i strony dynamicznej przy wyświetlaniu tej strony w widoku Projekt lub tworzeniu podglądu strony w przeglądarce.
Jeśli fragment XSLT jest wyświetlany w przeglądarce w postaci podglądu, to przeglądarka nie wyświetli stylów. Zamiast tego, lepiej jest utworzyć podgląd strony dynamicznej w przeglądarce i zobaczyć fragment XSLT w zawartości strony dynamicznej.
Używanie parametrów do przekształceń XSL
Można zdefiniować parametry dla\ntransformacji XSL podczas dodawania zachowania serwera XSL Transformation\ndo strony internetowej.Parametr kontroluje sposób przetwarzania i\nwyświetlania danych XML.Na przykład można użyć parametru do identyfikacji i\nwymienienia określonego artykułu z kanału informacyjnego.Po załadowaniu strony w\nprzeglądarce pojawia się tylko artykuł określony za pomocą parametru.
Dodaj parametr XSLT do transformacji\nXSL
Otwórz okno dialogowe Przekształcenie XSL.
Można to zrobić, klikając dwukrotnie zachowanie serwera przekształcenia XSL w panelu Server Behaviors (Okno > Server Behaviors) lub przez dodanie nowego zachowania serwera przekształcenia XSL.
W oknie dialogowym przekształcenia XSL kliknij przycisk Plus (+) obok parametrów XSLT.
W oknie dialogowym Dodaj parametry wprowadź nazwę parametru w polu Nazwa.Nazwa może zawierać tylko znaki\nalfanumeryczne.Nie mogą zawierać spacji.
Wykonaj jedną z następujących czynności:
Jeśli chcesz użyć wartości statycznej, wprowadź\nją w polu Value.
Jeśli chcesz użyć wartości dynamicznej, kliknij ikonę dynamiczną obok pola Wartość, wypełnij okno dialogowe Dynamic Data i kliknij OK.Aby uzyskać więcej informacji, kliknij przycisk Help w oknie\ndialogowym Dynamic Data.
W polu Default Value wprowadź wartość, której parametr\nma użyć, jeśli strona nie otrzyma wartości w czasie wykonywania, i kliknij\nOK.
Edycja parametru XSLT
Otwórz okno dialogowe Przekształcenie XSL.
Można to zrobić, klikając dwukrotnie zachowanie serwera XSL Transformation\nw panelu Server Behaviors (Okno > Server\nBehaviors) lub przez dodanie nowego zachowania serwera XSL Transformation.
Wybierz parametr z listy parametrów XSLT.
Kliknij przycisk Edytuj.
Wprowadź określone zmiany i kliknij przycisk OK.
Usuwanie parametru XSLT
Otwórz okno dialogowe Przekształcenie XSL.
Można to zrobić, klikając dwukrotnie zachowanie serwera XSL Transformation\nw panelu Server Behaviors (Okno > Server\nBehaviors) lub przez dodanie nowego zachowania serwera XSL Transformation.
Wybierz parametr z listy parametrów XSLT.
Kliknij przycisk Minus (-).
Utwórz i edytuj warunkowe regiony\nXSLT
Można\ntworzyć proste regiony warunkowe lub wiele regionów warunkowych\nna stronie XSLT.Można wybrać element w widoku Design\ni zastosować region warunkowy do zaznaczenia albo wstawić\nregion warunkowy w miejscu, gdzie znajduje się punkt wstawiania w dokumencie.
Na\nprzykład, jeśli chcesz wyświetlić słowo „Niedostępny" obok\nceny towaru, gdy towar jest niedostępny, wpisujesz\ntekst „Niedostępny" na stronie, zaznaczasz go, a następnie stosujesz region warunkowy\ndo zaznaczonego tekstu.Adobe Dreamweaver otacza zaznaczenie znacznikami <xsl:if> i wyświetla tylko słowo „Niedostępne" na stronie, gdy dane są zgodne z warunkami wyrażenia warunkowego.
Stosowanie warunkowego regionu XSLT
Można napisać proste wyrażenie warunkowe do wstawienia na stronie XSLT. Jeśli zawartość jest wybrana podczas otwierania okna dialogowego Region warunkowy, zawartość zostanie zawinięta w blok <xsl:if>. Jeśli treść nie jest wybrana, blok <xsl:if> zostanie dodany w punkcie wstawiania na stronie. Dobrym pomysłem jest użycie okna dialogowego do rozpoczęcia, a następnie dostosowanie wyrażenia w widoku kodu.
Element <xsl:if> jest podobny do instrukcji if w innych językach. Element umożliwia przetestowanie warunku i podjęcie działania na podstawie wyniku. Element <xsl:if> pozwala przetestować wyrażenie pod kątem pojedynczej wartości prawda lub fałsz.
Wybierz Wstaw > Obiekty XSLT > Region warunkowy lub kliknij ikonę Region warunkowy w kategorii XSLT panelu Wstaw.
W oknie dialogowym Region warunkowy wprowadź wyrażenie warunkowe, które ma być używane dla regionu.
W poniższym przykładzie chcesz sprawdzić, czy wartość atrybutu @available węzła kontekstu to true.
Kliknij przycisk OK.
Na stronie XSLT zostaje wstawiony następujący kod:
<xsl:if test="@available='true'">
Tu umieszcza się zawartość
</xsl:if>
Wartości ciągu (tak, jak w przypadku prawdziwy) muszą być umieszczane w cudzysłowach. Program Dreamweaver koduje cudzysłowy ('), aby zostały wprowadzone jako prawidłowy kod XHTML.
Oprócz testowania wartości węzłów można używać dowolnych obsługiwanych funkcji XSLT w dowolnej instrukcji warunkowej. Warunek jest sprawdzany dla węzła bieżącego w danym pliku XML. W poniższym przykładzie chcesz przetestować ostatni węzeł w zestawie wyników:
Więcej informacji i przykładów dotyczących pisania wyrażeń warunkowych podano w sekcji <xsl:if> w panel Referencje (Pomoc > Referencje).
Zastosuj wiele warunkowych regionów XSLT
Można napisać proste wyrażenie warunkowe do wstawienia na stronie XSLT. Jeśli zawartość jest wybrana przy otwieraniu okna dialogowego Region warunkowy, zawartość zostaje umieszczona w bloku <xsl:choose>.Jeśli nie wybierzesz zawartości, blok <xsl:choose> zostanie dodany w punkcie wstawiania na stronie. Dobrym pomysłem jest użycie okna dialogowego, aby rozpocząć, a następnie dostosowanie wyrażenia w widoku kodu.
Element <xsl:choose> jest podobny do instrukcji case w innych językach. Element zapewnia sposób testowania warunków i podejmowania działań na podstawie wyniku. Element <xsl:choose> umożliwia testowanie wielu warunków.
Wybierz Wstaw > Obiekty XSLT > Wiele regionów warunkowych lub kliknij ikonę Wiele regionów warunkowych w kategorii XSLT panelu Wstaw.
W oknie dialogowym Wiele regionów warunkowych wprowadź
pierwszy warunek.
W poniższym przykładzie chcesz przetestować, czy element podrzędny price węzła kontekstu jest mniejszy niż 5.
Kliknij przycisk OK.
W przykładzie następujący kod zostaje wstawiony na stronie XSLT:
<xsl:choose>
<xsl:when test="price<5">
Tu umieszcza się zawartość
</xsl:when>
<xsl:otherwise>
Tu umieszcza się zawartość
</xsl:otherwise>
</xsl:choose>
Aby wstawić kolejny warunek, umieść punkt wstawiania
w widoku kodu między parami znaczników <xsl:when>
lub tuż przed znacznikiem <xsl:otherwise>, a następnie
wstaw region warunkowy (Wstaw > Obiekty XSLT >
Region warunkowy).
Po określeniu warunku i kliknięciu OK kolejny znacznik <xsl:when> zostaje wstawiony w bloku <xsl:choose>.
Więcej informacji i przykładów pisania wyrażeń warunkowych podano w sekcjach <xsl:choose> w panelu Odwołania (Pomoc > Odwołania).
Określanie właściwości (If) regionu warunkowego
Celem inspektora właściwości Ustaw region warunkowy jest zmiana warunku używanego w regionie warunkowym na stronie XSL.Region warunkowy testuje warunek i podejmuje działanie na podstawie wyniku.
W polu Test wprowadź nowy warunek, a następnie
naciśnij Enter.
Określanie warunkowej właściwości (When)
Celem inspektora właściwości Ustaw region warunkowy jest zmiana warunku używanego w regionie wielowarunkowym na stronie XSL.Region z wieloma warunkami testuje warunek i podejmuje działanie na podstawie wyniku.
W polu Test wprowadź nowy warunek, a następnie
naciśnij Enter.
Wstawianie komentarzy XSL
Można dodać znaczniki komentarzy XSL do dokumentu lub otoczyć zaznaczenie znacznikami komentarzy XSL.
Dodawanie znaczników komentarzy XSL do dokumentu
Wykonaj jedną z następujących czynności:
W widoku projektu wybierz Wstaw > Obiekty XSLT > Komentarz XSL, wpisz zawartość komentarza (lub pozostaw pole puste) i kliknij OK.
W widoku kodu wybierz Wstaw > Obiekty XSLT > Komentarz XSL.
Spostrzeżenie
Można również kliknąć ikonę Komentarz XSL w kategorii XSLT panelu Wstaw.
Otaczanie zaznaczenia znacznikami komentarzy XSL
Przełącz na widok kodu (Widok >
Kod).
Wybierz kod dla danego komentarza.
Na pasku narzędzi Kodowanie kliknij przycisk Zastosuj Komentuj
i wybierz Zastosuj <xsl:comment></xsl:comment> Komentuj.
Użyj narzędzia XPath Expression Builder, aby dodać wyrażenia do danych XML
XPath (XML Path Language) to składnia nie-XML służąca do adresowania części dokumentu XML. Jest używany głównie jako język zapytań do danych XML, podobnie jak język SQL jest używany do wykonywania zapytań w bazach danych.Więcej informacji na temat XPath można znaleźć w specyfikacji języka XPath na stronie W3C pod adresem www.w3.org/TR/xpath.
XPath Expression Builder to opcja programu Dreamweaver, która pozwala tworzyć proste wyrażenia XPath do identyfikowania określonych węzłów danych i dla regionów powtarzających się. Zaletą korzystania z tej metody zamiast przeciągania wartości z drzewa schematu XML jest możliwość formatowania wyświetlanej wartości. Bieżący kontekst jest identyfikowany na podstawie pozycji punktu wstawiania w pliku XSL, gdy zostanie otwarte okno dialogowe XPath Expression Builder. Bieżąca zawartość jest napisana czcionką pogrubioną w drzewie schematu XML. W miarę dokonywania wyborów w tym oknie dialogowym generowane są poprawne wyrażenia XPath względem bieżącego kontekstu.Upraszcza to proces pisania poprawnych wyrażeń XPath dla początkujących i zaawansowanych użytkowników.
Funkcja została zaprojektowana dla ułatwienia budowania prostych wyrażeń XPath do identyfikacji określonego węzła lub powtarzalnych regionów. Funkcja nie pozwala na odręczną edycję wyrażeń. Jeśli chcesz utworzyć złożone wyrażenia, użyj Kompilatora wyrażeń XPath na początku, a potem dostosuj wyrażenia w widoku Kod lub przy pomocy inspektora Właściwości.
Utwórz wyrażenie XPath, aby zidentyfikować określony węzeł
Kliknij dwukrotnie symbol zastępczy danych XML
na stronie, aby otworzyć XPath Expression Builder.
W oknie dialogowym XPath Expression Builder (Tekst dynamiczny)
wybierz dowolny węzeł w drzewie schematu XML.
Poprawne wyrażenie XPath zostanie napisane w polu Wyrażenie w celu zidentyfikowania węzła.
Spostrzeżenie
Po wybraniu innego węzła w drzewie schematu XML wyrażenie zmieni się, aby odzwierciedlić wybór.
W poniższym przykładzie chcesz wyświetlić element podrzędny price węzła item:
Ten wybór wstawi następujący kod na stronie XSLT:
<xsl:value-of select="price"/>
(Opcjonalnie) Wybierz opcję formatowania z menu podręcznego Format.
Formatowanie wyboru jest przydatne, gdy wartość węzła zwraca liczbę. Program Dreamweaver zapewnia wstępnie zdefiniowaną listę opcji formatowania. Aby uzyskać pełną listę dostępnych opcji formatowania i przykładów, zobacz panel Materiały referencyjne.
W następującym przykładzie chcesz sformatować podelement price jako walutę z dwoma miejscami dziesiętnymi:
Te opcje wstawią następujący kod na stronie XSLT:<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
Kliknij przycisk OK.
Aby wyświetlić wartość każdego węzła w pliku XML, zastosuj
region powtarzający się do elementu zawierającego tekst dynamiczny (na
przykład wiersz tabeli HTML lub akapit).
Więcej informacji i przykładów dotyczących wybierania węzłów w celu zwrócenia wartości można znaleźć w sekcji <xsl:value-of/> w panelu Odnośnik.
Zaznaczanie węzła do powtarzania
Można wybrać węzeł, który ma zostać powtórzony, i opcjonalnie przefiltrować wyniki.W oknie dialogowym Kreator wyrażeń XPath wybrana zawartość zostanie umieszczona wewnątrz bloku <xsl:for-each>.Jeśli nie wybrano żadnej zawartości, blok <xsl:for-each> zostanie wprowadzony w miejscu położenia kursora.
Kliknij dwukrotnie symbol zastępczy danych XML na stronie,
aby otworzyć Kreator wyrażeń XPath.
W oknie dialogowym Kreator wyrażeń XPath (Region powtarzający) wybierz element do powtórzenia w drzewie schematu XML.
Poprawne wyrażenie XPath jest zapisane w polu Wyrażenie w celu identyfikacji węzła.
Spostrzeżenie
Elementy powtarzające się są oznaczone symbolem plusa (+) w drzewie schematu XML.
W następującym przykładzie chcesz powtórzyć każdy węzeł item w pliku XML.
Po kliknięciu przycisku OK następujący kod zostanie wstawiony na stronie XSLT:
<xsl:for-each select="provider/store/items/item">
Tu umieszcza się zawartość
</xsl:for-each>
W niektórych przypadkach możesz chcieć pracować z podzbiorem węzłów powtarzających się — na przykład możesz potrzebować tylko tych elementów, w których atrybut ma określoną wartość.W tym przypadku musisz utworzyć filtr.
Filtrowanie danych przeznaczonych do powtarzania
Użyj filtru, aby zidentyfikować węzły powtarzające się, które mają określone wartości atrybutów.
Na drzewie schematu XML zaznacz węzeł wybrany do powtarzania.
Kliknij przycisk Buduj filtr.
Kliknij przycisk Plus (+), aby utworzyć pusty filtr.
Wpisz kryteria filtra w następujących polach:
Filtruj wg
Określa węzeł powtarzający się, który zawiera dane, według których ma być wykonywane filtrowanie.Menu podręczne zawiera listę węzłów nadrzędnych względem węzła wybranego w drzewie schematu XML.
Gdzie
Określa atrybut lub element podrzędny węzła Filtruj według, który będzie używany do ograniczenia wyników.Można wybrać atrybut lub element podrzędny z menu podręcznego lub wprowadzić wyrażenie XPath w tym polu, aby zidentyfikować elementy podrzędne, które znajdują się głębiej w drzewie schematu.
Operator
Określa operator porównania używany w wyrażeniu filtru.
Wartość
Określa wartość wyszukiwaną w węźle Filtruj wg. Wpisz wartość. Jeśli dla strony XSLT są zdefiniowane parametry dynamiczne, możesz wybrać jeden z menu podręcznego.
Aby określić kolejny filtr, kliknij ponownie przycisk plusa (+).
Podczas wprowadzania wartości lub dokonywania wyborów w menu podręcznych wyrażenie XPath w polu Wyrażenie zmienia się.
W następującym przykładzie należy ograniczyć zestaw wyników do tych węzłów item, w których wartość atrybutu @available to true.
Po kliknięciu przycisku OK następujący kod zostanie wstawiony na stronie XSLT:<xsl:for-each select="provider/store/items/item[@available = 'true']"> Tutaj znajduje się zawartość </xsl:for-each>
Wartości ciągu (tak, jak w przypadku prawdziwy) muszą być umieszczane w cudzysłowach. Dreamweaver koduje cudzysłowy za ciebie ('), dzięki czemu są wprowadzane jako prawidłowy kod XHTML.
Można utworzyć bardziej złożone filtry, które pozwalają określić węzły nadrzędne jako część kryteriów filtra.W poniższym przykładzie chcesz ograniczyć zestaw wyników do tych węzłów item, gdzie atrybut @id węzła store jest równy 1, a węzeł price węzła item jest większy niż 5.
Po kliknięciu OK następujący kod zostaje wstawiony na stronie XSLT:<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> Tutaj znajduje się zawartość </xsl:for-each>
Więcej informacji i przykładów regionów powtarzających można znaleźć w sekcji <xsl:for-each> w panelu Reference.
Więcej podobnych
- Praca z serwisami programu Dreamweaver
- Wybór serwera aplikacji
- Korzystanie z języków XML i XSL na stronach internetowych
- Przekształcenia XSL po stronie klienta
- Przekształcenia XSL po stronie serwera
- Podgląd danych XML
- Prezentacja zawartości za pomocą tabel
- Dane XML i powtarzalne elementy
- Używanie arkuszy stylów Podczas projektowania
Tworzenie estetycznych serwisów internetowych w programie Dreamweaver
Projektowanie, pisanie kodu i zarządzanie dynamicznymi serwisami internetowymi za pomocą jednego, kompleksowego narzędzia.
