《<details>`/`<summary>` jQuery 插件技术文档

1. 安装指南

在开始使用 <details>/<summary> jQuery 插件之前，请确保您的项目中已经包含了 jQuery 库，版本要求为 1.9 或以上。如果您的项目使用的是 jQuery 1.8 或更早版本，请参考对应的插件版本。安装插件的方法如下：

• 下载插件文件 jquery.details.js。
• 将下载的文件放入您的项目中的合适位置。
• 在您的 HTML 页面中引入 jQuery 库和 jquery.details.js 文件。

<script src="path/to/jquery.min.js"></script>
<script src="path/to/jquery.details.js"></script>

请确保 jQuery 库的引入在 jquery.details.js 之前。

2. 项目的使用说明

在您的 JavaScript 代码中，可以通过调用 $('details').details(); 方法来激活 <details>/<summary> 元素的 polyfill。插件会自动检测浏览器是否原生支持 <details>/<summary> 元素，并相应地提供支持。

// Polyfill 所有 details 元素
$('details').details();

您可以使用 $.fn.details.support 来检测浏览器是否原生支持 <details>/<summary>：

// 检测是否原生支持 <details>/<summary>
console.log($.fn.details.support ? '原生支持' : '无原生支持');

此外，您可以为 details 元素添加 open.details 和 close.details 事件监听器，以便在元素展开或关闭时执行特定的操作：

$('details').on({
  'open.details': function() {
    console.log('已展开');
  },
  'close.details': function() {
    console.log('已关闭');
  }
});

如果需要移除与插件相关的所有事件监听器，可以使用以下代码：

$('details').off('.details');

3. 项目API使用文档

该插件提供以下API：

• $('details').details();: 激活 polyfill 功能。
• $.fn.details.support: 一个布尔值，用于检测浏览器是否原生支持 <details>/<summary>。

4. 项目安装方式

项目可以通过以下方式安装：

• 手动下载：直接从 GitHub 或其他源下载 jquery.details.js 文件，并将其引入到您的项目中。
• 包管理工具：如果您使用的是 npm 或其他包管理工具，可以通过相应的命令安装该插件（如果插件在对应仓库中可用）。

请确保按照上述安装指南正确集成插件，以确保其正常工作。