safeArea

頁面不被其它內(nèi)容（如狀態(tài)欄）遮住的區(qū)域，JSON對象

通過safeArea能夠知道當前頁面哪些地方被遮住，從而做出相應(yīng)的調(diào)整，保證頁面重要元素不被遮擋住。

比如應(yīng)對頂部header被狀態(tài)欄遮住一部分，可以為header增加一個paddingTop，如：

header.style.paddingTop = api.safeArea.top + 'px';

在比如在iPhone X上面，底部的導(dǎo)航菜單會被虛擬Home鍵遮住一部分，可以為footer增加一個paddingBottom，如：

footer.style.paddingBottom = api.safeArea.bottom + 'px';

內(nèi)部字段：

{
    top:            // 安全區(qū)域上邊緣，對于沉浸式下window中該值通常為狀態(tài)欄高度，全屏或非沉浸式下為0（iPhone X豎屏?xí)r全屏狀態(tài)下也為44）
    left:            // 安全區(qū)域左邊緣，通常為0（iPhone X橫屏?xí)r為44）
    bottom:            // 安全區(qū)域下邊緣，通常為0（iPhone X豎屏?xí)r為34，橫屏?xí)r為21）
    right:            // 安全區(qū)域右邊緣，通常為0（iPhone X橫屏?xí)r為44）
}

示例代碼

var safeArea = api.safeArea;        // JSON對象，如{top:20, left:0, bottom:0, right:0}

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.2.33及更高版本