jQWidgets jqxButtonGroup setSelection() 方法介绍

概述

setSelection(index) 方法用于设置 jqxButtonGroup 控件的选中项。该选中项可以是 0 到 n-1（n 为按钮数量）之间的整数。可以通过该方法动态更改选中项，而不需要用户交互。

语法

$('#jqxButtonGroup').jqxButtonGroup('setSelection', index);

参数

• index：选中项的索引，该索引必须在 0 到 n-1 之间。

返回值

该方法没有返回值。

示例

$(document).ready(function () {
  let buttonGroup = $("#jqxButtonGroup") // 获取 jqxButtonGroup 控件对象
  buttonGroup.jqxButtonGroup({ mode: 'radio' }) // 设置按钮组模式为单选
});
buttonGroup.jqxButtonGroup('setSelection', 1) // 设置选中项为索引为 1 的按钮

注意事项

• 如果按钮组模式为默认的复选模式，则可以同时选中多个按钮，此时 setSelection() 只能设置一个按钮为选中状态，其余按钮将被取消选中。
• 确认索引是否存在，如果传入的索引超出范围，将会导致错误。
• setSelection() 方法并不会触发任何事件，如果需要触发事件，请使用 checkAtIndex() 或 uncheckAtIndex() 方法。
• 如果需要获取选中项的索引，请使用 getCheckedIndexes() 方法。

参考文献

• jQWidgets Documentation - jqxButtonGroup