JS 刷新保持iframe页面并支持浏览器前进后退

fengyehongWorld

已于 2023-06-25 14:04:06 修改

阅读量1.8k

点赞数

分类专栏： # JS 文章标签： javascript ecmascript

于 2023-06-17 10:08:19 首次发布

本文链接：https://blog.csdn.net/feyehong/article/details/131256773

版权

JS 专栏收录该内容

52 篇文章 1 订阅

订阅专栏

文章讲述了在使用iframe和ajax时遇到的页面刷新后无法保持当前状态的问题，以及如何通过HTML5的history.pushState方法来解决这个问题。用户点击按钮切换iframe的src，但路径不会被记录到浏览器历史中，通过监听popstate事件和调整URL参数，实现了刷新页面后仍能保持之前的状态。

摘要由CSDN通过智能技术生成

参考资料

一. 遇到的问题

我们使用iframe嵌套自己系统的页面，但是浏览器刷新之后，无法保持当前打开的页面

在这里插入图片描述

二. 问题分析

⏹原因
之所以会刷新页面后无法保持住当前打开的页面，是因为浏览器地址栏的url始终是固定的，我们打开的页面改变的是iframe标签的src属性值，从而实现不同页面之间的切换。

⏹解决
在url的后面添加?name=当前画面id，当我们进入页面之后，根据name的参数值，来改变iframe标签，从而实现刷新后页面保持。

三. 代码示例

⏹登录页面，点击后登录到系统的首页

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <button id="login">点击登录系统</button>
</body>
<script>
    login.addEventListener("click", function() {
        location.replace("./03-2-系统页面.html?name=home");
    });
</script>
</html>

⏹主系统页面

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <style>
        #contanier {
            display: flex;
            justify-content: space-between;
        }
        iframe {
            /* 根据视口的宽度和高度计算iframe的宽和高 */
            width: calc(100vw - 150px);
            height: calc(100vh - 30px);
        }
    </style>
    <title>系统首页</title>
</head>
<body>
    <div id="contanier">
        <div id="menu">
            <li id="es6">ES6网站</li>
            <li id="css">css网站</li>
            <li id="java">java网站</li>
            <li id="php">php网站</li>
        </div>
        <div id="content">
            <iframe></iframe>
        </div>
    </div>
</body>
<script src="https://code.jquery.com/jquery-3.6.3.js"></script>
<script>
	// 页面的工具类
    class Utils {
		
		// 模拟从后台获取到的菜单栏以及其url
        static urlMap = new Map([
            ['es6', './03/02-es6.html'],
            ['css', './03/03-css.html'],
            ['java', './03/04-java.html'],
            ['php', './03/05-php.html'],
            ['home', './03/01-首页.html']
        ]);

        // 获取本页面不含参数的url
        static getUrl() {

            const {
                origin,
                pathname
            } = location;

            return origin + pathname;
        }

        // 获取url中指定的参数
        static getParamFromUrl(url, param) {
            return new URLSearchParams(new URL(url).search).get(param);
        }
    }

    $(function() {

        // 事件绑定
        eventBind();

        // 加载页面
        loadPage();
    });

    function eventBind() {

        // 当浏览器前进后退时,会触发popstate事件
        window.addEventListener("popstate", function(evnet) {
            loadPage();
        });

        $("#menu li").click(function(event, triggerFlg) {

            const pageId = this.id;
            reloadIframe(pageId);

            /*
                如果是用户手动点击触发,则将当前url添加到浏览器的history中
                如果是通过函数来触发的点击事件,则不将url添加到浏览器的history中
            */
            if(!triggerFlg) {
                history.pushState(null, "", `${Utils.getUrl()}?name=${pageId}`);
            }
        });
    }

    function loadPage() {
        
        const pageId = Utils.getParamFromUrl(location.href, "name");
        
        // 如果url中没有 ?name=对应的属性值,或者Utils.urlMap中没有pageId对应值的话
        if(!pageId || !Utils.urlMap.get(pageId)) {
            // 将当前 url + ?name=home 的路径替换到浏览器的history中
            history.replaceState(null, "", `${Utils.getUrl()}?name=home`);
            // 重载页面,此时url中的参数为?name=home
            loadPage();
            return;
        }
        
        // 如果当前是home页的话,就重载iframe标签
        if(pageId == "home") {
            reloadIframe(pageId);
            return;
        }

        /*
            手动触发点击事件
            第二个参数是为了在手动触发点击事件的时候传递一个参数
            传递此参数的目的是为了让点击事件的回调区分,当前点击事件是用户主动点击触发,
            还是通过函数来手动触发的
        */
        $("#" + pageId).trigger("click", true);
    }

    function reloadIframe(pageId) {
		
		// 或者可以用这种方式
		// document.querySelector("iframe").contentWindow.location.replace(Utils.urlMap.get(pageId));
		
        // 清空iframe标签
        $("#content").empty();
        
        // 创建新的iframe标签,并指定url
        $("<iframe>", {
            src: Utils.urlMap.get(pageId)
        }).appendTo($("#content"));
    }
</script>
</html>

四. 代码分析

在reloadIframe方法中，我们并不是直接修改的iframe标签的src属性，而是销毁掉既存的iframe标签，并新创建一个。如果直接修改src属性的话，src中的地址会直接存入history对象中，给浏览器前进后退功能带来影响。直接创建iframe标签，src中的地址并不会写入history对象中。
除了新创建iframe标签之外，我们还可以通过直接调用iframe标签内部的window对象中的location.replace()方法来实现地址切换。
由于新创建的iframe标签的src属性值并不会存入history对象中，因此我们需要手动调用history.pushState()这个api来存入到history对象中。
$("#menu li")上的点击事件可由用户主动点击触发，也可由window上的popstate事件手动触发，当是由popstate事件手动触发时，说明用户使用了浏览器的前进后退功能，此时不需要将url存储history中。