Custom Components
Extend RapidWeaver by creating your very own custom Components
Last updated
Extend RapidWeaver by creating your very own custom Components
Last updated
We are Realmac Software. We make nice things.
If you know a bit of HTML you can create your own custom Components for use in your projects. These can be anything from a simple html snippet to a fully blown Component with custom UI controls. The possibilities of what you can create are endless!
No extrenal code editor is required, you can build everything inside of RapidWeaver Elements.
Custom Components are stored in the project they were created in.
Custom Components have full access to the Elements Language (although they cannot include extra files like third-party component can).
To ensure compatibility with Elements you should use Tailwind CSS classes when writting your Template HTML.
Custom Components can easily be converted into an encrpyted third-party component that can be distributed and sold via the Elements platform.
Creating a Custom Component in Elements is the easiest and fastest way to get started with exploring the Elements API. Custom Components can eaily be migrated to distributable Element Packs at a later date.
Using the following tags enable editable areas with the page. No setup of configuration in the properties file is required.
Replace any text in the html template to make it editable within the page.
Here's a real world example of using the code to make the a heading editable.
You can also set a default value for an editable text areas, so that when your custom component is dropped into a page it will be populated with a defulat value. In the example below, it would be "Hello World!".
A dropzones is an area within an HTML template where existing component can be added.
Can also be written like this.
You can also add a title for the Dropzone, this will be shown in the Node Browser.
Using the above tags inside of Custom Components only scratch the surface of what's possible, you can also use the Elements API inside of your Custom Components.
If you're a developer you can take things even further by creating distributable (and sellable) Element Packs for RapidWeaver Elements. You can learn more about Element Packs in the Elements Pack section of this manual.
The following videos will show you how to create Custom Elements. The following videos were recorded with a development version of Elements so the feature(s) available now may differ slightly to those in the video. View the Tutorial playlist on YouTube for more videos.