Skip to content

RapidElements is a very small library that enables you to easily create compontens with plain html

Notifications You must be signed in to change notification settings

spynetS/RapidElements

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RapidElements

RapidElements is a very small library that enables you to easily create compontens with plain html (NO NODE NEEDED). This library is for you who are tired to use big js frameworks to create a website but want the convinence of components.

Installation

To "install" just add the script link don't forget the defer tag <script defer type="text/javascript" src="https://spynets.github.io/RapidElements/bin/RapidElements.js" ></script>

Usage

  • Example
<!doctype html>
<html class="no-js" lang="">
    <head>
        <script src="https://cdn.tailwindcss.com"></script>
        <script defer type="text/javascript" src="https://spynets.github.io/RapidElements/bin/RapidElements.js" ></script>

    </head>
    <body class="flex flex-col gap-2" >
        <template rapid-name="card" >
            <div class="bg-{color}-500 p-5 rouneded-lg flex flex-col items-center w-[400px] {class}" >
                <h1>Kort</h1>
                <h1>{name}</h1>
                {children}
            </div>
        </template>

        <template rapid-name="bigtitle">
            <div class="text-blue-600" >
                {children}
            </div>
        </template>

        <card name="card1" color="red" class="m-5" >
            <bigtitle  >
                THIS IS THE CHILD
                <p>TJONO</p>
            </bigtitle>
            <h1>TJONO</h1>
        </card>

       <card name="card2" color="blue" class="m-5" ></card>
       <card name="card3" color="green"></card>
       <card name="card4" color="green"></card>

    </body>
</html>
  • Global components

Components.html

        <template rapid-name="card" >
            <div class="bg-{color}-500 p-5 rouneded-lg flex flex-col items-center w-[400px] {class}" >
                <h1>Kort</h1>
                <h1>{name}</h1>
                {children}
            </div>
        </template>

        <template rapid-name="bigtitle">
            <div class="text-blue-600" >
                {children}
            </div>
        </template>

index.html

<!doctype html>
<html class="no-js" lang="">
    <head>
        <script src="https://cdn.tailwindcss.com"></script>
        <script defer type="text/javascript" src="https://spynets.github.io/RapidElements/bin/RapidElements.js" ></script>

    </head>
    <body class="flex flex-col gap-2" >
        <div include-html="Components.html" ></div>

        <card id="0" name="alfred" color="blue">
            <child>
                <card id="0.5">
                    <h1>hej</h1>
                </card>
            </child>
        </card>
        <card name="1"></card>
        <card name="2"></card>
        <card name="3"></card>

    </body>
</html>
    

This will only work if the included html is on a server (liveserver inside vscode works). It will embed the components indide the div conting the include-html attribute and then compile the components This also enables the creation of public component librarys.

How it works

RapidElements is just replacing the outerHTML with the component definitions by saving all component definitions (the elements containg rapid-name). And then everytime we comeacross a element with that tagname replaces the outerHTML with the definition and replacing the props

SPA (Single page application)

RapidElements supports single page application with the router and page component. As long as 404 page redirects to index.html

Try it by running cd examples/SPA node server.js

	<!-- imports the router -->
	<div include-html="http://localhost:8080/Router.html"></div>

	<!-- navigating the pages -->
	<div class="flex flex-row p-2 rounded-lg w-screen bg-slate-100 gap-4">
	  <but onclick="Router.navigate('home')">Home</but>
	  <but onclick="Router.navigate('about')">About</but>
	</div>

	<!-- router compontent with pages as children -->
	<router>
	  <!-- home page -->
	  <page path="home">
		<div class="flex items-center justify-center bg-red-400 p-2">
		  <h1>This is the {path} page</h1>
		</div>
	  </page>
	  <!-- about page -->
	  <page path="about">
		<div class="flex items-center justify-center bg-blue-400 p-2 h-screen">
		  <h1>This is the {path} page</h1>
		</div>
	  </page>
	</router>

TODO

  • Find a way to define components outside the same html (global componts) without developer server