Құрамдастар ретіндегі веб-үлгілер
Жасаушылардың осы қайта пайдалануға болатын құрамдастарды пайдалануына және талаптарға сай параметрлерді қамтамасыз етуіне мүмкіндік беру үшін веб-үлгілерді веб-беттердегі құрамдастар ретінде жасауға және пайдалануға болады.
Әзірлеуші ретінде веб-беттерді жобалау кезінде жасаушылар конфигурациялай алатын арнайы функционалдылықты қамтамасыз ету үшін веб-үлгі жасай аласыз.
Мысалы, дизайн студиясында конфигурацияланатын веб-үлгі құрамдастары ретінде келесі құрамдастарды (және басқалары) жасауға болады:
- Карталары бар орындар тізімі
- Карусель дисплейі
- Кескіндер немесе бейнелер галереясы
Веб-бетке құрамдас қосу үшін, Интернетке арналған Visual Studio Code арқылы бетті өңдеуге және бет көшірмесіне Liquid include нысанын қосуға болады:
{% include '<<web template name>>' <<parameter 1>>: '<<value>>' <<paramter 2>>: '<<value>>' %}
Мысал:
{% include 'webTemplateName' name: 'Topics' count:'4' %}
Веб-үлгі құрамдасын жасау
Жасаушының параметрлерді жіберуіне рұқсат беретін веб-үлгі құрамдасын жасау үшін веб-үлгіге {% manifest %} тегін қосуыңыз керек. Манифест бөлімінде өту үшін конфигурациялауға және веб-үлгі коды пайдаланатын параметрлер сипатталады.
Манифест — дизайн студиясында көрсетілетін веб-үлгінің сипаттарын анықтайтын JSON нысаны: түрі, көрсетілетін атау, сипаттама, кестелер және параметрлер. Бұл веб-үлгі сипаттарын кәсіби әзірлеушілер мен төмен кодты өңдеу арасындағы алшақтықты жою үшін пайдалануға болады. Параметрлер әзірлеушілер бастапқы кодында пайдаланатын айнымалы мәндерге қатысты және төмен кодты жасаушылар мәндерін конфигурациялай алады.
Манифесттің қолдау көрсетілетін сипаттары
| Манифест сипаты | Сипаттама |
|---|---|
| Түр | Функционалды күйге орнату керек. Функционалды: дизайн студиясында Компонент қосу процесі арқылы веб-үлгі құрамдас бөлігін қосыңыз. |
| displayName | Дизайн студиясында ұсынылатын веб-үлгі құрамдасының ыңғайлы атауы. |
| сипаттама | Веб-үлгі құрамдасының сипаттамасы. |
| кестелер | Жасаушы кестелер конфигурациясын немесе жазбаларын өңдеу үшін Деректер жұмыс кеңістігіне тікелей өту үшін пайдалана алатын Dataverse кестелерінің массиві. Кестелер логикалық атауы бойынша тізімделуі керек. |
| params | Анықталған сипаттары бар параметрлер: id: веб үлгі кодында және Liquid include тегінде пайдаланылатын айнымалы мәнге сәйкес келеді. displayName: Дизайн студиясындағы ыңғайлы атау. сипаттамасы: Компонентті пайдаланатын жасаушыларға мәтінмән беру үшін құралдар кеңесі арқылы берілген қысқа мәтін. |
Мысал:
{% manifest %}
{
"type": "Functional",
"displayName": "Data Cards",
"description": "This component displays data using a cards layout",
"tables": ["cards"],
"params": [
{
"id": "title",
"displayName": "Title",
"description": "Heading for this component"
},
{
"id": "count",
"displayName": "Count",
"description": "No. of items to be displayed"
}]
}
{% endmanifest %}
<!--additional web template code to use parameters to specialized functionality-->
Веб-үлгі кодын жазу
Қолданыстағы дайын веб-үлгіні кеңейту керек болса, бастапқы кодты сақтау және деректердің жоғалуын болдырмау үшін веб-үлгінің көшірмесін жасап, көшірмені кеңейтуді ұсынамыз.
Барлық параметр жолдар ретінде өткізіледі. Кодыңызда параметр мәндерін қажетті түрлерге түрлендіру ұсынылады. Параметрлерді Liquid сүзгілері арқылы түрлендіруге болады.
Мысалдар:
{% assign posts_count = count | integer %}{% assign column_count = columns | integer %}
Веб-бетте веб-үлгі құрамдасын конфигурациялау
Веб-үлгі құрамдасы (манифест бөлімі бар) жасалған кезде, осы мысалда көрсетілгендей әртүрлі параметрлерден өтетін веб-бет көшірмесіне сәйкес Liquid сілтемесін қосуға болады (Интернетке арналған Visual Studio Code, Visual Studio Code, Порталды басқару бағдарламасы немесе басқа әдістер):
{% include 'webTemplateName' name: 'Topics' count:'4' %}
Дизайн студиясында параметрлерді тікелей конфигурациялауға болады. Осылайша кәсіби әзірлеуші төмен кодты жасаушылар дизайн студиясын пайдаланып конфигурациялай алатын веб-үлгілерді пайдаланып кеңейтілген құрамдастарды құрастыра алады.
Шектеулер мен белгілі қателер
Веб-үлгі құрамдастарын басқа веб-үлгі құрамдастарына кірістіруге қолдау көрсетілмейді.
Келесі қадам
Веб шаблон компонентін қалай жасауға болады