Z Wikipedii

XML Inclusions (zwane też XInclude) - Dołączenia XML - to język oparty na XML-u, używany jednak tylko w połączeniu z XML-em lub innymi językami opartymi na XML-u. Został opracowany przez W3C aby umożliwić wstawianie do plików XML zawartości innych plików (zarówno w formacie XML jak i zwykłych, czysto tekstowych).

[edytuj] Sposób użycia

Przed użyciem XInclude należy zadeklarować przestrzeÅ„ nazw XML http://www.w3.org/2001/XInclude, standardowo pod nazwÄ… xi. Aby to zrobić należy do elementu głównego dokumentu XML lub ojca elementu w którego zawartoÅ›ci ma zostać wklejona dodać atrybut:

xmlns:xi="http://www.w3.org/2001/XInclude"

W miejscu w którym zawartość innego pliku ma zostać wstawiona, należy wstawić element <xi:include/>. Element ten może posiadać atrybuty:

• href - adres URI pliku, którego treść ma zostać wstawiona
• parse - sposób parsowania treÅ›ci zaÅ‚Ä…czonego pliku. Może przyjmować wartoÅ›ci "xml" i "text"
• xpointer - adres zaÅ‚Ä…czanego elementu pliku XML w formacie XPointer
• encoding - kodowanie zaÅ‚Ä…czanego pliku tekstowego. Atrybut ten jest ignorowany gdy atrybut parse ma wartość "xml"
• accept - zawartość nagłówka "Accept" wysyÅ‚anego do serwera przy pobieraniu pliku docelowego.
• accept-language - zawartość nagłówka "Accept-Language" wysyÅ‚anego do serwera przy pobieraniu pliku docelowego.

UWAGA! Element <xi:include/> musi posiadać atrybut href i/lub atrybut xpointer.

W przypadku gdy plik nie może zostać Å›ciÄ…gniÄ™ty, generowany jest bÅ‚Ä…d krytyczny. Można temu zapobiec przez wstawienie do elementu <xi:include/> elementu <xi:fallback/> zawierajÄ…cego tekst który zostanie wyÅ›wietlony zamiast zawartoÅ›ci zaÅ‚Ä…czonego pliku. Gdy <xi:fallback/> jest pusty, nic nie jest wstawiane i nie jest generowany żaden bÅ‚Ä…d.

[edytuj] Przykład

Zawartość pliku http://example.com/plik.xml:

<?xml version="1.0" encoding="utf-8"?>
<xml xmlns:xi="http://www.w3.org/2001/XInclude">
   Mój ulubiony kolor to
   <xi:include href="http://example.com/kolor.txt" parse="text" encoding="utf-8">
      <xi:fallback>zielony</xi:fallback>
   </xi:include>.
</xml>

Zawartość pliku http://example.com/kolor.txt:

niebieski

Efekt parsowania pliku http://example.com/plik.xml:

<?xml version="1.0" encoding="utf-8"?>
<xml>
   Mój ulubiony kolor to niebieski.
</xml>

[edytuj] Wsparcie przez przeglÄ…darki

Aktualnie XInclude nie jest wspierany przez żadną z popularnych przeglądarek. Trwają jednak prace nad wsparciem tej technologii w silniku renderowania stron Gecko 1.9^[1] (używanym przez m.in. Firefoxa 3).

[edytuj] Przypisy

1. ↑ mozilla wiki - Firefox/Feature Brainstorming:Web Standards Support

[edytuj] Linki zewnętrzne

• Specyfikacja XML Inclusions 1.0 (en)

p â€¢ d â€¢ e

Technologie zwiÄ…zane z XML-em (Extensible Markup Language)

Rdzenne technologie XML-a: Namespaces in XML • XML Inclusions (XInclude) • XML Information Set • xml:id
XML Events • XML Fragment Interchange • XML Base • Associating Style Sheets with XML documents

Języki stylistyczne: Cascading Style Sheets (CSS) • Document Style Semantics and Specification Language (DSSSL), Rodzina Extensible Stylesheet Language:
Extensible Stylesheet Language (XSL) • XSL Formatting Objects (XSL-FO) • XSL Transformations (XSLT) • XML Path Language (XPath)

Języki z rodziny XML Linking: XML Linking Language (XLink) • XML Base • XML Pointer Language (XPointer)

Języki zapytań dokumentów XML: XML Path Language (XPath) • XML Query Language (XQuery) • XML Syntax for XQuery (XQueryX)

Rodzaje schematów dokumentów XML: Document Type Definition (DTD) • XML Schema • REgular LAnguage for XML Next Generation (RELAX NG)