fix(tabs): 优化 close 方法在标签顺序打乱时传入 lay-id 的支持 (#2690)

* fix(tabs): 优化 close 方法在标签顺序打乱时传入 lay-id 的支持

* fix(tabs): 优化 closeMult 方法 index 参数值为 lay-id 时的无效问题

* fix(tabs): 优化 `getHeaderItem` 等方法的 `index` 参数的类型检测
pull/2734/head
贤心 2025-06-17 15:09:36 +08:00 committed by GitHub
parent ac8d5ccc30
commit 1eb01c6706
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 95 additions and 54 deletions

View File

@ -136,7 +136,7 @@ tabs.add('test', {
`tabs.close(id, index, force)`
- 参数 `id` : 组件的实例 ID
- 参数 `index` : 标签索引或标签的 `lay-id` 属性值
- 参数 `index` : 若传入 number 类型,则为标签索引;若传入 string 类型,则为标签的 `lay-id` 属性值
- 参数 `force` : 是否强制关闭。若设置 `true` 将忽略 `beforeClose` 事件行为。默认 `false`
该方法用于关闭指定的标签项。
@ -156,19 +156,23 @@ tabs.close('test', 'abc'); // 关闭 lay-id="abc" 的标签
| mode | 描述 |
| --- | --- |
| other | 关闭除当前标签外的所有标签 |
| right | 关闭当前标签及右侧标签 |
| other | 关闭除当前标签外的其他标签 |
| right | 关闭当前标签的右侧所有标签 |
| all | 关闭所有标签 |
- 参数 `index` : 活动标签的索引或 `lay-id` 属性值,默认取当前选中标签的索引。一般用于标签右键事件。
该方法用于批量关闭标签。
该方法用于批量关闭标签,若标签项已设置不允许关闭(`lay-closable="false"`),则操作将被忽略
```js
tabs.closeMult(id, 'other'); // 关闭除当前标签外的所有标签
tabs.closeMult(id, 'other', 3); // 关闭除索引为 3 的标签外的所有标签
tabs.closeMult(id, 'right'); // 关闭当前标签及右侧标签
tabs.closeMult(id, 'other'); // 关闭除当前活动标签外的其他标签
tabs.closeMult(id, 'other', 3); // 关闭除索引为 3 的标签外的其他标签
tabs.closeMult(id, 'other', 'ccc'); // 关闭除 lay-id="ccc" 的标签外的其他标签
tabs.closeMult(id, 'right'); // 关闭当前活动标签的右侧所有标签
tabs.closeMult(id, 'right', 3); // 关闭索引为 3 的标签的右侧所有标签
tabs.closeMult(id, 'right', 'ccc'); // 关闭 lay-id="ccc" 的标签的右侧所有标签
tabs.closeMult(id, 'all'); // 关闭所有标签
```
@ -220,7 +224,7 @@ console.log(data);
`tabs.getHeaderItem(id, index)`
- 参数 `id` : 组件的实例 ID
- 参数 `index` : 标签索引或标签的 `lay-id` 属性值
- 参数 `index` : 若传入 number 类型,则为标签索引;若传入 string 类型,则为标签的 `lay-id` 属性值
该方法用于获取标签头部项元素。
@ -234,7 +238,7 @@ var headerItem = tabs.getHeaderItem('test', 'abc'); // 获取 lay-id="abc" 的
`tabs.getBodyItem(id, index)`
- 参数 `id` : 组件的实例 ID
- 参数 `index` : 标签索引或标签的 `lay-id` 属性值 <sup>2.11.2+</sup>
- 参数 `index` : 若传入 number 类型,则为标签索引;若传入 string 类型,则为标签的 `lay-id` 属性值 <sup>2.11.2+</sup>
该方法用于获取标签内容项元素。

View File

@ -90,6 +90,26 @@
</div>
</div>
<h2>打乱标签顺序:</h2>
<div class="layui-tabs" lay-options="{closable: true}">
<ul class="layui-tabs-header">
<li lay-id="fff">Tab6</li>
<li lay-id="eee">Tab5</li>
<li lay-id="ccc">Tab3</li>
<li lay-id="bbb">Tab2</li>
<li lay-id="aaa">Tab1</li>
<li lay-id="ddd">Tab4</li>
</ul>
<div class="layui-tabs-body">
<div class="layui-tabs-item" lay-id="aaa">Tab Content-1</div>
<div class="layui-tabs-item" lay-id="bbb">Tab Content-2</div>
<div class="layui-tabs-item" lay-id="ccc">Tab Content-3</div>
<div class="layui-tabs-item" lay-id="ddd">Tab Content-4</div>
<div class="layui-tabs-item" lay-id="eee">Tab Content-5</div>
<div class="layui-tabs-item" lay-id="fff">Tab Content-6</div>
</div>
</div>
<h2>标签 HASH 定位</h2>
<div class="layui-tabs layui-hide-v" id="demoTabs-hash">
<ul class="layui-tabs-header">
@ -267,6 +287,8 @@
}],
click: function(data, othis, event) {
var index = this.elem.index(); // 获取活动标签索引
var layid = this.elem.attr('lay-id');
// 新增标签操作
if (data.action === 'add') {
// 在当前活动标签右侧新增标签页

View File

@ -232,10 +232,9 @@ layui.define('component', function(exports) {
var that = this;
var options = that.config;
var layid = thisHeaderItem.attr('lay-id');
var index = thisHeaderItem.index();
if (!thisHeaderItem[0]) return;
// 标签是否不可关闭
if (thisHeaderItem.attr('lay-closable') === 'false') {
return;
@ -251,7 +250,7 @@ layui.define('component', function(exports) {
component.CONST.MOD_NAME,
'beforeClose('+ options.id +')',
$.extend(data, {
index: thisHeaderItem.index()
index: index
})
);
@ -271,8 +270,8 @@ layui.define('component', function(exports) {
}
// 移除元素
that.findBodyItem(layid || index).remove();
thisHeaderItem.remove();
that.findBodyItem(index).remove();
that.roll('auto', index);
@ -304,14 +303,9 @@ layui.define('component', function(exports) {
index = index === undefined ? data.index : index;
// 将标签头 lay-closable 属性值同步到 body 项
headers.each(function(i) {
var othis = $(this);
var closableAttr = othis.attr('lay-closable');
if (closableAttr) {
bodys.eq(i).attr('lay-closable', closableAttr);
}
});
var headerItem = that.findHeaderItem(index);
var bodyItem = that.findBodyItem(index);
var itemIndex = headerItem.index();
// 若当前选中标签也允许关闭,则尝试寻找不可关闭的标签并将其选中
if (data.thisHeaderItem.attr('lay-closable') !== 'false') {
@ -323,23 +317,34 @@ layui.define('component', function(exports) {
} else if(prevHeader[0]) {
that.change(prevHeader, true);
}
} else if(index !== data.index) { // 自动切换到活动标签(功能可取消)
that.change(that.findHeaderItem(index), true);
} else if(index !== data.index) { // 自动切换到活动标签
that.change(headerItem, true);
}
}
// 执行批量关闭标签
if (mode === 'other') { // 关闭其他标签
headers.eq(index).siblings(FILTER).remove();
bodys.eq(index).siblings(FILTER).remove();
} else if(mode === 'right') { // 关闭右侧标签
headers.filter(':gt('+ index +')'+ FILTER).remove();
bodys.filter(':gt('+ index +')'+ FILTER).remove();
} else { // 关闭所有标签
headers.filter(FILTER).remove();
bodys.filter(FILTER).remove();
headers.each(function(i) {
var $this = $(this);
var layid = $this.attr('lay-id');
var bodyItem = that.findBodyItem(layid || i);
// 标签是否不可关闭
if ($this.attr('lay-closable') === 'false') {
return;
}
// 批量关闭方式
var isCloseOther = mode === 'other' && i !== itemIndex; // 关闭其他标签
var isCloseRight = mode === 'right' && i > itemIndex; // 关闭右侧标签
var isCloseLeft = mode === 'left' && i < itemIndex; // 关闭左侧标签(不推荐)
var isCloseAll = mode === 'all'; // 关闭所有标签
if (isCloseOther || isCloseRight || isCloseLeft || isCloseAll) {
$this.remove();
bodyItem.remove();
}
});
that.roll('auto');
// 回调
@ -365,7 +370,8 @@ layui.define('component', function(exports) {
var that = this;
var options = that.config;
var index = thisHeaderItem.attr('lay-id') || thisHeaderItem.index();
var layid = thisHeaderItem.attr('lay-id');
var index = thisHeaderItem.index();
var thatA = thisHeaderItem.find('a');
// 是否存在跳转链接
var isLink = typeof thatA.attr('href') === 'string' && thatA.attr('target') === '_blank';
@ -392,7 +398,7 @@ layui.define('component', function(exports) {
headerItem: data.thisHeaderItem
},
to: {
index: thisHeaderItem.index(),
index: index,
headerItem: thisHeaderItem
}
})
@ -409,7 +415,7 @@ layui.define('component', function(exports) {
.removeClass(component.CONST.CLASS_THIS);
// 执行标签内容切换
that.findBodyItem(index).addClass(component.CONST.CLASS_SHOW)
that.findBodyItem(layid || index).addClass(component.CONST.CLASS_SHOW)
.siblings().removeClass(component.CONST.CLASS_SHOW);
that.roll('auto', index);
@ -467,7 +473,11 @@ layui.define('component', function(exports) {
opts = opts || {};
// 不可关闭项
if (opts.closable == false || headerItem.attr('lay-closable') === 'false') {
if (opts.closable == false) {
headerItem.attr('lay-closable', 'false');
}
if (headerItem.attr('lay-closable') === 'false') {
return;
}
@ -652,30 +662,35 @@ layui.define('component', function(exports) {
Class.prototype.findHeaderItem = function(index) {
var container = this.getContainer();
var headerItems = container.header.items;
var headerItem = headerItems.filter('[lay-id="'+ index +'"]');
return headerItem[0] ? headerItem : headerItems.eq(index);
// 根据 lay-id 匹配
if (typeof index === 'string') {
return headerItems.filter('[lay-id="'+ index +'"]');
}
return headerItems.eq(index);
};
/**
* 获取标签内容项
* @param {number} index - 标签索引或 lay-id
* @param {number|string} index - 标签索引或 lay-id
*/
Class.prototype.findBodyItem = function(index) {
var container = this.getContainer();
var bodyItems = container.body.items;
var bodyItem = bodyItems.filter('[lay-id="'+ index +'"]');
// 根据 lay-id 匹配
if (typeof index === 'string') {
var bodyItem = bodyItems.filter('[lay-id="'+ index +'"]');
return bodyItem[0] ? bodyItem : function() {
// 若未匹配到 lay-id 对应内容项,则继续匹配对应头部项
// 若未匹配到 lay-id 对应内容项,则通过对应头部项的索引匹配内容
var headerItems = container.header.items;
var headerItem = headerItems.filter('[lay-id="'+ index +'"]');
if (headerItem[0]) {
index = headerItem.index();
return bodyItems.eq(headerItem.index());
}();
}
return bodyItems.eq(index);
}();
};
/**
@ -734,10 +749,10 @@ layui.define('component', function(exports) {
* @param {('other'|'right'|'all')} [mode="all"] - 关闭方式
* @param {number} index - 活动标签的索引默认取当前选中标签的索引一般用于标签右键事件
*/
closeMult: function(id, mode, index, force) {
closeMult: function(id, mode, index) {
var that = component.getInst(id);
if(!that) return;
that.closeMult(mode, index, force);
that.closeMult(mode, index);
},
/**