Skip to content

Latest commit

 

History

History
 
 

rdom-forms

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

@thi.ng/rdom-forms

npm version npm downloads Mastodon Follow

Note

This is one of 190 standalone projects, maintained as part of the @thi.ng/umbrella monorepo and anti-framework.

🚀 Please help me to work full-time on these projects by sponsoring me on GitHub. Thank you! ❤️

About

Data-driven declarative & extensible HTML form generation. This is a support package for @thi.ng/rdom.

This package uses vanilla JS objects to define component specs for various types of form elements (various factory functions are provided). These specs can then be passed to the polymorphic & dynamically extensible compileForm() function to generate the actual form elements/components in hiccup format, which can then be used with thi.ng/rdom or for static (or SSR) HTML generation via thi.ng/hiccup.

All generated form elements are unstyled by default, but can be fully customized (in various stages) via user-provided options.

Please see the example project linked further below, which demonstrates all currently provided elements...

Status

ALPHA - bleeding edge / work-in-progress

Search or submit any issues for this package

Related packages

Installation

yarn add @thi.ng/rdom-forms

ES module import:

<script type="module" src="https://cdn.skypack.dev/@thi.ng/rdom-forms"></script>

Skypack documentation

For Node.js REPL:

const rdomForms = await import("@thi.ng/rdom-forms");

Package sizes (brotli'd, pre-treeshake): ESM: 2.29 KB

Dependencies

Usage examples

Several projects in this repo's /examples directory are using this package:

Screenshot Description Live demo Source
Large ASCII font text generator using @thi.ng/rdom Demo Source
Interactive & reactive image blurhash generator Demo Source
Color palette generation via dominant color extraction from uploaded images Demo Source
Matrix-based image color adjustments Demo Source
Interactive pixel sorting tool using thi.ng/color & thi.ng/pixel Demo Source
Basic usage of the declarative rdom-forms generator Demo Source
rdom & hiccup-canvas interop test Demo Source

API

Generated API docs

TODO

Authors

If this project contributes to an academic publication, please cite it as:

@misc{thing-rdom-forms,
  title = "@thi.ng/rdom-forms",
  author = "Karsten Schmidt",
  note = "https://thi.ng/rdom-forms",
  year = 2023
}

License

© 2023 - 2024 Karsten Schmidt // Apache License 2.0