Discuz!X 源码分析之 ajaxget() 函数

左右不逢缘 · 发表于 2023-7-24 18:43:35

马上注册，免费下载更多dz插件网资源。

您需要登录才可以下载或查看，没有账号？立即注册

×

函数简介：ajaxget() 函数与 ajaxpost() 一样，都是是 Discuz!X 系统中很重要的函数，是 Discuz!X 系统中实现 Ajax 功能的重要组成部分，在整个源码中有上百次调用，掌握 ajaxget 的工作原理和使用方法对于理解 Discuz!X 系统的 Ajax 机制和针对 Discuz!X 系统的二次开发都将大有裨益。下文将为您讲解 ajaxpost 的工作原理。

函数原型：function ajaxget(url, showid, waitid, loading, display, recall)
所属文件：common.js

参数说明及示例关键代码：
url：（必填）请求的url；
showid：（必填）ajax 返回信息显示区域的 id；
waitid：ajax 请求过程中显示等待信息区域的 id；默认与showid相同
loading：在等待区域显示的提现信息，比如：“请稍后...”
display：信息返回后 showId 的 style.display 值，就是指定返回信息是否显示的
recall：信息返回后执行的代码。

ajaxget() 函数在整个 Discuz!X 中有很多处调用！粗略统计了一下，ajaxget() 和 ajaxpost() 均有100多处调用！在模版文件中一般是直接调用，在js文件中一般是间接调用。

最简单的 ajaxget() 调用的例子就是用户登录以后，在用户名后面那个“切换在线状态”的功能！即登录后处于在线状态，点击“在线”后，就切换到“隐身”状态，在点击“隐身”则又可以切换回“在线”状态。代码如下：

<span id="loginstatus"> <a id="loginstatusid" href="member.php?mod=switchstatus" title="切换在线状态" onclick="ajaxget(this.href, 'loginstatus');return false;" class="xi2">在线</a></span>

复制代码

1、当用户点击“在线”的时候，将触发调用 ajaxget()，而标签 A 是不会跳转，因为 onclick 事件获得了一个 false的返回值！

2、进入 ajaxget() 函数内部处理流程，第一步便是创建 Ajax 对象！关于 Ajax 对象的更多内容，可以参考 Ajax() 函数过程。

3、设置好相关参数以后，ajaxget 调用 Ajax 对象方法 get()，执行流程将转入 Ajax.get() 执行！代码如下：

x.get(url, function(s, x){...});

复制代码

url 是 ajaxget 提交的 url，根据 Ajax.get() 定义可知，当 Ajax 调用返回时，将调用 function(s,x)；

4、进入 Ajax.get() 函数处理流程，服务器返回的 Ajax 信息将保存在对象中，并返回给 ajaxget 指定的函数，即 function(s,x)；

5、在 function(s,x) 中，将首先将返回信息中的TEXT部分直接保存在 $('showid').innerHTML 中，然后将附带的 js 脚本添加到 <head> 部分并执行，完成动态修改在线状态，或者其他内容，添加的 js 脚本代码如下：

<script type="text/javascript" id="cbbLYGtmoPqvpWrwoymULIJQFPrvolFH" charset="GBK">if(typeof succeedhandle_=='function') {succeedhandle_('http://localhost/forum.php', '隐身', {});}</script>

复制代码

ajaxget() 的核心内容，其实在 Ajax() 中，通过读源码，我们可以知道，其实 Ajax 还能实现 post 方式的交互，但是正如之前我们知道的，ajaxpost() 不是通过 Ajax() 来实现的，而是使用了 iframe 的方法！

©DZ插件网所发布的一切资源仅限用于学习和研究目的；不得将上述内容用于商业或者非法用途，否则，一切后果请用户自负。
本站内容为站长个人技术研究记录或网络，不提供用户交互功能，所有内容版权归原作者所有。您必须在下载后的24个小时之内，从您的电脑中彻底删除上述内容。如果您喜欢该程序，请支持正版软件，得到更好的正版服务。
您在本站任何的赞助购买、下载、查阅、回复等行为等均表示接受并同意签订《DZ插件网免责声明协议》。
如有侵权请邮件与我们联系处理: discuzaddons@vip.qq.com 并出示相关证明以便删除。敬请谅解！

Discuz智能体 · 发表于 2025-3-18 04:12:35

`ajaxget()` 函数是 Discuz!X 系统中用于实现 Ajax GET 请求的核心函数之一。它通过异步请求从服务器获取数据，并将返回的内容动态更新到页面的指定区域。以下是对 `ajaxget()` 函数的详细分析及其工作原理的深入讲解。

### 函数原型

function ajaxget(url, showid, waitid, loading, display, recall)

复制代码

- **url**（必填）：请求的 URL 地址。
- **showid**（必填）：用于显示 Ajax 返回信息的 HTML 元素的 ID。
- **waitid**：在 Ajax 请求过程中显示等待信息的 HTML 元素的 ID，默认与 `showid` 相同。
- **loading**：在等待区域显示的提示信息，例如“请稍后...”。
- **display**：信息返回后 `showid` 元素的 `style.display` 值，用于控制返回信息的显示方式。
- **recall**：信息返回后需要执行的 JavaScript 代码。

### 函数工作原理
1. **创建 Ajax 对象**
`ajaxget()` 函数的第一步是创建一个 Ajax 对象。这个对象负责处理与服务器的异步通信。Ajax 对象的创建是通过 `Ajax()` 构造函数实现的。

2. **设置请求参数**
在创建 Ajax 对象后，`ajaxget()` 会设置请求的 URL 和其他相关参数。这些参数包括：
- `url`：请求的目标地址。
- `showid`：用于显示返回信息的 HTML 元素。
- `waitid`：显示等待信息的 HTML 元素。
- `loading`：等待时显示的提示信息。
- `display`：控制返回信息的显示方式。
- `recall`：请求完成后需要执行的 JavaScript 代码。

3. **发起 GET 请求**
通过调用 Ajax 对象的 `get()` 方法，`ajaxget()` 发起一个 GET 请求。`get()` 方法的定义如下：

x.get(url, function(s, x) {
// 处理返回的数据
});

复制代码

其中，`url` 是请求的目标地址，`function(s, x)` 是请求完成后的回调函数。

4. **处理服务器返回的数据**
当服务器返回数据时，回调函数 `function(s, x)` 会被执行。在这个函数中，返回的数据会被解析并更新到 `showid` 指定的 HTML 元素中。具体步骤如下：
- 将返回的文本内容直接赋值给 `$('showid').innerHTML`。
- 如果返回的数据中包含 JavaScript 代码，这些代码会被动态添加到页面中并执行。

5. **执行回调函数**
如果 `recall` 参数被指定，那么在数据更新完成后，`recall` 中的 JavaScript 代码会被执行。这通常用于在 Ajax 请求完成后执行一些额外的操作。

### 示例代码分析
以下是一个简单的 `ajaxget()` 调用示例，用于实现用户在线状态的切换：

<a href="javascript:;" onclick="ajaxget('switchstatus.php', 'status'); return false;">在线</a>

复制代码

- 当用户点击“在线”链接时，`ajaxget()` 函数会被调用。
- `switchstatus.php` 是请求的目标 URL，`status` 是用于显示返回信息的 HTML 元素的 ID。
- `return false;` 阻止了链接的默认跳转行为。

### 核心逻辑
`ajaxget()` 的核心逻辑在于它通过 `Ajax()` 对象实现了异步 GET 请求，并将返回的数据动态更新到页面中。与 `ajaxpost()` 不同，`ajaxget()` 使用的是标准的 Ajax 技术，而不是通过 iframe 实现的。

### 总结
`ajaxget()` 是 Discuz!X 系统中非常重要的一个函数，它简化了 Ajax GET 请求的实现过程，使得开发者可以轻松地在页面中实现异步数据更新。通过理解 `ajaxget()` 的工作原理，开发者可以更好地进行 Discuz!X 系统的二次开发，并实现各种复杂的 Ajax 功能。

如果你有更多关于 `ajaxget()` 或其他 Discuz!X 开发相关的问题，欢迎随时提问！
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。