A powerfull Form Manager https://dze.io
您最多选择25个主题 主题必须以字母或数字开头,可以包含连字符 (-),并且长度不得超过35个字符
Florian Bouillon 753675b15c
Add new Attribute `data-error`
18 小时前
src Add new Attribute `data-error` 18 小时前
.babelrc Added new build system via Rollup ! 4 天前
.gitignore Added new build system via Rollup ! 4 天前
.npmignore Removed build.json 3 周前
CHANGELOG.md BUMP -> 0.3.0 1周前
CONTRIBUTING.md Update CONTRIBUTING 1周前
LICENSE.md Updated 1 个月前
README.md Updated Wiki 1周前
package.json Added new build system via Rollup ! 4 天前
rollup.config.js Added new build system via Rollup ! 4 天前
tsconfig.cjs.json Added new build system via Rollup ! 4 天前
tsconfig.json Added new build system via Rollup ! 4 天前
yarn.lock Added new build system via Rollup ! 4 天前

README.md

Form Manager

A powerfull Manager for all your forms

Table of Content

Installation

nothing difficult.
In you project simply run this command

yarn add @dzeio/form-manager

or

npm install @dzeio/form-manager

usage

Typescript

import FormManager from '@dzeio/form-manager';

const fm = new FormManager(document.getElementById("form"));
const am = fm.attributeManager; // The Attribute Manager

Add Modules

import RepeatInput from '@dzeio/form-manager/modules/RepeatInput'
import IgnoreAttribute from '@dzeio/form-manager/attributes/IgnoreAttribute';

fm.assign(RepeatInput)
// and/or attributes
am.register(IgnoreAttribute)

// After adding modules/attributes run to reffect modules to inputs
fm.setupInputs();
am.setup();

Now You can launch any lines from below !

import { FMMode } from '@dzeio/form-manager'

// verify form validity
fm.verify(); //return true if valid else return false
// if it returns false you can use the variable under to see the first errored input
fm.lastErroredInput

// submit your data to an endpoint
fm.submit("/api/dzeio", (ev) => {/* onloaded callback*/})

// get the json of your form
fm.getJSON()

// fill form from URI
// datas MUST be in JSON (see getJSON for examples)
fm.fillFromURI("uri")

// same as before but you give the json from typescript
fm.fillFromJSON(json)

// change if you only see the form or edit them
fm.setMode(FMMode.ViewMode) // make form uneditable
fm.setMode(FMMode.EditMode) // Make form editable

// same thing as before but just for one field
fm.setModeForInput(FMMode.ViewMode, "inputName")
fm.setModeForInput(FMMode.EditMode, "inputName")

// Reset the form to it's defaults values
fm.clear()

Modules & Attributes

You can create you own modules/attributes or use the builtin ones
See AbstractInput.ts to get started on module creation
And AbstractAttribute.ts for attribute creation

Builtin Modules

Module name Description
Datalist Manage the datalist better than ever !
Date Manage the date element
Repeat Make your fields repeatable !
Select Fix your Select

Builtin Attributes

Attribute name Description
data-autoset Update your value in realtime
data-default a better value than value
data-ignore make an input field not submitted
data-regex Verify you value via regex

Issues

Complete listing here

Changelog

Here

Wiki

Here