jQuery UI Controlgroup option(optionName, value) 方法

概述

option(optionName, value) 方法是 jQuery UI Controlgroup 插件提供的一种用于设置控制组件的选项值的方法。该方法允许程序员在运行时动态地更改控制组件的行为和样式。

语法

$(selector).controlgroup("option", optionName, value);

• selector: 控制组件的选择器表达式或 DOM 元素。
• optionName: 需要设置或修改的选项名。
• value: 选项的新值。

参数

optionName 和 value 参数取决于所要设置或修改的选项，可以是以下之一：

• disabled: 若设置为 true，则禁用控制组件，若设置为 false，则启用控制组件。默认值为 false。

• items: 指定控制组件中一组子元素（如按钮、复选框等）的选择器表达式。默认值为 "*"，即所有子元素。

• onlyIcons: 若设置为 true，则控制组件中的按钮仅显示图标，若设置为 false，则同时显示文本和图标。默认值为 false。

• classes: 定义控制组件使用的 CSS 类名，以自定义控制组件的样式。默认为空字符串。

• direction: 指定控制组件中的子元素排列方向。可选值有 "vertical" 和 "horizontal"，分别表示垂直和水平排列。默认值为 "vertical"。

• isRadio: 若设置为 true，则控制组件中的子元素被视为单选按钮，若设置为 false，则视为复选框。默认值为 false。

注：上述参数仅为常见选项，实际可用选项可能更多，具体以对应文档为准。

返回值

该方法没有返回值，可以链式调用。

示例

以下示例演示如何使用 option(optionName, value) 方法来动态设置控制组件的选项值：

// 设置控制组件的 items 选项
$("#myControlGroup").controlgroup("option", "items", ".myButtons");

// 设置控制组件的 disabled 选项
$("#myControlGroup").controlgroup("option", "disabled", true);

// 设置控制组件的只显示图标
$("#myControlGroup").controlgroup("option", "onlyIcons", true);

参考链接

• jQuery UI Controlgroup Widget - Methods