Létrehozása Bitrix alkatrész

Ebben a cikkben fogunk összpontosítani komponenseinek Bitrix a semmiből. Fogok beszélni, hogyan kell írni egy összetevő, hogy egy leírást hozzá, valamint beállíthatja az összetevőt, hogy képes legyen használni az összetevők, mint a szabványos alkatrészek Bitrix. Korábban írtam az összetevői Bitrix. Azt feltételezzük, hogy a cikket elolvasta. Tehát kezdjük.

komponens mappa szerkezet formájában:

Nézzük az egyes fájlok külön-külön.

.description.php fájl

Egy programozási szempontból .description.php fájlra van szükség, hogy meghatározzuk a tömb $ arComponentDescription, amely meghatározza az alapvető paramétereit a leírás.

Jellemző felépítése ennek a tömb a következő:

Component gombok jelentése a következő:

.parameters.php fájl

Ez a fájl tartalmazza a leírás a bemeneti paraméterek az alkatrész. Leírása a feladatokat a tömb $ arComponentParameters, amely a következő formában:

A tömbnek az alábbi gombokat:

  • CSOPORTOK - Minden paraméter csoportra oszthatók. Csoportok közül egy csoport tömb a következő típusú:

A lista a szokásos csoportok:
ADDITIONAL_SETTINGS (válogatás - 700)
Ez a csoport jelenik meg, például, amikor meghatározza SET_TITLE paraméter.
CACHE_SETTINGS (válogatás - 600)
Úgy tűnik megadásakor CACHE_TIME paramétert.
SEF_MODE (válogatás 500)
Csoport az összes paraméter használatával kapcsolatos, a CNC.
URL_TEMPLATES (válogatás 400)
sablonok linkek
VIZUÁLIS (válogatás 300)
Ritkán által használt csoport. Várható, hogy vezesse a paraméterek felelős a külső.
DATA_SOURCE (válogatás 200)
Azonosító típusa és az információs blokk és hasonlók.
BASE (válogatás 100)
Alapvető paraméterek.
AJAX_SETTINGS (válogatás 550)
Minden, ami érinti a ajax.

  • PARAMÉTEREK - tömb paraméterek leírását. Leírás szerkezete a következő:

    A lehetséges értékek TÍPUS:

    • LIST - elemek listáját
    • JELÖLŐNÉGYZETET - ellenőrizze igen / nem
    • STRING - egy karaktersorozatot
    • Fájl -
    • Colorpicker - szín
    • CUSTOM - Egy példa a felhasználó (CUSTOM) típusú paraméter egy olyan paraméter, a komponens MAP_DATA bitrix: map.google.view

    A típusú ÉRTÉKEK lista gomb tömböt tartalmaz értékek formájában:

    component.php fájl

    Tehát, vessünk egy pillantást a fő összetevője fájlt. Az alap szerkezete a következő:

    Az első sor van szükség, hogy a közvetlen hozzáférést biztosít a komponens fájlt. Ezután jön a meghatározása a tömb $ arResult, meg kell, hogy adja át a mintát.

    StartResultCache módszer visszaadja igaz, ha a cache érvénytelen és elavult adatokat. Az adatok beírása a cache, ha hívja a sablont. További információt erről a funkcióról, olvassa el a dokumentációt is jobb.

    IncludeComponentTemplate funkció megjeleníti az alkatrész sablont. Továbbá, ha ez a funkció az úgynevezett cache frissítésre kerül.

    Létrehozása Bitrix alkatrész

    Most hozzunk létre egy egyszerű alkotóelemet, amely levezethető a rekord információs blokkot. A komponens keretében található egy külön helyet mir neveket. Az input paramétereket inflobloka ID ahonnan hogy az elemek és a mennyiség a minták.

    Hozzon létre egy mappát / bitrix / komponensek új mappát mir. Ez lesz az új névtér.

    Határozza meg az alapvető összetevője fájlokat.

    Valószínűleg észrevette GetMessage funkciót? Most létre kell hoznunk a nyelvi fájlokat. Úgy kell lennie a lang / ru /, és a mappát kell nevezni a fájlokat, változók, melyek akkor is meg kell határozni.

    Kiváló! Most, az összetevő mappában hozzon létre egy mappát sablonokat. Ez lesz tárolva sablonokat. Minden mappa - külön sablon. Az alapértelmezett sablon neve .DEFAULT, hozzon létre egy mappát, és adjuk hozzá a template.php fájlt. Legyen ez egy hosszú üres.

    Most egyszerűen húzza alkatrészek az oldalra. Akkor meg kell jelennie a szerkesztő területen.

    Kattintson duplán rajta, az ablak paramétereit jelenik meg.

    Mint látható, hogy dolgozott ki. De a komponens nem csinál semmit. Fix ezt.

    komponens logika, hogy először meg kell termelni a minta a kijelölt kapcsolattartó blokkban, majd öntsük az adatokat egy sablont, ami a kijelzők. Ott is csak azt mutatja, és az elkülönítés a logika és a prezentáció. Az alkatrész fájl component.php logikát kell határozni. A kimenet kell helyezni egy tömbben $ arResults. Ezzel a tömb működnie kell mintát. Ideális esetben a sablon nem kellene semmilyen manipuláció e tömb, csak kérni az utat a kimenetet a képernyőre.

    A paraméterek telt el a komponens maga, és a sablon segítségével a tömb $ arParams. Akkor hozzá az alábbi sort a komponens fájlt:

    Látni fogja a funkció oldalon a következő:

    tömb szerkezete nagyon egyszerű. Most hozzon létre egy alapvető eleme a logika.

    alkatrész fájl formájában:

    Először volt egy mintát a információs blokk standard módszerekkel Bitrix API. Aztán adunk információt minden elem a tömbben, és okozott $ arResult alkatrész sablont.

    Edit a template.php fájlt az alábbiak szerint:

    Ahogy meglátjuk, már csak egy sablont az információk megjelenítésére, amit helyettesíteni az értéke az információs blokk. Az eredmény a következő:

    Ha azt szeretnénk, egyes stílusok a komponens, majd adjuk hozzá a mappát a fájl style.css komponenst. Bitrix akkor automatikusan csatlakozik.

    Hasonlóképpen Bitrix automatikusan csatlakozni script.js fájlt.

    Kapcsolódó cikkek