{"action":"opened","issue":{"url":"https://api.github.com/repos/CMUI/gearbox/issues/5","labels_url":"https://api.github.com/repos/CMUI/gearbox/issues/5/labels{/name}","comments_url":"https://api.github.com/repos/CMUI/gearbox/issues/5/comments","events_url":"https://api.github.com/repos/CMUI/gearbox/issues/5/events","html_url":"https://github.com/CMUI/gearbox/issues/5","id":93952441,"number":5,"title":"API 文档 - `ua` 模块","user":{"login":"cssmagic","id":1231359,"avatar_url":"https://avatars.githubusercontent.com/u/1231359?v=3","gravatar_id":"","url":"https://api.github.com/users/cssmagic","html_url":"https://github.com/cssmagic","followers_url":"https://api.github.com/users/cssmagic/followers","following_url":"https://api.github.com/users/cssmagic/following{/other_user}","gists_url":"https://api.github.com/users/cssmagic/gists{/gist_id}","starred_url":"https://api.github.com/users/cssmagic/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cssmagic/subscriptions","organizations_url":"https://api.github.com/users/cssmagic/orgs","repos_url":"https://api.github.com/users/cssmagic/repos","events_url":"https://api.github.com/users/cssmagic/events{/privacy}","received_events_url":"https://api.github.com/users/cssmagic/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-07-09T04:32:33Z","updated_at":"2015-07-09T04:32:33Z","closed_at":null,"body":"# API 文档 - `ua` 模块\r\n\r\n这个模块在加载时会对当前 UA 进行探测（通过特性检测或 UA 字符串分析等方式），并以变量的方式提供探测结果。\r\n\r\n这些探测浏览器内核和类型的接口仅用于底层开发或流量统计，不建议在业务层的常规功能中使用。\r\n\r\n## JavaScript 变量<a name=\"js-var\"></a>\r\n\r\n### `_.ua.isTouchDevice`<a name=\"js-var-isTouchDevice\"></a>\r\n\r\n布尔值。当前 UA 是否为触屏设备。Chrome 开启触摸调试之后也将被视为触屏设备。\r\n\r\n此探测基于特性检测。\r\n\r\n***\r\n\r\n### `_.ua.isSafari`<a name=\"js-var-isSafari\"></a>\r\n\r\n布尔值。当前 UA 是否为 Safari 浏览器（包括桌面版与移动版）。\r\n\r\n此探测基于 UA 信息。\r\n\r\n### `_.ua.isChrome`<a name=\"js-var-isChrome\"></a>\r\n\r\n布尔值。当前 UA 是否为 Chrome 浏览器（包括桌面版与移动版）。\r\n\r\n此探测基于 UA 信息。\r\n\r\n***\r\n\r\n### `_.ua.isIOS`<a name=\"js-var-isIOS\"></a>\r\n\r\n布尔值。当前操作系统是否为 iOS 系统。\r\n\r\n还有以下对 iOS 设备更细节的探测（值为布尔值或 `undefined`）：\r\n\r\n* `_.ua.isIPhone` - 当前 UA 是否为 iPhone。\r\n* `_.ua.isIPad` - 当前 UA 是否为 iPad。\r\n* `_.ua.isIPod` - 当前 UA 是否为 iPod touch。\r\n\r\n这些探测均基于 UA 信息。\r\n\r\n### `_.ua.isAndroid`<a name=\"js-var-isAndroid\"></a>\r\n\r\n布尔值。当前 UA 是否为 Android 系统。\r\n\r\n此探测基于 UA 信息。\r\n\r\n### `_.ua.isMobileDevice`<a name=\"js-var-isMobileDevice\"></a>\r\n\r\n布尔值或 `undefined`。当前 UA 是否为移动设备。所有 iOS 和 Android 设备会被识别为移动设备。\r\n\r\n此探测基于 UA 信息。\r\n\r\n***\r\n\r\n### `_.ua.osVersion`<a name=\"js-var-osVersion\"></a>\r\n\r\n字符串。当前移动操作系统的版本号，格式为 `{主版本号}.{次版本号}`。仅可识别 iOS 和 Android 系统的版本号，对于非移动操作系统或不可识别的移动操作系统，其值一律为 `'0.0'`。\r\n\r\n此探测基于 UA 信息。\r\n\r\n#### 示例\r\n\r\n* `'7.0'` - 对 iOS 7.0.1 的探测结果。\r\n* `'4.4'` - 对 Android 4.4.4 的探测结果。\r\n* `'0.0'` - 对 Windows、Mac OS、WinPhone 的探测结果。\r\n\r\n"}}