Lucia is a tiny JavaScript (UMD compatible) library as a drop-in replacement for jQuery and vanilla JavaScript web apps. Some features of Lucia are:
Lucia is currently is installable through a CDN and also supports UMD (Node, Browser, Isomorphic/Universal). Put this within your <head> tags in html.
<!-- development version, includes helpful console warnings -->
<script src="https://unpkg.com/lucia/dist/lucia.js" defer></script>
<!-- production version, optimized for size and speed -->
<script src="https://unpkg.com/lucia" defer></script>
Below is an example of a clicker game in Lucia. No, your eyes aren't fooling you - it's really that simple.
<div l-use="{ count: 0 }">
<button l-text="count" l-on:click="++count"></button>
</div>
Lucia relies on directives in markup to perform functions:
| Directive | Description |
|---|---|
l-use | Declares a new component scope. |
l-text | Works similarly to l-bind, but will update the textContent of an element. |
l-html | Works similarly to l-bind, but will update the innerHTML of an element. |
l-if | Toggles display: none; on the element depending on expression (true or false). |
l-on | Attaches an event listener to the element. Executes JavaScript expression when emitted. |
l-bind | Sets the value of an attribute to the result of a JavaScript expression. |
l-join | Create new DOM nodes for each item in an array. |
l-model | Adds "two-way data binding" to an element. Keeps input element in sync with view data. |
Lucia allows us to create component scopes. It tells the library to initialize a new component with the following data object.
<div l-use="{ message: 'Hello World' }">
<p l-text="message"></p>
</div>
At the core of Lucia is a system that enables us to declaratively render data to the DOM using the straightforward l-text and l-html directives:
<div l-use="DeclarativeRendering()">
<p l-text="message"></p>
<p l-html="markupMessage"></p>
</div>
function DeclarativeRendering() {
return {
message: 'Hello World!',
markupMessage: '<span>Hello World with Markup!</span>',
};
}
It’s easy to toggle the presence of an element, too:
<div l-use="Conditionals()">
<button l-if="!show">You can't see me</button>
<button l-if="show">You can see me</button>
</div>
function Conditionals() {
return { show: true };
}
To let users interact with your app, we can use the l-on directive to attach event listeners that invoke methods on our Lucia instances:
<div l-use="EventHandlers()">
<button l-on:click="announce()" l-text="message"></button>
</div>
function EventHandlers() {
return {
message: 'Hello world!',
announce() {
alert(this.message);
},
};
}
In addition to text interpolation, we can also bind element attributes using the l-bind directive:
<div l-use="AttributeBinding()">
<h1 l-bind:class="{ hello: show }">Classes are cool</h1>
<h1 l-bind:style="color">Styles are sassy</h1>
</div>
function AttributeBinding() {
return {
show: true,
color: { color: 'purple' },
};
}
We can also use the l-join directive to render a list of items based on an array. Note that performance will be affected if using array mutators.
<div l-use="ListRendering()">
<p l-join="fruits by , "></p>
</div>
function ListRendering() {
return {
fruits: ['apple', 'orange', 'banana'],
};
}
You can use the l-model directive to create two-way data bindings on form input, textarea, and select elements.
<div l-use="FormInputBindings()">
<input l-model="message" />
<p l-text="message"></p>
</div>
function FormInputBindings() {
return {
message: 'Nothing submitted yet',
};
}
Lucia is MIT licensed.
FAQs
A simple and flexible authentication library
The npm package lucia receives a total of 22,359 weekly downloads. As such, lucia popularity was classified as popular.
We found that lucia demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Company News
Socket is joining TC54 to help develop standards for software supply chain security, contributing to the evolution of SBOMs, CycloneDX, and Package URL specifications.
Security News
PyPI now allows maintainers to archive projects, improving security and helping users make informed decisions about their dependencies.
Research
Security News
Malicious npm package postcss-optimizer delivers BeaverTail malware, targeting developer systems; similarities to past campaigns suggest a North Korean connection.