npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

js-autosave

v1.0.0

Published

The simplest, fastest way to send ajax request when form changes.

Downloads

5

Readme

JavaScript Autosave travis-img-url Code Climate

Making good form that improves user experience is not supposed to be hard to do. Many web developers prefer to prioritize time production over quality. JavaScript Autosave is the simplest, fastest way to send ajax request when form changes.

Installation

Include jQuery library, you can use cdn from jquery.com

<script src="https://code.jquery.com/jquery-3.2.1.min.js"></script>

Direct download

Include it via jsDelivr CDN

<script src="https://cdn.jsdelivr.net/npm/js-autosave/src/js.autosave.js"></script>

Or download the script here and include it

<script src="/path/to/js.autosave.js"></script>

Package Managers

You can get it on npm or on bower under the name js-autosave.

Setup

You can configure your autosave with jQuery selector.

$(".exemple").autosave();

There are two ways to create a DOM element that can be used by JavaScript Autosave. The library uses the action by default or the data-action of your selector for your ajax call. You can also overwrite the ajax call by using data-action on your form element (input, select, textarea).

Initialization with action

<form action="action/ajax-01.html.php" method="post" class="exemple">
  <input type="text" name="xs_username" value="" placeholder="Username">
</form>

Initialization with data-action

<input type="text" name="xs_username" class="exemple" data-action="action/ajax-01.html.php" >

Overwrite action for xs_phone

<form action="action/ajax-01.html.php" method="post" class="exemple">
  <input type="text" name="xs_username">
  <input type="text" name="xs_phone" data-action="action/ajax-02.html.php">
</form>

Timer

To saving a form element with a timer, you can use the data-timer attribute.

Save textarea every 10 seconds

<textarea rows="4" cols="50" name="xs_content" data-timer="10"></textarea>

Save all form elements every 10 seconds

<form action="action/ajax-01.html.php" method="post" class="exemple" data-timer="10">
  <input type="text" name="xs_username">
  <input type="text" name="xs_phone" data-action="action/ajax-02.html.php">
</form>

Send group of field

To create a group, you can use the data-group attribute.

<input type="text" name="xs_username" data-group="xs_username,xs_token">
<input type="hidden" name="xs_token" value="D3YrsxHKPM" data-group="xs_username,xs_token">
{
  "xs_username": "a",
  "xs_token": "D3YrsxHKPM"
}

Contenteditable

If you want to use contenteditable as form element, you can use the data-name attribute.

<div contenteditable="true" class="textarea" data-name="xs_content"></div>

Advanced Options

If you want to catch data returned by JavaScript Autosave before sending ajax request, you can set before function. It can be useful to validate your form content. You will need to return true if you want to procceed the ajax call.

$(".exemple").autosave({
  before : function (parameter) {
    return true;
  }
});

You can process your ajax data return. If MySQL update request is not successful, you can forward it to your fail function.

To use fail function, you need to set a function as an option. JavaScript Autosave will call it if ajax request is not working or if you forward your success function to this one.

To improve user experience, you can use parameter send as arguments for output retry message and a link that will resend the ajax request. For instance, if you want to use it, you will simply need parameter.retry function and send a jQuery selector.

Basic usage

var func = {
  before : function (parameter) {
    if (parameter.data !== "")
      return true;
  },
  success : function (data, parameter) {
    if (!data)
      func.fail(parameter);
  },
  fail : function (parameter) {
    parameter.retry($(".retry"));
  }
};

$(".exemple").autosave(func);

Custom retry message

var func = {
  fail : function (parameter) {
    parameter.retry($(".retry"), "Sorry, an error happened, please <a href=\"#\">try again</a>.");
  }
};

Autosave will send an object to your custom function before, success and fail.

parameter.action      Ajax page called define with your action attribute.

parameter.before      Element value before the update.

parameter.data      Value list of element updated.

parameter.retry      Function that can be use to output a "try again" message.

parameter.target      jQuery selector updated.