在 jQuery Mobile 中创建水平选择控制组

front end technologyweb developmentjquery更新于 2026/1/23 9:22:17

水平选择控制组是一个界面组件,允许用户从水平呈现的一系列选项中进行选择。

步骤 1:将 jQuery Mobile 添加到您的项目中

创建水平选择控制组的第一步是将 jQuery Mobile 添加到您的项目中。jQuery Mobile 的最新版本可以直接添加到您的 HTML 页面,也可以通过内容分发网络 (CDN) 来实现。

算法

  • 从给定的 CDN URL 加载 jQuery Mobile CSS 文件

  • 从给定的 CDN URL 加载 jQuery 库

  • 从给定的 CDN URL 加载 jQuery Mobile JS 文件

示例

<!-- Include jQuery Mobile CSS -->
<link rel="stylesheet" href="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">

<!-- Include jQuery Mobile JS -->
<script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
<script src="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>

步骤 2:创建水平选择控件组

将 jQuery Mobile 添加到项目后,使用 HTML 标记添加水平选择控件组。

算法

  • 将 data-role 属性设置为"controlgroup",将 data-type 属性设置为"horizo​​ntal",以此标识容器元素。

  • 在容器元素内创建子元素来表示各个选项。

  • 为每个选项创建一个具有以下属性的元素:

    • 将 href 属性设置为链接 URL(在本例中为"#")。

    • 将 class 属性设置为"ui-btn ui-corner-all ui-shadow"。

    • 表示选项的文本内容标签。

    • 对每个选项重复步骤 3。

    • 将元素作为子元素放置在容器元素内。

    • 使用 CSS 根据需要设置选项和容器元素的样式。

示例

<div data-role="controlgroup" data-type="horizontal">
  <a href="#" class="ui-btn ui-corner-all ui-shadow" data-icon="star">Option 1</a>
  <a href="#" class="ui-btn ui-corner-all ui-shadow" data-icon="check">Option 2</a>
  <a href="#" class="ui-btn ui-corner-all ui-shadow">Option 3</a>
  <a href="#" class="ui-btn ui-corner-all ui-shadow">Option 4</a>
  <a href="#" class="ui-btn ui-corner-all ui-shadow">Option 5</a>
</div>

步骤 3:初始化水平选择控件组

我们必须使用 JavaScript 启动水平选择控件组才能使其正常工作。

算法

  • 创建或加载文档时,将调用该函数。

  • 该函数选择所有 data-role 属性等于"controlgroup"的 div 元素。

  • 在选定元素上调用"controlgroup()"函数来初始化控件组。

  • 在控件组上调用"container()"方法来检索其容器元素。

  • 在容器元素上调用"enhanceWithin()"方法来增强其子元素。

  • 在增强的容器元素上调用"css()"方法,将其 width 属性设置为100%。

示例

$(document).on("pagecreate", function() {
$("div[data-role='controlgroup']").controlgroup().controlgroup("container").enhanceWithin().css("width", "100%");
});

结论

为了获得最佳用户体验,必须考虑某些限制条件。

  • 每个选项的宽度必须相等,以保持一致的显示。

  • 选项数量应限制在可用的屏幕空间内,以避免重叠和滚动。

  • 建议在较大的屏幕上使用水平选择控件组,而不是在较小的屏幕上。

  • 在各种设备和屏幕尺寸上进行全面测试对于确保控件组响应迅速且正常运行至关重要。

牢记这些限制,开发者可以创建水平选择控件组,从而增强其移动 Web 应用程序的可用性和功能性。