Dynamisk innhold

Hva er dynamisk innhold?

Det finnes flere brukerassistansekomponenter som tillater at du har dynamisk innhold. Det betyr at innholdet kan endres avhengig av brukeren miljø eller kontekst. Det kan for eksempel være at du ønsker at en del av hjelpedokumentet eller velkomstsiden bare skal vises hvis brukeren har en bestemt funksjonalitet aktivert.

Det finnes to grunnleggende måter du kan opprette dynamisk innhold på. Den ene er å legge til koder og attributter (annotasjoner) i XML-kodingen som ber systemet filtrere ut deler eller dokumenter, inkludere deler fra andre dokumenter eller oppgi ankre som tillater andre komponenter å utvide dokumentasjonen.

Den andre metoden er å skrive din egne innholdsprodusent ved å plugge inn Java-kode som skriver innholdet fra start eller behandle eksisterende statiske dokumenter kontinuerlig. Vi skal se på begge fremgangsmåtene.

XML-annotasjoner

Den enkleste måten å opprette dynamisk innhold på, er å bruke XML-kodeannotasjonene. Du bare legger til noen spesialattributter og -koder i XML-kodingen, og systemet behandler instruksjonene. Du kan bruke denne kodingen til å

Hvis du vil lære mer om hvert aspekt av kodingen, følger du likene ovenfor eller du finner emnene i innholdsfortegnelsen.

Dette demonstreres i XHTML-fragmentet som vises nedenfor:


<p>
Dette er et statisk avsnitt.
   </p>

<!-- Denne koden blir erstattet med den refererte koden -->
<include path="my.plugin.id/path/my_other_document.xhtml/element_id"/>

<ul>
   <li>
      Dett er et statisk listepunkt.
   </li>
   <li filter="os=win32">
      Dette vises bare ved kjøring på Windows.
   </li>
   <li filter="plugin!=org.eclipse.help">
      Dette vises bare når plugin-modulen org.eclipse.help IKKE er installert.
   </li>
</ul>

<!-- Et sted der andre kan legge til innhold -->
<anchor id="my.anchor.id"/>

Innholdsprodusenter

En innholdsprodusent er en mekanisme for innplugging av Java-kode for å produsere dokumentinnhold kontinuerlig. Innholdsprodusenter er kraftigere enn XML-annotasjoner, men de er mer komplekse å bruke.

Innholdsprodusenter støttes i de følgende områdene av brukerassistanse: