Spletne predloge kot komponente
Spletne predloge je mogoče ustvariti in uporabljati kot komponente na spletnih straneh, kar ustvarjalcem omogoča uporabo teh komponent za večkratno uporabo in zagotavljanje parametrov za izpolnjevanje zahtev.
Kot razvijalec lahko ustvarite spletno predlogo za zagotavljanje posebnih funkcij, ki jih ustvarjalci lahko konfigurirajo med načrtovanjem spletnih strani.
Naslednje komponente (in druge) lahko ustvarite kot komponente spletne predloge, ki jih je mogoče konfigurirati v oblikovalskem studiu:
- Seznam lokacij z zemljevidi
- Prikaz v obliki vrtiljaka
- Galerija slik ali videoposnetkov
Če želite dodati komponento na spletno stran, lahko uredite stran z orodjem Visual Studio Code za splet in dodajanjem predmeta Liquid »include« v kopijo strani:
{% include '<<web template name>>' <<parameter 1>>: '<<value>>' <<paramter 2>>: '<<value>>' %}
Primer:
{% include 'webTemplateName' name: 'Topics' count:'4' %}
ustvariti komponento spletne predloge;
Če želite ustvariti komponento spletne predloge, v katero lahko ustvarjalcu dovolite posredovanje parametrov, morate spletni predlogi dodati oznako {% manifest %}. Razdelek z manifestom opisuje parametre, ki jih lahko konfigurirate za posredovanje in ki jih lahko uporablja koda spletne predloge.
Manifest je predmet JSON, ki določa lastnosti spletne predloge, prikazane v oblikovalskem studiu: vrsto, prikazano ime, opis, tabele in parametre. Te lastnosti spletne predloge je mogoče uporabiti za premostitev vrzeli med profesionalnimi razvijalci in urejanjem z malo programske kode. Parametri se nanašajo na spremenljivke, ki jih razvijalci uporabljajo v svoji izvorni kodi, ustvarjalci, ki uporabljajo način z malo programske kode, pa lahko konfigurirajo njihove vrednosti.
Podprte lastnosti manifesta
| Lastnost manifesta | Opis |
|---|---|
| Vnesi | Imeti mora vrednost Funkcionalnost ali Postavitev. Postavitev: Dodajte komponento spletne predloge prek postopka Dodaj razdelek v oblikovalskem studiu. Funkcionalnost: Dodajte komponento spletne predloge prek postopka Dodaj komponento v oblikovalskem studiu. |
| displayName | Prijazno ime za komponento spletne predloge, ki se prikaže v oblikovalskem studiu. |
| opis | Opis komponente spletne predloge. |
| tabele | Niz tabel Dataverse, ki jih lahko ustvarjalec uporabi za pomik neposredno na delovni prostor za podatke za urejanje konfiguracije tabel ali zapisov. Tabele morajo biti navedene s svojim logičnim imenom. |
| parametri | Parametri z določenimi lastnostmi: id: Ujema se s spremenljivko, ki se uporablja v kodi spletne predloge in oznaki Liquid »include«. displayName: Prijazno ime v oblikovalskem studiu. description: Kratko besedilo, prikazano v opisu orodja, da ustvarjalcem, ki uporabljajo komponento, zagotovi kontekst. |
Primer:
{% 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-->
Pisanje kode spletne predloge
Če želite razširiti obstoječo vnaprej pripravljeno spletno predlogo, priporočamo, da ustvarite kopijo spletne predloge in razširite kopijo, da ohranite izvorno kodo in preprečite izgubo podatkov.
Vsi parametri so posredovani kot nizi. Priporočljivo je, da v svoji kodi po potrebi pretvorite vrednosti parametrov v želene vrste. Parametre lahko pretvorite z uporabo filtrov Liquid.
Primeri:
{% assign posts_count = count | integer %}{% assign column_count = columns | integer %}
Konfiguracija komponente spletne predloge na spletni strani
Ko je komponenta spletne predloge (z razdelkom manifesta) ustvarjena, lahko kopiji spletne strani dodate ustrezno referenco Liquid (z uporabo orodja Visual Studio Code za splet, orodja Visual Studio Code, aplikacije Upravljanje portala ali drugih metod), ki posreduje različne parametre, kot je prikazano v tem primeru:
{% include 'webTemplateName' name: 'Topics' count:'4' %}
Parametre lahko konfigurirate neposredno v oblikovalskem studiu. Na ta način lahko profesionalni razvijalec ustvari napredne komponente z uporabo spletnih predlog, ki jih lahko ustvarjalci, ki uporabljajo način z malo programske kode, konfigurirajo v oblikovalskem studiu.
Omejitve in znane težave
Gnezdenje komponent spletne predloge v druge komponente spletne predloge ni podprto.
Naslednji korak
Ustvarjanje komponente spletne predloge