Utveckling av element sker i det nya elementläget. Det når du genom att välja "Element" i menyn för navigatorn.
I elementläget ser du en lista av de element som är under utveckling på webbplatsen.
Du skapar ett nytt element genom att använda Skapa ny i sidolisten. Elementet måste namnges och ett element-id måste specificeras.
Element-id måste vara unikt på den webbplats där elementet används.
Vi rekommenderar att du använder formen:
<organisation>.<element>
Exempel:
se.my-company.calendar.navigation-menu
my-company.image-viewer
se.my-company.image.viewer
När elementet är skapat ser du dess innehåll "som vanligt" i nedre delen av navigatorn och direkt i sidan. Nu är det bara att sätta igång och lägga ut moduler och layouter.
I SiteVision 4.2 finns det endast stöd för en del av alla moduler och inställningar som SiteVision erbjuder. Vid behov kommer stödet utökas.
Följande moduler finns tillgängliga för element:
Du kan för närvarande inte använda dig av dekoration, bakgrundsbild, responsivitet, verktygslist eller vyer.
Filer och bilder som elementet använder sig av måste finnas tillgängliga i elementets fil- och bildarkiv. Arkiven finns tillgängliga under ett elements egenskaper. Så du bifogar den fil eller bild som ska vara en del av elementet.
Varje element kan ha egna CSS-tillägg som kan styra utseendet på elementet. Dessa fungerar på samma sätt som de CSS-tillägg som du kan lägga till på mallar.
När du vill referera en bild eller font i en CSS måste denna fil ligga i elementets filarkiv. För att SiteVision ska kunna hitta filen behöver URL-en utformas på följande sätt:
url("/svmoduleelement/<element-id>/{files|images}/<file>")
Exempel:
.my-element {
background-image:
url("/svmoduleelement/my-company.image-viewer/images/image.png");
}
Ett utvecklingstillägg är en CSS som används när ett element renderas "för sig", som motsats till när den används på en sida. När elementet används produktivt på en sida eller i en mall kommer CSS-en inte användas.
Typfallet när du kan behöva använda ett utvecklingstillägg är när du har ett CSS-tillägg i en grundmall som du inte vill duplicera i ditt element.
Ett element kan även ha egna JavaScript-tillägg som körs när elementet renderas. Dessa fungerar på samma sätt som de JavaScript-tillägg som finns tillgängligt på mallar.
Använder du dig av en modul med tillgång till SiteVisions publika API finns det ett par saker du bör ha i åtanke.
När ett element renderas i elementläget kommer currentPage peka på siten.
Du kommer åt det via PortletContextUtil och currentModuleElement på rot-noden.
Filarkiven finns tillgängliga som undernoder till elementet. Filerna i arkiven kommer du åt "som vanligt" via dess namn.
Du kan ställa in när du skapar elementet om ditt värde ska vara överskrivningssbart. Det finns tre alternativ:
När du utvecklat ditt element och vill se hur det ser ut på en sida eller i en mall är det bara att välja det i modulväljaren under kategorin "Elementutkast".
Genom att publicera sidan och gå "online" så kan du se hur elementet förändras.
Förändringar på ett elementutkast slår igenom direkt även "online".
Denna funktion kräver att du har behörigheten "Hantera element"