jQuery Actual 插件技术文档

1. 安装指南

首先，确保您的页面使用了有效的 DOCTYPE 声明。接着，在页面中包含必要的 JavaScript 文件。

<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.5.1/jquery.min.js"></script>
<script type="text/javascript" src="path-to-file/jquery.actual.js"></script>

请将 path-to-file/jquery.actual.js 替换为您下载的 jquery.actual.js 文件的路径。

2. 项目的使用说明

jQuery Actual 插件用于获取不可见 DOM 元素的实际宽度或高度。当元素或其父元素的 CSS 属性 display 设置为 none 时，使用 jQuery 的 .width() 方法将返回 0，而不是实际宽度。此插件解决了这个问题。

使用示例

• 获取隐藏元素的实际宽度：

$( '.hidden' ).actual( 'width' );

• 获取隐藏元素的实际 innerWidth：

$( '.hidden' ).actual( 'innerWidth' );

• 获取隐藏元素的实际 outerWidth：

$( '.hidden' ).actual( 'outerWidth' );

• 获取隐藏元素的实际 outerWidth 并设置 includeMargin 参数：

$( '.hidden' ).actual( 'outerWidth', { includeMargin : true });

• 获取隐藏元素的实际高度：

$( '.hidden' ).actual( 'height' );

• 获取隐藏元素的实际 innerHeight：

$( '.hidden' ).actual( 'innerHeight' );

• 获取隐藏元素的实际 outerHeight：

$( '.hidden' ).actual( 'outerHeight' );

• 获取隐藏元素的实际 outerHeight 并设置 includeMargin 参数：

$( '.hidden' ).actual( 'outerHeight', { includeMargin : true });

• 如果页面跳跃或闪烁，传递一个 { absolute : true } 属性。请谨慎使用，您可能会根据您的 HTML 和 CSS 编码方式得到错误的结果：

$( '.hidden' ).actual( 'height', { absolute : true });

• 如果您使用 css3pie 并且有一个浮动元素（例如圆角导航菜单），您可以尝试传递一个 { clone : true } 属性。请查看 demo/css3pie 的实际效果：

$( '.hidden' ).actual( 'width', { clone : true });

• 如果元素不是块级元素，默认 { display: 'block' }。例如，对于行内元素：

$( '.hidden' ).actual( 'width', { display: 'inline-block' });

3. 项目API使用文档

请参考上述使用说明中的示例代码来了解如何使用 jQuery Actual 插件的 API。

4. 项目安装方式

请遵循安装指南中的步骤，确保您的页面使用了有效的 DOCTYPE 声明，并包含必要的 JavaScript 文件。