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.
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.