README.md

Fragment

Fragment is a JavaScript library for building user interfaces.

Fragment is similar to React, but can be used without compilation. Your plain JavaScript projects served as static files can use Fragment to benefit from the ability to update UIs by constructing new trees á la React, but without bundling.

Fragment doesn't support JSX, but does provide a set of helpers for easy tree building, which attempts to bridge the gap. Unfortunately, JSX is not supportable in plain JavaScript. (Everyone loves to have on E4X, but it would have been a great fit for something like this.)

Installing

You can use Fragment as an ES module:

import reconcile, { div } from 'https://cdn.jsdelivr.net/npm/fragmentui/lib.js';

We're also working on providing an NPM library for the project.

npm install fragmentui

Using

// Basic tags like `div`, `p` etc. come with the library, this is how you add support for any tag
const tag = create('tag'); // Use like `tag(...attributesAndOrChildren)`

function render() {
    reconcile(
        // The target DOM node to apply the changes to
        document.body,
        // The rest of the arguments are the top-level nodes in the new rootless tree
        div(
            'Hello, world!',
            p('This is Fragment!'),
        )
    );
}

Testing

Running

See the online demo

To-Do

Set up an .npmignore for publish to use

https://docs.npmjs.com/misc/developers#keeping-files-out-of-your-package

Create releases using GitHub Actions replacing Azure Pipelines

Fix the remaining TypeScript errors in the pipeline

Await to see if either fragment or fragmentjs package name will be donated and migrate to it if either

Change to "partial VDOM"

Input fragments are plain objects and we convert to DOM in reconcile, but we read from real DOM

When we've exhausted target node count and still have fragment nodes, add all in bulk

Using DocumentFragment for perf

Add support for keys

• Will fix chart in showcase sliding attributes from one to another instead of just removing first then appending a new div
• Will fix input focus not moving with an element in a line if it changes within its set

See if there is a good way to recognize binary attributes and allow setting them using booleans (setAttribute?)

Use Element methods instead of setAttribute to make binary attributes work - days later: which is it?

Use a mutation observer to be able to tell the DOM has changed while reconciling

If not by us and restart reconciliation

https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver

Create a demo comparing Fragment with React and Vue

Add a mechanism for rendering raw HTML

Document performance monitoring approaches used to determine the performance characteristics of Fragments

space & time

Add a license file

Realize in the Paper repository and delete the Fragment repository

I have largely implemented what I consider to be the most ergonomic build-system free UI development solution in Paper. I need to check if Fragment still has something to offer than I lack in Paper (should it have reconciliation?) and carry over anything that I find meets that. Afterwards, the Fragment repository should be deleted in favor of Paper.