diff --git a/docs/adapt.md b/docs/adapt.md index cea48db3cb3bfae99c940443197bbe7e823c42bf..44a6042cda05e3be297f31fad795309d2825f237 100644 --- a/docs/adapt.md +++ b/docs/adapt.md @@ -26,6 +26,10 @@ uni-app提供的屏幕适配方案,包括3部分: 这套方案是已知的、最便捷的分栏式宽屏应用适配方案。 +__宽屏下原生 tabBar 与窗体的关系__ + +> 目前做如下调整:leftWindow、rightWindow、topWindow 中有其一存在,则 tabBar 隐藏;不存在,则隐藏。 + leftWindow等配置,在pages.json里进行。文档见:[https://uniapp.dcloud.net.cn/collocation/pages?id=topwindow](https://uniapp.dcloud.net.cn/collocation/pages?id=topwindow) pages.json 配置样例 diff --git a/docs/collocation/pages.md b/docs/collocation/pages.md index 5a1cdaf494d21aa775b66d2b5456221d93564f2d..71d918e9ae84bc37a2651e32999b724619b551c2 100644 --- a/docs/collocation/pages.md +++ b/docs/collocation/pages.md @@ -155,12 +155,13 @@ |rpxCalcMaxDeviceWidth|Number|960|rpx 计算所支持的最大设备宽度,单位 px|App、H5(2.8.12+)| |rpxCalcBaseDeviceWidth|Number|375|rpx 计算使用的基准设备宽度,设备实际宽度超出 rpx 计算所支持的最大设备宽度时将按基准宽度计算,单位 px|App、H5(2.8.12+)| |rpxCalcIncludeWidth|Number|750|rpx 计算特殊处理的值,始终按实际的设备宽度计算,单位 rpx|App、H5(2.8.12+)| - +|maxWidth|Number|1190|单位px,当浏览器可见区域宽度大于maxWidth时,两侧留白,当小于等于maxWidth时,页面铺满;不同页面支持配置不同的maxWidth;maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选)|H5(2.9.9+)| **注意** - 支付宝小程序使用`titleImage`时必须使用`https`的图片链接地址,需要真机调试才能看到效果,支付宝开发者工具内无效果 - `globalStyle`中设置的`titleImage`也会覆盖掉`pages`->`style`内的设置文字标题 +- 使用 `maxWidth` 时,页面内fixed元素需要使用--window-left,--window-right来保证布局位置正确 # topWindow@topwindow @@ -319,6 +320,11 @@ uni-app 2.9+ 新增 leftWindow, topWindow, rightWindow 配置。用于解决宽 |leftWindow|Boolean|true|当存在 leftWindow时,当前页面是否显示 leftWindow|H5| |topWindow|Boolean|true|当存在 topWindow 时,当前页面是否显示 topWindow|H5| |rightWindow|Boolean|true|当存在 rightWindow时,当前页面是否显示 rightWindow|H5| +|maxWidth|Number|1190|单位px,当浏览器可见区域宽度大于maxWidth时,两侧留白,当小于等于maxWidth时,页面铺满;不同页面支持配置不同的maxWidth;maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选)|H5(2.9.9+)| + +**注意** + +- 使用 `maxWidth` 时,页面内fixed元素需要使用--window-left,--window-right来保证布局位置正确 **代码示例:**