Note:绝大多数API在IOS版下不支持,使用前请自行测试。
UC官方的开发者中心:http://www.uc.cn/business/developer.shtml
U3内核定制<meta>标签说明
1. 屏幕方向(screen-orientation)
参数:
- landscape:强制横屏
- portrait:强制竖屏
用法:
1 <!-- 强制横屏 --> 2 <meta name="screen-orientation" content="landscape">
版本支持:8.6+
2. 全屏控制(full-screen)
参数:
- yes:强制全屏
用法:
1 <!-- 强制全屏 --> 2 <meta name="full-screen" content="yes">
提示:用此方法触发的全屏模式,和用户手动在设置项选择的全屏模式是不同的。
版本支持:8.6+
3. 浏览模式(browsermode)
描述:应用模式是为方便web应用及游戏开发者设置的综合开关,通过meta标签进行指示打开,当进入应用模式时,浏览器将自动调整以下参数:
- (参数: 状态)
- 全屏: 生效,可通过meta或js api调用退出全屏
- 长按菜单: 失效,可通过js api调用重新生效
- 浏览器默认手势: 失效,可通过js api调用重新生效
- 排版模式: 标准模式,可通过meta或js api调用设置其他排版模式
- 强制图片显示: 生效
- 夜间模式: 失效,可通过meta或js api调用启用夜间模式
参数:
- application:应用模式
用法:
1 <!-- 应用模式 --> 2 <meta name="browsermode" content="application"/>
版本支持:8.6+
4. UC适应屏幕的排版方式(viewport)
描述:开启后,当进行缩放操作时,仅放大图片和文字等页面元素,但不放大屏幕宽度,从而避免了左右滚动条的产生。
参数:
- uc-fitscreen=no:不开启【默认】
- uc-fitscreen=yes:开启
用法:
1 <!-- 开启UC适应屏幕的排版方式 --> 2 <meta name="viewport" content="uc-fitscreen=yes"/>
版本支持:8.5 patch +
5. UC适应屏幕的排版方式(layoutmode)
参数:
- fitscreen:适应屏幕
- standard:标准模式
用法:
1 <!-- 适应屏幕 --> 2 <meta name="layoutmode" content="fitscreen" />
等同于
1 <meta name="viewport" content="uc-fitscreen=yes, initial-scale=1.0" />
提示:更推荐用layoutmode,避免和原生支持的viewport发生未知冲突。
版本支持:8.5 patch +
6. 禁用夜间模式(nightmode)
参数:
- disable:禁止页面使用uc浏览器自定义的夜间模式,进入夜间模式时的表现同日间模式
- enable:允许页面使用uc浏览器自定义的夜间模式,用于取消disable时的效果
用法:
1 <!-- 禁用夜间模式 --> 2 <meta name="nightmode" content="disable"/>
版本支持:8.5 patch +
7. 强制图片显示(imagemode)
描述:当用户使用无图模式时,可以通过此方法来强制显示图片。
参数:
- force:强制图片显示
用法:
1 <!-- Meta标签(所有图片) --> 2 <meta name="imagemode" content="force"/> 3 4 <!-- Img标签(单张图片) --> 5 <img src="..." show="force">
版本支持:8.5 patch +
8. 发送到桌面
描述:在用户触发“发至桌面”的菜单操作后,即触发联网获取size最大的图片。在未获取到图片前,可以先显示默认图片;获取完成后再将获取到的图片更新到桌面。如果获取不到或者没有此特殊标签,仍然使用默认的桌面书签图标。
用法:
1 <link rel="apple-touch-icon-precomposed" sizes="57x57" href="images/icon.png" /> 2 <link rel="apple-touch-icon" sizes="72x72" href="images/icon.png" />
U3内核JavaScript专用API
(经测试,官方文档给出的API很多也不能使用,下面只列出测试能用的)
1. 关闭默认手势
用法:
1 navigator.control.gesture(false);
个人推荐写法:
1 try { 2 navigator.control.gesture(false); 3 } catch (e) { 4 // ... 5 }
2. 关闭长按弹出菜单
用法:
1 navigator.control.longpressMenu(false);
个人推荐写法:
1 try { 2 navigator.control.longpressMenu(false); 3 } catch (e) { 4 // ... 5 }
服务器端相关API
1. XUCBrowserUserAgent
描述:HTTP Header 中 X-UCBrowser-UA 的对象模型,用于封装相关的数据段,并提供简单易用的方法读取字段内容。
通过这个API,可以获取到更加详细的设备信息,如:网络情况、系统环境、UC浏览器版本等...
各项参数的含义,请查看该pdf:http://www.uc.cn/download/UCBrowser_User_Agent.pdf
php的用法:
1 <?php 2 echo $_SERVER[‘HTTP_X_UCBROWSER_UA‘];