https://github.com/aaronleocooper/html-app

Create interactive web pages with HTML and JavaScript easily!
https://github.com/aaronleocooper/html-app

html javascript library webapp

Last synced: about 2 months ago
JSON representation

Create interactive web pages with HTML and JavaScript easily!

• Host: GitHub
• URL: https://github.com/aaronleocooper/html-app
• Owner: AaronLeoCooper
• Created: 2019-01-02T13:49:07.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2023-01-03T17:13:02.000Z (about 2 years ago)
• Last Synced: 2024-12-19T03:18:24.133Z (about 2 months ago)
• Topics: html, javascript, library, webapp
• Language: JavaScript
• Homepage: https://html-app.com
• Size: 1020 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 31
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


# HTMLApp

[![npm](https://img.shields.io/npm/v/html-app.svg?style=flat-square)](https://www.npmjs.com/package/html-app)

[![npm bundle size](https://img.shields.io/bundlephobia/minzip/html-app.svg?style=flat-square)](https://bundlephobia.com/result?p=html-app)

[![David](https://img.shields.io/david/AaronLeoCooper/html-app.svg?style=flat-square)](https://david-dm.org/aaronleocooper/html-app)

[![CircleCI branch](https://img.shields.io/circleci/project/github/AaronLeoCooper/html-app/master.svg?style=flat-square)](https://circleci.com/gh/AaronLeoCooper/html-app/tree/master)

[![NPM](https://img.shields.io/npm/l/html-app.svg?style=flat-square)](https://www.npmjs.com/package/html-app)

Need just a sprinkling of JS to enhance your HTML pages? ✨

Create a HTML page, stick this JavaScript somewhere and off you go. Simple web apps done *simply*.

[Check out the docs!](https://html-app.com).

## Example

Define your view with HTML:

```html

  

  


    

    

  


  

  

```

Define your app logic with JavaScript:

```js

// app.js

new HTMLApp({

  eventHandlers: [

    {

      id: 'userName',

      onChange: function(e, el, app) {

        if (!e.target.value) {

          app.getEl('userNameError').setText('This field is required!');

  

          el.addClass('has-error');

        } else {

          app.getEl('userNameError').setText('');

  

          el.removeClass('has-error');

        }

      }

    }

  ]

});

```

Job done! 🎉

## Features

- HTML is your view, JavaScript is your controller/model (the way we used to do web development!)

- Easily react to as many events as required with no drop in performance

- Thin DOM element wrappers provide just the right amount of helper methods for your app logic

- Dependency-free and super small: [less than 2kb gzipped](https://bundlephobia.com/result?p=html-app)

- No build/transpilation/configuration setup needed— stick it in a HTML page and off you go! 🚀

## Installation

The compressed library JavaScript file can downloaded and included in your HTML pages, or

linked to directly via the Unpkg CDN:

```html

```

Or alternatively if you're compiling your JS files with a bundler like Parcel or Webpack, it

can be installed via NPM and included as an ES6 import in your JavaScript files:

```bash

npm i html-app

```

```js

import HTMLApp from 'html-app';

```