jQuery Tags Input Plugin(添加/删除标签插件)详解

 更新时间:2016年06月20日 09:48:12   作者:沫鱼  
本文主要介绍jQuery Tags Input Plugin添加/删除标签插件的用法,非常实用,有需要的朋友可以参考一下。

看名字应该知道是干嘛用了吧。

一个jquery开发的标签功能加强插件,可以生成或删除标签,还能对输入重复标签进行检查,和JQuery autocomplete插件配合实现自动完成功能。

官网:http://xoxco.com/projects/code/tagsinput/

截图:

//img.jbzj.com/file_images/article/201606/201606201005583.png

(下面是翻译了官网上的用法,英文不是很好,有能力的尽量看官网吧)

首先,引用下面两个文件

<script src="jquery.tagsinput.js"></script>
<link rel="stylesheet" type="text/css" href="jquery.tagsinput.css" />

在你的表单里创建一个包含tags列表的input输入框,你可以在value里设置默认或目前有的tags,并用逗号隔开。

<input name="tags" id="tags" value="foo,bar,baz" />

然后,简单地给任何一个输入标签调用tagsInput()函数,它便会被当作一个tags列表处理

$('#tags').tagsInput();

如果你想使用jQuery.autocomalete(自动完成插件)配合使用,那么在函数里增加一个带autocomplete url的参数。

$('#tags').tagsInput({
 autocomplete_url:'http://myserver.com/api/autocomplete'
});

如果你使用了bassistance.de这个网站上的jQuery.autocomplete插件,还可以增加额外的参数来加强autocomplete插件,就像下面描述的这样。

$('#tags').tagsInput({ 
 autocomplete_url:'http://myserver.com/api/autocomplete',
 autocomplete:{selectFirst:true,width:'100px',autoFill:true}
});

PS:需要注意的是,demo里默认用的是jquery ui autocomplete,如果你想要测试jquery.autocomplete,要把头部被注释掉的引用文件去掉注释,并将$('#tags').tagsInput({})中autocomplete_url的地址改为相应的jquery.autocomplete的文件。具体看页面上有说明。

你还可以使用addTag() and removeTag()函数增加和删除掉标签,如以下:

$('#tags').addTag('foo');
$('#tags').removeTag('bar');

你还可以用imporTags()方法导进一组tag列表,需要注意的是这样会将value里设置的默认tag替换掉

$('#tags').importTags('foo,bar,baz');

所以如果importTags()里不带值的话,就是重置input里的标签值(注意引号要保留,可以理解为给它传空值。)

$('#tags').importTags('');

可以使用tagExist()判断一个标签是否存在:

if ($('#tags').tagExist('foo')) { ... }

如果想要在增加或移除掉标签的时候增加额外的功能或触发其它动作,你可以通过onAddTag和onRemoveTag这两个参数里指定回调函。这两个函数都返回了一个标签值作为参数(原文: Both functions should accept a single tag as the parameter.)

$('#tags_1').tagsInput({
 width:'auto',
 onAddTag:function(tag){
  console.log('增加了'+tag)
 },
 onRemoveTag:function(tag){
  console.log('删除了'+tag)
 }
});

如果你想禁止增加标签,或者你想提供其它交互方式增加标签,可以增加一个值为false的interactive参数,这样就禁止了增加标签,而其它的功能和呈现都跟原来一样。

$('#tags_1').tagsInput({
 width:'auto',
 onRemoveTag:function(tag){
  console.log('remover'+'"'+tag+'"')
 },
 interactive:false
});

如果你想要在每次增加/删除一个标签的时候调用一个函数,可以增加onChange的参数,并设置回调函数

默认情况下,如果鼠标位于一个标签后面,按退格键会删除掉那个标签。如果你想禁止这个,设置removeWithBackspace参数为false即可。

参数:

$(selector).tagsInput({
 'autocomplete_url': url_to_autocomplete_api, //自动完成插件的文件地址,demo里有说明
 'autocomplete': { option: value, option: value}, //自动完成插件的参数,demo有说明。(提供个jquery.autocomplete的:http://bassistance.de/jquery-plugins/jquery-plugin-autocomplete/)
 'height':'100px', //设置高度
 'width':'300px', //设置宽度
 'interactive':true, //是否允许添加标签,false为阻止
 'defaultText':'add a tag', //默认文字
 'onAddTag':callback_function, //增加标签的回调函数
 'onRemoveTag':callback_function, //删除标签的回调函数
 'onChange' : callback_function, //改变一个标签时的回调函数
 'removeWithBackspace' : true, //是否允许使用退格键删除前面的标签,false为阻止
 'minChars' : 0, //每个标签的小最字符
 'maxChars' : 0 //每个标签的最大字符,如果不设置或者为0,就是无限大
 'placeholderColor' : '#666666' //设置defaultText的颜色
});

以上就是本文的全部内容,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • jQuery使用手册之一

    jQuery使用手册之一

    jQuery使用手册之一...
    2007-03-03
  • JQuery EasyUI的使用

    JQuery EasyUI的使用

    jQuery EasyUI 是一个基于 jQuery 的框架,集成了各种用户界面插件。接下来通过本文给大家介绍JQuery EasyUI的使用,对jquery easyui相关知识感兴趣的朋友一起学习吧
    2016-02-02
  • EasyUI修改DateBox和DateTimeBox的默认日期格式示例

    EasyUI修改DateBox和DateTimeBox的默认日期格式示例

    本篇文章主要介绍了EasyUI修改DateBox和DateTimeBox的默认日期格式示例,具有一定的参考价值,有兴趣的可以了解一下。
    2017-01-01
  • jquery 将当前时间转换成yyyymmdd格式的实现方法

    jquery 将当前时间转换成yyyymmdd格式的实现方法

    下面小编就为大家带来一篇jquery 将当前时间转换成yyyymmdd格式的实现方法。小编觉得挺不错的,现在就分享给大家,也给大家做个参考
    2016-06-06
  • 解决Jquery下拉框数据动态获取的问题

    解决Jquery下拉框数据动态获取的问题

    下面小编就为大家分享一篇解决Jquery下拉框数据动态获取的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-01-01
  • jquery的ajax从纯真网(cz88.net)获取IP地址对应地区名

    jquery的ajax从纯真网(cz88.net)获取IP地址对应地区名

    使用jquery的ajax,轻松从纯真网(cz88.net)获取IP地址对应地区名
    2009-12-12
  • jQuery实现可以控制图片旋转角度效果(附demo源码下载)

    jQuery实现可以控制图片旋转角度效果(附demo源码下载)

    这篇文章主要介绍了jQuery实现可以控制图片旋转角度效果,可实现通过下方的滑块拖动控制图片旋转的功能,涉及jQuery操作页面元素样式动态变换的技巧,并附带demo源码供读者下载,需要的朋友可以参考下
    2016-01-01
  • 详解JQuery基础动画操作

    详解JQuery基础动画操作

    这篇文章主要介绍了JQuery基础动画操作,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-04-04
  • jQuery学习笔记之jQuery动画效果

    jQuery学习笔记之jQuery动画效果

    本次学习分为两个文件的测试,第一个是基本动画,第二个是滑动和透明动画效果,分别如下
    2013-09-09
  • jquery 批量上传图片实现代码

    jquery 批量上传图片实现代码

    在网上一直找不到jquery上传图片的例子,今天由于工作需要,在网上找了很长时间,找到了一个不太完整的例子,自已又对其进行了修改,现在已经可以使用,但只限于IE,火狐下不能使用,因为火狐下得不到本地上传的图片路径,希望能对新手有所帮助.
    2010-01-01

最新评论