jQuery UI Controlgroup option() 方法

介绍

jQuery UI Controlgroup 是 jQuery UI 库中的一个组件库，它提供了一种将相关的表单元素组织在一个组中的方式。Controlgroup 组件可以让你在一组表单元素中实现按钮的样式，从而打造出一个漂亮的控件。

Controlgroup 插件通过选项（options）来提供了相当多的定制化配置，它的 option() 方法就是用来修改和读取它的选项的。

语法

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

• selector：必需，用来指定控件的元素。
• optionName：必需，用来指定要设置或读取值的选项的名称。
• value：可选，用来指定 optionName 的值。

参数

|参数|类型|描述| |---|---|---| |selector|string/Object|控件元素的选择器或 jQuery 对象。| |optionName|string|要设置或读取值的选项名称。| |value|any|要设置给 optionName 的值。|

返回值

如果通过该方法设置了选项的值，则返回 jQuery 对象；如果通过该方法读取了选项的值，则方法会返回选项的值。

示例

下面的例子展示了如何使用 option() 方法来设置和读取 Controlgroup 组件的选项。

<!-- HTML 代码 -->
<fieldset id="controlgroup" class="ui-controlgroup ui-controlgroup-vertical">
  <label>
    <input type="radio" name="radio1" id="radio1">Radio 1
  </label>
  <label>
    <input type="radio" name="radio1" id="radio2">Radio 2
  </label>
  <label>
    <input type="radio" name="radio1" id="radio3">Radio 3
  </label>
</fieldset>

// JavaScript 代码
// 设置选项
$("#controlgroup").controlgroup("option", {
  "direction": "horizontal",
  "disabled": true
});

// 读取选项
var direction = $("#controlgroup").controlgroup("option", "direction");
var disabled = $("#controlgroup").controlgroup("option", "disabled");

结论

Controlgroup 组件提供了许多有用的选项，它的 option() 方法可以帮助你设置和读取这些选项的值。如果你正在构建一个复杂的控件，会使用到 Controlgroup 组件，那么 option() 方法无疑是一个很有用的工具。