Skip to content

ioncache/Tag-Handler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jQuery Tag Handler v1.3.1 Copyright (C) 2010-2011 Mark Jubenville Mark Jubenville - [email protected] http://ioncache.github.com/Tag-Handler

Development time supported by: Raybec Communications http://www.raybec.com http://www.mysaleslink.com

Modified by Javier Fernandez Escribano - [email protected] Added autocomplete queries as the user writes

Development time supported by: Tourist Eye http://www.touristeye.com

Based heavily on: Tag it! by Levy Carneiro Jr (http://levycarneiro.com/) http://levycarneiro.com/projects/tag-it/example.html https://github.com/levycarneiro/tag-it http://plugins.jquery.com/project/tag-it

Tag icons/cursors converted from: From the famfamfam.com Silk icon set: http://www.famfamfam.com/lab/icons/silk/

Loader image created at: Preloaders.net http://preloaders.net/


Description

Tag Handler is a jQuery plugin used for managing tag-type metadata.


Basic Usage Instructions

  • Tag Handler must be attached to one or more

      tags in your HTML.

    • To add a tag, click on the tag box, type in a name, and hit enter or comma.

    • Tags may be removed from the tag box by hitting backspace inside the box or by clicking on the tag.

    • The list of tags may be initialized in 1 of 3 ways:

      1. By passing arrays of tag names as options to the plugin ("availableTags" and "assignedTags"); or,

      2. By supplying a "getURL" for the tags to be retrieved via AJAX.

        When using this method, the server must supply a JSON formatted array named "availableTags" and optionally an additional array named "assignedTags".

      3. By supplying a "getURL" and initLoad: false.

        When using this method, it will get the "assignedTags" from the array as in method 1. When the user writes a tag, it will query the server searching for similar tags.

    Either way, the information from these 3 methods will be used in the following manner:

    availableTags: each item in this array will populate the autocomplete drop-down list

    assignedTags: each item this array will become a tag in the tag box

    • Tags may be sent back to the server by supplying an "updateURL". In this case, an array will be sent back to the server named "tags".

    • You can define whether the user can create new tags or select tags only.

    • You can define if the user can edit the tags.

    • A sample CSS file is included that can be used to help with formatting tags.


    Plugin Examples

    Example 1: The Tag Handler will be initialized with no options and no default tags:

    $("#basic_tag_handler").tagHandler();

    Example 2: The Tag Handler will be initialized with preset tags from the assignedTags and availableTags arrays, and autocomplete witll be turned on:

    $("#array_tag_handler").tagHandler({
        assignedTags: [ 'Perl' ],
        availableTags: [ 'C', 'C++', 'C#', 'Java', 'Perl', 'PHP', 'Python' ],
        autocomplete: true
    });

    See https://ioncache.github.io/Tag-Handler/ for more examples