Skip to content

TagBox(标签框)

扩展自$.fn.iCombobox.defaults,使用$.fn.iTagbox.defaults重写默认值对象。

TagBox(标签框)扩展自combobox, 他包含combobox的所有功能。TagBox允许用户将输入内容显示在标签框中,而不是显示在输入框中。

依赖关系

用法

通过标签创建文本框。

html
<input data-toggle="topjui-tagbox" data-options="value:'Apple,Orange',label:'Add a tag',width:'100%'">

使用Javascript创建文本框。

html
<input id="tb" type="text">
javascript
$('#tb').iTagbox({
    width:300,
    label:'Add a tag',
    value:['Apple', 'Orange']
})

属性

标签框属性扩展自 combobox,标签框重写的属性如下:

属性名属性值类型描述默认值
hasDownArrowboolean定义是否显示向下的箭头false
tagFormatterfunction(value,row)该格式化器用于格式化返回值。见下方代码示例。
tagStylerfunction(value,row)该格式化器用于格式化标签样式,返回自定义标签样式字符串。见下方代码示例。

属性代码示例

tagFormatter属性示例:

javascript
$('#tb').iTagbox({
    tagFormatter: function(value,row){
        var opts = $(this).iTagbox('options');
        return row ? row[opts.textField] : value;
    }
});

tagStyler属性示例:

javascript
$('#tb').iTagbox({
    tagStyler: function(value){
        if (value == 3){
            return 'background:#ffd7d7;color:#c65353';
        } else if (value == 4){
            return 'background:#b8eecf;color:#45872c';
        }
    }
});

事件

事件扩展自 combobox,以下是新增的文本框事件。

事件名事件参数描述
onClickTagvalue在点击标签框的时候触发该事件。
onBeforeRemoveTagvalue在移除一个标签框之前触发,返回false则取消移除操作。
onRemoveTagvalue在移除标签框时触发。

方法

方法扩展自 combobox

基于最新稳定版jQuery EasyUI构建的前端框架