Yii2中PJAX容器需用Pjax::begin(['id' => 'xxx'])包裹内容，服务端通过Yii::$app->request->isPjax判断并renderPartial返回片段，前端绑定data-pjax或事件委托确保局部刷新生效。
Yii2中PJAX容器怎么写才不会整个页面跳转
关键不是“用不用PJAX”，而是容器是否被正确识别为PJAX可接管的响应目标。Yii2默认用 yii\widgets\Pjax，但它只对包裹在 Pjax::begin() 和 Pjax::end() 之间的内容生效，且要求服务器返回的是纯HTML片段（不含完整<html>结构）。
常见错误现象：点击链接后整个页面刷新、控制台报错 “pjax:timeout” 或 “pjax:send but no response”，多数是因为容器没绑定事件，或服务端返回了完整页面。
- 必须给
Pjax::begin()指定id，前端JS靠它定位刷新区域，例如：Pjax::begin(['id' => 'post-list']) - 所有触发刷新的操作（如链接、表单提交）必须放在该容器内，或显式通过
data-pjax属性绑定到该容器ID，比如：<a href="/post/index" data-pjax="#post-list">刷新列表</a> - 控制器动作里不能调用
$this->layout = false，而要用if (Yii::$app->request->isPjax) { $this->layout = false; }，否则非PJAX请求也会丢失布局
控制器里怎么判断是PJAX请求并返回正确内容
Yii2不自动区分PJAX和普通请求，得手动检查请求头。核心是 Yii::$app->request->isPjax 这个布尔值——它依赖 X-PJAX 请求头，由 pjax.js 自动带上，但前提是前端加载了正确的PJAX脚本且配置没覆盖掉header。
使用场景：列表页支持分页/筛选时，只更新内容区，不重绘导航栏或侧边栏。
- 务必在action开头加判断：
if (Yii::$app->request->isPjax) { return $this->renderPartial('index', ['models' => $models]); } -
renderPartial()是关键，它不渲染layout，也不执行view文件里的use yii\helpers\Html等全局初始化逻辑；而render()会套上完整layout，导致PJAX收到整页HTML后无法替换 - 如果用了自定义layout（比如
@app/views/layouts/ajax.php），确保它只输出body内容，不含<html>、<head>标签
为什么点了按钮没反应？检查这三个地方
最常卡在这三处，而不是代码逻辑本身。
-
web/assets/下的pjax.js是否成功加载？打开浏览器Network面板，过滤pjax，看是否有404。Yii2默认用AssetBundle管理，确认yii\web\JqueryAsset和yii\widgets\PjaxAsset已注册且未被禁用 - 表单提交时忘了加
data-pjax="1"或没包进Pjax::begin()容器——PJAX默认只劫持带data-pjax属性的a和form，不主动监听所有点击 - JS错误阻断了PJAX初始化：比如在视图里写了
<script>xxx.xxx is not a function</script>，会导致pjax.start事件根本没绑定，后续任何操作都无效
局部刷新后JavaScript失效怎么办
PJAX替换DOM后，原来绑定在旧节点上的事件监听器就丢了，新内容里的按钮、下拉框等交互直接“变哑”。这不是Yii2的问题，是原生DOM机制决定的。
性能影响：用事件委托比每个AJAX后重新绑定更轻量，避免内存泄漏和重复绑定。
- 不要在视图里写
$("#btn").on("click", ...)，改用委托：$(document).on("click", "#btn", ...)（注意：委托对象必须是长期存在的父节点，document最保险） - 如果必须初始化插件（如
select2），在PJAX回调里做：$(document).on("pjax:success", function() { $(".select2").select2(); }); - 避免在
view文件里直接写<script>块初始化组件，统一收口到布局文件或单独JS模块中，靠事件驱动
最容易被忽略的是：PJAX成功后，$(document).ready() 不会再次触发，所有依赖它的初始化代码都会失效。别指望“页面加载完就自动跑一遍”。
