+CMS COntent Management Homepage

/ Indeks dokumentacji / Wdrożenie / Szabon strony / Plik XHTML / Znaczniki w systemie / Statyczne elementy / cms:EventListner

cms:EventListner

<cms:EventListner id="ImageSlideShow" OnEvent="Load|PreRender" Class="" Method=""></cms:EventListner>

Element odpowiada za dołaczenie do zdarzeń ElementLoad lub ElementPreRender dowolnych wywołań logiki w postaci metod PHP.

Atrybuty

  • id - Identyfikator obiektu/elementu. Dowolny ciąg znaków wyróżniający dany element spośród pozostałych elementów tego samego modułu. Musi być on unikalny dla pojedynczego szablonu. Elementy tego samego typu (np. tekst) o identycznych identyfikatorach informują system o tym, że element na stronie ma swoją kopię (oba elementy są takie same). Identyfikator może posiadać polskie znaki i w sposób opisowy identyfikować element strony,
  • OnEvent - Wymagane: rodzaj zdarzenia: Load - ładowanie elementu, PreRender - zdarzenie pozwalające na modyfikację html'a przygotowanego przez eement.
  • Class - Wymagane: nazwa klasy.
  • Method - Wymagany: nazwa metody, która zostanie wykonana gdy nastąpi zdarzenie zdefiniowane w atrybucie OnEvent.

Uwaga!!! Element cms:EventListner musi być podelementem dowolnego innego elementu. Oznacza to, że zdefiniowana obsługa zdarzenia będzie dotyczyć tego elementu którego jest podelementem. np. Jeżeli w ramach elementu cms:Html zdefiniujemy element <cms:EventListner OnLoad="Load" Class="MyClass" Method="OnLoad" /> to gdy element cms:Html będzie ładowany na stronę zostanie wykonana metoda OnLoad klasy MyClass.

Przykład wdrożenia:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
      "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns:cms="http://manual.pluscms.net">

  <head />
  <body>
       <cms:Html id="Tresc">
               <cms:EventListner id="MyEventListner"
                                     OnEvent="Load"
                                     Class="MyClass"
                                     Method
="OnLoadEventListner"/>
    </cms:Html>

  </body>
</html>

Klasa obsługująca zdarzenie

Po załadowaniu elementu cms:Html treść tego elementu zostaje odczytana i usunięte zostają wszystkie tagi oprócz <a> i <p>.

class MyClass {
           public static function OnLoadEventListner(HtmlItem $oSender, $oParams) {
                          $sHtml = $oSender->getProperty(HtmlItemTable::HTML);

                          $sHtml = strip_tags($sHtml, '<p><a>');

                          $oSender->setProperty(HtmlItemTable::HTML,$sHtml);
           }
}

Zobacz więcej...

Metryka dokumentu

Tytuł: Element cms:EventListner
Opis: Statyczny element cms:EventListner. Odpowiedzialny za obsługę zdarzeń.
Źródło: +CMS Dokumentacja
Prawa autorskie: +CMS Content Management System
Autor: root Zmodyfikowany przez: root
Data utworzenia: 2009-10-18 19:13:50 Data modyfikacji: 2009-10-18 19:36:10
Data publikacji: 2009-10-18 19:36:10
(c) +CMS Content Management Platform