HTML 5 History API

時間 2019-11-07

標籤 html history api 欄目 HTML 简体版

原文原文鏈接

原文：An Introduction To The HTML5 History APIjavascript

譯文：關於HTML 5 History API 的介紹html

譯者：dwqsjava

History是有趣的，不是嗎？在以前的HTML版本中，咱們對瀏覽歷史記錄的操做很是有限。咱們能夠來回使用可使用的方法，但這就是一切咱們能作的了。api

可是，利用HTML 5的History API，咱們能夠更好的控制瀏覽器的歷史記錄了。例如：咱們能夠添加一條記錄到歷史記錄的列表中，或者在沒有刷新時，能夠更新地址欄的URL。瀏覽器

爲何介紹History API ？

在這篇文章中，咱們將瞭解HTML 5中History API的來源。在此以前，咱們常用散列值來改變頁面內容，特別是那些對頁面特別重要的內容。由於沒有刷新，因此對於單頁面應用，改變其URL是不可能的。此外，當你改變URL的散列值值，它對瀏覽器的歷史記錄沒有任何影響。服務器

而後，如今對於HTML 5的History API來講，這些都是能夠輕易實現的，可是因爲單頁面應用不必使用散列值，它可能須要額外的開發腳本。它也容許咱們用一種對SEO友好的方式創建新應用。此外，它能減小帶寬，可是該怎麼證實呢？this

在文章中，我將用History API開發一個單頁應用來證實上述的問題。編碼

這也意味着我必須先在首頁加載必要的資源。如今開始，頁面僅僅加載須要的內容。換句話說，應用並非一開始就加載了所有的內容，在請求第二個應用內容時，纔會被加載。url

注意,您須要執行一些服務器端編碼只提供部分資源,而不是完整的頁面內容。spa

瀏覽器支持

在寫這篇文章的時候，各主流瀏覽器對History API的支持是很是不錯的，能夠點擊此處查看其支持狀況，這個連接會告訴你支持的瀏覽器，並使用以前，總有良好的實踐來檢測支持的特定功能。

爲了用變成方式肯定瀏覽器是否支持這個API，能夠用下面的一行代碼檢驗：

return !!(window.history && history.pushState);

此外,我建議參考一下這篇文章:Detect Support for Various HTML5 Features.(譯文：http://www.ido321.com/1116.html)

若是你是用的現代瀏覽器，能夠用下面的代碼：

if (Modernizr.history) {
    // History API Supported
}

若是你的瀏覽器不支持History API，可使用history.js代替。

使用History

HTML 5提供了兩個新方法：

一、history.pushState(); 二、history.replaceState();

兩種方法都容許咱們添加和更新歷史記錄，它們的工做原理相同而且能夠添加數量相同的參數。除了方法以外，還有popstate事件。在後文中將介紹怎麼使用和何時使用popstate事件。

pushState()和replaceState()參數同樣，參數說明以下：

一、state：存儲JSON字符串，能夠用在popstate事件中。

二、title：如今大多數瀏覽器不支持或者忽略這個參數，最好用null代替

三、url：任意有效的URL，用於更新瀏覽器的地址欄，並不在意URL是否已經存在地址列表中。更重要的是，它不會從新加載頁面。

兩個方法的主要區別就是：pushState()是在history棧中添加一個新的條目，replaceState()是替換當前的記錄值。若是你還對這個有迷惑，就用一些示例來證實這個區別。

假設咱們有兩個棧塊，一個標記爲1,另外一個標記爲2，你有第三個棧塊，標記爲3。當執行pushState()時，棧塊3將被添加到已經存在的棧中，所以，棧就有3個塊棧了。

一樣的假設情景下，當執行replaceState()時，將在塊2的堆棧和放置塊3。因此history的記錄條數不變，也就是說，pushState()會讓history的數量加1.
比較結果以下圖：

到此，爲了控制瀏覽器的歷史記錄，咱們忽略了pushState()和replaceState()的事件。可是假設瀏覽器統計了許多的不良記錄，用戶可能會被重定向到這些頁面，或許也不會。在這種狀況下，當用戶使用瀏覽器的前進和後退導航按鈕時就會產生意外的問題。

儘管當咱們使用pushState()和replaceState()進行處理時，期待popstate事件被觸發。但實際上，狀況並非這樣。相反，當你瀏覽會話歷史記錄時，無論你是點擊前進或者後退按鈕，仍是使用history.go和history.back方法，popstate都會被觸發。

In WebKit browsers, a popstate event would be triggered after document’s onload event, but Firefox and IE do not have this behavior.（在WebKit瀏覽器中，popstate事件在document的onload事件後觸發，Firefox和IE沒有這種行爲）。

Demo示例

HTML：

<div class="container">
    <div class="row">
        <ul class="nav navbar-nav">
            <li><a href="home.html" class="historyAPI">Home</a></li>
            <li><a href="about.html" class="historyAPI">About</a></li>
            <li><a href="contact.html" class="historyAPI">Contact</a></li>
        </ul>
    </div>
    <div class="row">
        <div class="col-md-6">
            <div class="well">
                Click on Links above to see history API usage using <code>pushState</code> method.
            </div>
        </div>
        <div class="row">   
            <div class="jumbotron" id="contentHolder">
                <h1>Home!</h1>
                <p>Lorem Ipsum is simply dummy text of the printing and typesetting industry.</p>
            </div>
        </div>
    </div>
</div>

JavaScript：

<script type="text/javascript">
    jQuery('document').ready(function(){

        jQuery('.historyAPI').on('click', function(e){
            e.preventDefault();
            var href = $(this).attr('href');

            // Getting Content
            getContent(href, true);

            jQuery('.historyAPI').removeClass('active');
            $(this).addClass('active');
        });

    });

    // Adding popstate event listener to handle browser back button 
    window.addEventListener("popstate", function(e) {

        // Get State value using e.state
        getContent(location.pathname, false);
    });

    function getContent(url, addEntry) {
        $.get(url)
        .done(function( data ) {

            // Updating Content on Page
            $('#contentHolder').html(data);

            if(addEntry == true) {
                // Add History Entry using pushState
                history.pushState(null, null, url);
            }

        });
    }
</script>