craydom v2.3.6

craydom (2.3.4)

Minimalist view framework for building JS apps. Aims to be more efficient than React, Vue or Angular, both for rendering and development.

Features

• Minimal DOM updates without "Virtual DOM" overhead
• Keyed, singleton (from R tag), and clone (from X tag) components
• Pinned DOM locations
• Uses native JS features and requires no transpilation or build step.
• Fully isomorphic, running browser-side or server-side (with builtin hydration).
• Use normal HTML conventions (omit some end tags, omit quotes, lowercase attr names ~ unlike JSX).
• Concise, declarative, literate syntax using tagged template literals.
• Add event listeners inline using the lowercased event name, like click, keydown, etc.
• Small, fast and XSS safe.
• Can be used in place of Deku, lit-html, AppRun or React.
• Namespaced event attributes add flags to addEventListener like capture, passive and once.

Examples

Real world example

This is the core interactive image canvas from this project.

R`
  <canvas
    click=${e => {
      if ( viewState.shouldHaveFocus && document.activeElement != viewState.shouldHaveFocus ) {
        viewState.shouldHaveFocus.focus(); 
      }
    }}
    bond=${[saveCanvas, asyncSizeBrowserToBounds, emulateNavigator, ...canvasBondTasks]}
    touchstart=${retargetTouchScroll}
    touchmove=${[
      e => e.preventDefault(), 
      throttle(retargetTouchScroll, state.EVENT_THROTTLE_MS)
    ]}
    wheel:passive=${throttle(H, state.EVENT_THROTTLE_MS)}
    mousemove=${throttle(H, state.EVENT_THROTTLE_MS)}         
    mousedown=${H}         
    mouseup=${H}         
    pointermove=${throttle(H, state.EVENT_THROTTLE_MS)}         
    pointerdown=${H}         
    pointerup=${H}         
    contextmenu=${subviews.makeContextMenuHandler(state)}
  ></canvas>
`

Installing

From NPM:

$ npm i --save craydom

Then using on server with CJS:

  import {R,X} from 'craydom';

Using on client with the Unpkg CDN:

  <script type=module src=https://unpkg.com/craydom/r.js></script>

Simple Example

This is craydom:

function ButtonWidget({name}) {
  return R`
    <button click=${() => showModal(name)}>
      Show ${name} Modal
    </button>
  `;
}

Other similar/related projects

• lit-html