selenium-webdriver 2.48.2 → 2.53.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (534) hide show
  1. package/CHANGES.md +116 -0
  2. package/NOTICE +1 -1
  3. package/README.md +59 -9
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +9 -6
  8. package/example/google_search.js +1 -1
  9. package/example/google_search_generator.js +2 -4
  10. package/example/logging.js +6 -2
  11. package/example/sample.js +21 -0
  12. package/executors.js +11 -27
  13. package/firefox/binary.js +149 -98
  14. package/firefox/extension.js +15 -19
  15. package/firefox/index.js +256 -163
  16. package/firefox/profile.js +223 -243
  17. package/http/index.js +487 -81
  18. package/http/util.js +40 -36
  19. package/ie.js +288 -309
  20. package/index.js +34 -125
  21. package/io/exec.js +58 -39
  22. package/io/index.js +72 -60
  23. package/lib/README +4 -0
  24. package/lib/actions.js +596 -0
  25. package/lib/by.js +277 -0
  26. package/lib/capabilities.js +450 -0
  27. package/lib/{webdriver/command.js → command.js} +91 -72
  28. package/lib/{webdriver/button.js → devmode.js} +13 -8
  29. package/lib/error.js +690 -0
  30. package/lib/events.js +212 -0
  31. package/lib/firefox/amd64/libnoblur64.so +0 -0
  32. package/lib/firefox/i386/libnoblur.so +0 -0
  33. package/lib/firefox/webdriver.json +5 -1
  34. package/lib/firefox/webdriver.xpi +0 -0
  35. package/lib/{webdriver/key.js → input.js} +84 -2
  36. package/lib/logging.js +670 -0
  37. package/lib/{webdriver/promise.js → promise.js} +817 -644
  38. package/lib/safari/client.js +266 -214
  39. package/lib/session.js +80 -0
  40. package/lib/{webdriver/serializable.js → symbols.js} +16 -19
  41. package/lib/test/build.js +4 -4
  42. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  43. package/lib/test/data/click_tests/overlapping_elements.html +15 -4
  44. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  45. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  46. package/lib/test/data/hidden_partially.html +45 -0
  47. package/lib/test/data/readOnlyPage.html +1 -1
  48. package/lib/test/data/selectPage.html +18 -2
  49. package/lib/test/fileserver.js +3 -4
  50. package/lib/test/index.js +7 -3
  51. package/lib/test/resources.js +1 -1
  52. package/lib/until.js +376 -0
  53. package/lib/webdriver.js +2440 -0
  54. package/net/index.js +4 -0
  55. package/net/portprober.js +16 -12
  56. package/opera.js +295 -314
  57. package/package.json +6 -5
  58. package/phantomjs.js +144 -147
  59. package/proxy.js +10 -6
  60. package/remote/index.js +289 -238
  61. package/safari.js +326 -311
  62. package/test/chrome/options_test.js +11 -9
  63. package/test/element_finding_test.js +51 -13
  64. package/test/execute_script_test.js +17 -3
  65. package/test/firefox/firefox_test.js +0 -32
  66. package/test/http/http_test.js +671 -61
  67. package/test/http/util_test.js +25 -23
  68. package/test/io_test.js +67 -1
  69. package/test/lib/by_test.js +139 -0
  70. package/test/lib/capabilities_test.js +111 -0
  71. package/test/lib/error_test.js +325 -0
  72. package/test/lib/events_test.js +177 -0
  73. package/test/lib/logging_test.js +272 -0
  74. package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
  75. package/test/lib/promise_error_test.js +808 -0
  76. package/test/lib/promise_flow_test.js +2282 -0
  77. package/test/lib/promise_generator_test.js +308 -0
  78. package/test/lib/promise_test.js +996 -0
  79. package/test/lib/testutil.js +90 -0
  80. package/test/lib/until_test.js +400 -0
  81. package/test/lib/webdriver_test.js +2157 -0
  82. package/test/page_loading_test.js +7 -9
  83. package/test/remote_test.js +50 -3
  84. package/test/session_test.js +53 -0
  85. package/test/stale_element_test.js +2 -2
  86. package/test/testing/assert_test.js +374 -0
  87. package/test/testing/index_test.js +9 -11
  88. package/testing/assert.js +334 -17
  89. package/testing/index.js +12 -2
  90. package/_base.js +0 -200
  91. package/docs/Changes.html +0 -356
  92. package/docs/class_bot_Error.html +0 -15
  93. package/docs/class_webdriver_ActionSequence.html +0 -115
  94. package/docs/class_webdriver_Alert.html +0 -24
  95. package/docs/class_webdriver_AlertPromise.html +0 -92
  96. package/docs/class_webdriver_Capabilities.html +0 -60
  97. package/docs/class_webdriver_Command.html +0 -15
  98. package/docs/class_webdriver_EventEmitter.html +0 -35
  99. package/docs/class_webdriver_FileDetector.html +0 -21
  100. package/docs/class_webdriver_Locator.html +0 -12
  101. package/docs/class_webdriver_Serializable.html +0 -9
  102. package/docs/class_webdriver_Session.html +0 -13
  103. package/docs/class_webdriver_TouchSequence.html +0 -49
  104. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  105. package/docs/class_webdriver_WebDriver.html +0 -313
  106. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  107. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  108. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  109. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  110. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  111. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  112. package/docs/class_webdriver_WebElement.html +0 -223
  113. package/docs/class_webdriver_WebElementPromise.html +0 -274
  114. package/docs/class_webdriver_http_Executor.html +0 -22
  115. package/docs/class_webdriver_http_Request.html +0 -12
  116. package/docs/class_webdriver_http_Response.html +0 -13
  117. package/docs/class_webdriver_logging_Entry.html +0 -15
  118. package/docs/class_webdriver_logging_Level.html +0 -55
  119. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  120. package/docs/class_webdriver_logging_Logger.html +0 -119
  121. package/docs/class_webdriver_logging_Preferences.html +0 -8
  122. package/docs/class_webdriver_promise_CancellationError.html +0 -17
  123. package/docs/class_webdriver_promise_ControlFlow.html +0 -153
  124. package/docs/class_webdriver_promise_Deferred.html +0 -84
  125. package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
  126. package/docs/class_webdriver_promise_Promise.html +0 -75
  127. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  128. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  129. package/docs/class_webdriver_testing_Assertion.html +0 -99
  130. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  131. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  132. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  133. package/docs/class_webdriver_until_Condition.html +0 -7
  134. package/docs/dossier.css +0 -1
  135. package/docs/dossier.js +0 -86
  136. package/docs/enum_bot_ErrorCode.html +0 -3
  137. package/docs/enum_bot_Error_State.html +0 -2
  138. package/docs/enum_webdriver_Browser.html +0 -2
  139. package/docs/enum_webdriver_Button.html +0 -2
  140. package/docs/enum_webdriver_Capability.html +0 -33
  141. package/docs/enum_webdriver_CommandName.html +0 -3
  142. package/docs/enum_webdriver_Key.html +0 -12
  143. package/docs/enum_webdriver_logging_Type.html +0 -6
  144. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  145. package/docs/index.html +0 -125
  146. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  147. package/docs/interface_webdriver_http_Client.html +0 -10
  148. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  149. package/docs/module_selenium-webdriver.html +0 -23
  150. package/docs/module_selenium-webdriver__base.html +0 -23
  151. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  152. package/docs/module_selenium-webdriver_builder.html +0 -2
  153. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  154. package/docs/module_selenium-webdriver_chrome.html +0 -90
  155. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  156. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  157. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  158. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  159. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  160. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  161. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  162. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  163. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  164. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  165. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  166. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  167. package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
  168. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
  169. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  170. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  171. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  172. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  173. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  174. package/docs/module_selenium-webdriver_error.html +0 -4
  175. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  176. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  177. package/docs/module_selenium-webdriver_executors.html +0 -10
  178. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  179. package/docs/module_selenium-webdriver_firefox.html +0 -68
  180. package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
  181. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
  182. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
  183. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  184. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  185. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  186. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  187. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  188. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  189. package/docs/module_selenium-webdriver_http.html +0 -9
  190. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  191. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  192. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  193. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  194. package/docs/module_selenium-webdriver_http_util.html +0 -17
  195. package/docs/module_selenium-webdriver_ie.html +0 -11
  196. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  197. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  198. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  199. package/docs/module_selenium-webdriver_io.html +0 -37
  200. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  201. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  202. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  203. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  204. package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
  205. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  206. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  207. package/docs/module_selenium-webdriver_net.html +0 -7
  208. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  209. package/docs/module_selenium-webdriver_opera.html +0 -62
  210. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  211. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  212. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  213. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  214. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  215. package/docs/module_selenium-webdriver_proxy.html +0 -28
  216. package/docs/module_selenium-webdriver_remote.html +0 -8
  217. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  218. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  219. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
  220. package/docs/module_selenium-webdriver_safari.html +0 -9
  221. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  222. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  223. package/docs/module_selenium-webdriver_testing.html +0 -74
  224. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  225. package/docs/namespace_bot.html +0 -4
  226. package/docs/namespace_bot_json.html +0 -20
  227. package/docs/namespace_bot_response.html +0 -18
  228. package/docs/namespace_bot_userAgent.html +0 -33
  229. package/docs/namespace_webdriver.html +0 -30
  230. package/docs/namespace_webdriver_By.html +0 -56
  231. package/docs/namespace_webdriver_http.html +0 -6
  232. package/docs/namespace_webdriver_logging.html +0 -70
  233. package/docs/namespace_webdriver_promise.html +0 -688
  234. package/docs/namespace_webdriver_stacktrace.html +0 -17
  235. package/docs/namespace_webdriver_testing.html +0 -7
  236. package/docs/namespace_webdriver_testing_assert.html +0 -9
  237. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  238. package/docs/namespace_webdriver_until.html +0 -82
  239. package/docs/source/_base.js.src.html +0 -1
  240. package/docs/source/builder.js.src.html +0 -1
  241. package/docs/source/chrome.js.src.html +0 -1
  242. package/docs/source/error.js.src.html +0 -1
  243. package/docs/source/executors.js.src.html +0 -1
  244. package/docs/source/firefox/binary.js.src.html +0 -1
  245. package/docs/source/firefox/extension.js.src.html +0 -1
  246. package/docs/source/firefox/index.js.src.html +0 -1
  247. package/docs/source/firefox/profile.js.src.html +0 -1
  248. package/docs/source/http/index.js.src.html +0 -1
  249. package/docs/source/http/util.js.src.html +0 -1
  250. package/docs/source/ie.js.src.html +0 -1
  251. package/docs/source/index.js.src.html +0 -1
  252. package/docs/source/io/exec.js.src.html +0 -1
  253. package/docs/source/io/index.js.src.html +0 -1
  254. package/docs/source/lib/atoms/error.js.src.html +0 -1
  255. package/docs/source/lib/atoms/json.js.src.html +0 -1
  256. package/docs/source/lib/atoms/response.js.src.html +0 -1
  257. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  258. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  259. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  260. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  261. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  262. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  263. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  264. package/docs/source/lib/goog/base.js.src.html +0 -1
  265. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  266. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  267. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  268. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  269. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  270. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  271. package/docs/source/lib/goog/deps.js.src.html +0 -1
  272. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  273. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  274. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  275. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  276. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  277. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  278. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  279. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  280. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  282. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  283. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  284. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  285. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  286. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  287. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  288. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  289. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  290. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  291. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  292. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  293. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  294. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  295. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  296. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  297. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  298. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  299. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  300. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  301. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  302. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  303. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  304. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  305. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  306. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  307. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  308. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  309. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  310. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  311. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  312. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  313. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  314. package/docs/source/lib/goog/log/log.js.src.html +0 -1
  315. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  316. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  317. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  318. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  319. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  320. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  321. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  322. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  323. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  324. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  325. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  326. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  327. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  328. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  329. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  330. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  331. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  332. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  333. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  334. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  335. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  336. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  344. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  345. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  346. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  347. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  348. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  349. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  350. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  351. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  352. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  353. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  354. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  355. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  356. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  357. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  358. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  366. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  367. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  368. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  369. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  370. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  371. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  372. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  373. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  374. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  375. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  376. package/docs/source/net/index.js.src.html +0 -1
  377. package/docs/source/net/portprober.js.src.html +0 -1
  378. package/docs/source/opera.js.src.html +0 -1
  379. package/docs/source/phantomjs.js.src.html +0 -1
  380. package/docs/source/proxy.js.src.html +0 -1
  381. package/docs/source/remote/index.js.src.html +0 -1
  382. package/docs/source/safari.js.src.html +0 -1
  383. package/docs/source/testing/assert.js.src.html +0 -1
  384. package/docs/source/testing/index.js.src.html +0 -1
  385. package/docs/types.js +0 -1
  386. package/lib/atoms/error.js +0 -202
  387. package/lib/atoms/json.js +0 -80
  388. package/lib/atoms/response.js +0 -110
  389. package/lib/atoms/userAgent.js +0 -257
  390. package/lib/goog/LICENSE +0 -176
  391. package/lib/goog/array/array.js +0 -1654
  392. package/lib/goog/asserts/asserts.js +0 -365
  393. package/lib/goog/async/freelist.js +0 -88
  394. package/lib/goog/async/nexttick.js +0 -241
  395. package/lib/goog/async/run.js +0 -133
  396. package/lib/goog/async/workqueue.js +0 -139
  397. package/lib/goog/base.js +0 -2548
  398. package/lib/goog/debug/debug.js +0 -653
  399. package/lib/goog/debug/entrypointregistry.js +0 -158
  400. package/lib/goog/debug/error.js +0 -63
  401. package/lib/goog/debug/logbuffer.js +0 -148
  402. package/lib/goog/debug/logger.js +0 -873
  403. package/lib/goog/debug/logrecord.js +0 -242
  404. package/lib/goog/deps.js +0 -151
  405. package/lib/goog/disposable/disposable.js +0 -307
  406. package/lib/goog/disposable/idisposable.js +0 -45
  407. package/lib/goog/dom/browserfeature.js +0 -72
  408. package/lib/goog/dom/dom.js +0 -2991
  409. package/lib/goog/dom/nodetype.js +0 -48
  410. package/lib/goog/dom/safe.js +0 -347
  411. package/lib/goog/dom/tagname.js +0 -160
  412. package/lib/goog/dom/tags.js +0 -41
  413. package/lib/goog/dom/vendor.js +0 -96
  414. package/lib/goog/events/browserevent.js +0 -400
  415. package/lib/goog/events/browserfeature.js +0 -85
  416. package/lib/goog/events/event.js +0 -143
  417. package/lib/goog/events/eventid.js +0 -47
  418. package/lib/goog/events/events.js +0 -984
  419. package/lib/goog/events/eventtarget.js +0 -394
  420. package/lib/goog/events/eventtype.js +0 -237
  421. package/lib/goog/events/keycodes.js +0 -427
  422. package/lib/goog/events/listenable.js +0 -335
  423. package/lib/goog/events/listener.js +0 -131
  424. package/lib/goog/events/listenermap.js +0 -308
  425. package/lib/goog/fs/url.js +0 -109
  426. package/lib/goog/functions/functions.js +0 -442
  427. package/lib/goog/html/safehtml.js +0 -757
  428. package/lib/goog/html/safescript.js +0 -234
  429. package/lib/goog/html/safestyle.js +0 -442
  430. package/lib/goog/html/safestylesheet.js +0 -276
  431. package/lib/goog/html/safeurl.js +0 -398
  432. package/lib/goog/html/trustedresourceurl.js +0 -224
  433. package/lib/goog/html/uncheckedconversions.js +0 -232
  434. package/lib/goog/i18n/bidi.js +0 -908
  435. package/lib/goog/iter/iter.js +0 -1302
  436. package/lib/goog/json/json.js +0 -363
  437. package/lib/goog/labs/testing/assertthat.js +0 -58
  438. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  439. package/lib/goog/labs/testing/matcher.js +0 -80
  440. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  441. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  442. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  443. package/lib/goog/labs/useragent/browser.js +0 -341
  444. package/lib/goog/labs/useragent/engine.js +0 -160
  445. package/lib/goog/labs/useragent/platform.js +0 -160
  446. package/lib/goog/labs/useragent/util.js +0 -148
  447. package/lib/goog/log/log.js +0 -197
  448. package/lib/goog/math/box.js +0 -398
  449. package/lib/goog/math/coordinate.js +0 -268
  450. package/lib/goog/math/math.js +0 -451
  451. package/lib/goog/math/rect.js +0 -476
  452. package/lib/goog/math/size.js +0 -227
  453. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  454. package/lib/goog/net/xhrlike.js +0 -124
  455. package/lib/goog/net/xmlhttp.js +0 -246
  456. package/lib/goog/net/xmlhttpfactory.js +0 -67
  457. package/lib/goog/object/object.js +0 -686
  458. package/lib/goog/promise/promise.js +0 -1350
  459. package/lib/goog/promise/resolver.js +0 -48
  460. package/lib/goog/promise/thenable.js +0 -126
  461. package/lib/goog/reflect/reflect.js +0 -77
  462. package/lib/goog/string/const.js +0 -182
  463. package/lib/goog/string/string.js +0 -1599
  464. package/lib/goog/string/typedstring.js +0 -48
  465. package/lib/goog/structs/collection.js +0 -56
  466. package/lib/goog/structs/map.js +0 -457
  467. package/lib/goog/structs/set.js +0 -279
  468. package/lib/goog/structs/structs.js +0 -354
  469. package/lib/goog/style/style.js +0 -2037
  470. package/lib/goog/testing/asserts.js +0 -1278
  471. package/lib/goog/testing/events/events.js +0 -767
  472. package/lib/goog/testing/functionmock.js +0 -175
  473. package/lib/goog/testing/jsunit.js +0 -162
  474. package/lib/goog/testing/loosemock.js +0 -242
  475. package/lib/goog/testing/mock.js +0 -645
  476. package/lib/goog/testing/mockclock.js +0 -606
  477. package/lib/goog/testing/mockcontrol.js +0 -220
  478. package/lib/goog/testing/mockinterface.js +0 -45
  479. package/lib/goog/testing/mockmatchers.js +0 -400
  480. package/lib/goog/testing/objectpropertystring.js +0 -68
  481. package/lib/goog/testing/propertyreplacer.js +0 -262
  482. package/lib/goog/testing/recordfunction.js +0 -215
  483. package/lib/goog/testing/stacktrace.js +0 -594
  484. package/lib/goog/testing/strictmock.js +0 -130
  485. package/lib/goog/testing/testcase.js +0 -1629
  486. package/lib/goog/testing/testrunner.js +0 -440
  487. package/lib/goog/uri/uri.js +0 -1524
  488. package/lib/goog/uri/utils.js +0 -1064
  489. package/lib/goog/useragent/product.js +0 -183
  490. package/lib/goog/useragent/product_isversion.js +0 -144
  491. package/lib/goog/useragent/useragent.js +0 -572
  492. package/lib/webdriver/actionsequence.js +0 -356
  493. package/lib/webdriver/builder.js +0 -207
  494. package/lib/webdriver/capabilities.js +0 -412
  495. package/lib/webdriver/events.js +0 -179
  496. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  497. package/lib/webdriver/http/corsclient.js +0 -133
  498. package/lib/webdriver/http/http.js +0 -525
  499. package/lib/webdriver/http/xhrclient.js +0 -67
  500. package/lib/webdriver/locators.js +0 -257
  501. package/lib/webdriver/logging.js +0 -347
  502. package/lib/webdriver/session.js +0 -74
  503. package/lib/webdriver/stacktrace.js +0 -619
  504. package/lib/webdriver/test/builder_test.js +0 -53
  505. package/lib/webdriver/test/capabilities_test.js +0 -72
  506. package/lib/webdriver/test/events_test.js +0 -203
  507. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  508. package/lib/webdriver/test/http/http_test.js +0 -428
  509. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  510. package/lib/webdriver/test/locators_test.js +0 -59
  511. package/lib/webdriver/test/logging_test.js +0 -85
  512. package/lib/webdriver/test/promise_error_test.js +0 -892
  513. package/lib/webdriver/test/promise_flow_test.js +0 -2365
  514. package/lib/webdriver/test/promise_generator_test.js +0 -323
  515. package/lib/webdriver/test/promise_test.js +0 -2012
  516. package/lib/webdriver/test/stacktrace_test.js +0 -480
  517. package/lib/webdriver/test/test_bootstrap.js +0 -67
  518. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  519. package/lib/webdriver/test/testing/client_test.js +0 -88
  520. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  521. package/lib/webdriver/test/testutil.js +0 -209
  522. package/lib/webdriver/test/testutil_test.js +0 -104
  523. package/lib/webdriver/test/until_test.js +0 -411
  524. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  525. package/lib/webdriver/test/webdriver_test.js +0 -2369
  526. package/lib/webdriver/testing/asserts.js +0 -487
  527. package/lib/webdriver/testing/client.js +0 -179
  528. package/lib/webdriver/testing/jsunit.js +0 -363
  529. package/lib/webdriver/testing/testcase.js +0 -168
  530. package/lib/webdriver/testing/window.js +0 -244
  531. package/lib/webdriver/touchsequence.js +0 -248
  532. package/lib/webdriver/until.js +0 -412
  533. package/lib/webdriver/webdriver.js +0 -2511
  534. package/test/_base_test.js +0 -129
package/docs/source/lib/goog/html/uncheckedconversions.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>uncheckedconversions.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/html/uncheckedconversions.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Unchecked conversions to create values of goog.html types from<tr><td><a id="l17"></a><a href="#l17">17</a><td> * plain strings. Use of these functions could potentially result in instances<tr><td><a id="l18"></a><a href="#l18">18</a><td> * of goog.html types that violate their type contracts, and hence result in<tr><td><a id="l19"></a><a href="#l19">19</a><td> * security vulnerabilties.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * Therefore, all uses of the methods herein must be carefully security<tr><td><a id="l22"></a><a href="#l22">22</a><td> * reviewed. Avoid use of the methods in this file whenever possible; instead<tr><td><a id="l23"></a><a href="#l23">23</a><td> * prefer to create instances of goog.html types using inherently safe builders<tr><td><a id="l24"></a><a href="#l24">24</a><td> * or template systems.<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> *<tr><td><a id="l27"></a><a href="#l27">27</a><td> *<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @visibility {//closure/goog/html:approved_for_unchecked_conversion}<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @visibility {//closure/goog/bin/sizetests:__pkg__}<tr><td><a id="l30"></a><a href="#l30">30</a><td> */<tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.provide(&#39;goog.html.uncheckedconversions&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.html.SafeHtml&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.html.SafeScript&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.html.SafeStyle&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.html.SafeStyleSheet&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.html.SafeUrl&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.html.TrustedResourceUrl&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * Performs an &quot;unchecked conversion&quot; to SafeHtml from a plain string that is<tr><td><a id="l48"></a><a href="#l48">48</a><td> * known to satisfy the SafeHtml type contract.<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l51"></a><a href="#l51">51</a><td> * that the value of {@code html} satisfies the SafeHtml type contract in all<tr><td><a id="l52"></a><a href="#l52">52</a><td> * possible program states.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l56"></a><a href="#l56">56</a><td> * this use of this method is safe. May include a security review ticket<tr><td><a id="l57"></a><a href="#l57">57</a><td> * number.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {string} html A string that is claimed to adhere to the SafeHtml<tr><td><a id="l59"></a><a href="#l59">59</a><td> * contract.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {?goog.i18n.bidi.Dir=} opt_dir The optional directionality of the<tr><td><a id="l61"></a><a href="#l61">61</a><td> * SafeHtml to be constructed. A null or undefined value signifies an<tr><td><a id="l62"></a><a href="#l62">62</a><td> * unknown directionality.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @return {!goog.html.SafeHtml} The value of html, wrapped in a SafeHtml<tr><td><a id="l64"></a><a href="#l64">64</a><td> * object.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @suppress {visibility} For access to SafeHtml.create... Note that this<tr><td><a id="l66"></a><a href="#l66">66</a><td> * use is appropriate since this method is intended to be &quot;package private&quot;<tr><td><a id="l67"></a><a href="#l67">67</a><td> * withing goog.html. DO NOT call SafeHtml.create... from outside this<tr><td><a id="l68"></a><a href="#l68">68</a><td> * package; use appropriate wrappers instead.<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>goog.html.uncheckedconversions.safeHtmlFromStringKnownToSatisfyTypeContract =<tr><td><a id="l71"></a><a href="#l71">71</a><td> function(justification, html, opt_dir) {<tr><td><a id="l72"></a><a href="#l72">72</a><td> // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l73"></a><a href="#l73">73</a><td> // away in production code.<tr><td><a id="l74"></a><a href="#l74">74</a><td> goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l75"></a><a href="#l75">75</a><td> &#39;must provide justification&#39;);<tr><td><a id="l76"></a><a href="#l76">76</a><td> goog.asserts.assert(<tr><td><a id="l77"></a><a href="#l77">77</a><td> !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l78"></a><a href="#l78">78</a><td> &#39;must provide non-empty justification&#39;);<tr><td><a id="l79"></a><a href="#l79">79</a><td> return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l80"></a><a href="#l80">80</a><td> html, opt_dir || null);<tr><td><a id="l81"></a><a href="#l81">81</a><td>};<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td>/**<tr><td><a id="l85"></a><a href="#l85">85</a><td> * Performs an &quot;unchecked conversion&quot; to SafeScript from a plain string that is<tr><td><a id="l86"></a><a href="#l86">86</a><td> * known to satisfy the SafeScript type contract.<tr><td><a id="l87"></a><a href="#l87">87</a><td> *<tr><td><a id="l88"></a><a href="#l88">88</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l89"></a><a href="#l89">89</a><td> * that the value of {@code script} satisfies the SafeScript type contract in<tr><td><a id="l90"></a><a href="#l90">90</a><td> * all possible program states.<tr><td><a id="l91"></a><a href="#l91">91</a><td> *<tr><td><a id="l92"></a><a href="#l92">92</a><td> *<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l94"></a><a href="#l94">94</a><td> * this use of this method is safe. May include a security review ticket<tr><td><a id="l95"></a><a href="#l95">95</a><td> * number.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {string} script The string to wrap as a SafeScript.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @return {!goog.html.SafeScript} The value of {@code script}, wrapped in a<tr><td><a id="l98"></a><a href="#l98">98</a><td> * SafeScript object.<tr><td><a id="l99"></a><a href="#l99">99</a><td> */<tr><td><a id="l100"></a><a href="#l100">100</a><td>goog.html.uncheckedconversions.safeScriptFromStringKnownToSatisfyTypeContract =<tr><td><a id="l101"></a><a href="#l101">101</a><td> function(justification, script) {<tr><td><a id="l102"></a><a href="#l102">102</a><td> // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l103"></a><a href="#l103">103</a><td> // away in production code.<tr><td><a id="l104"></a><a href="#l104">104</a><td> goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l105"></a><a href="#l105">105</a><td> &#39;must provide justification&#39;);<tr><td><a id="l106"></a><a href="#l106">106</a><td> goog.asserts.assert(<tr><td><a id="l107"></a><a href="#l107">107</a><td> !goog.string.isEmpty(goog.string.Const.unwrap(justification)),<tr><td><a id="l108"></a><a href="#l108">108</a><td> &#39;must provide non-empty justification&#39;);<tr><td><a id="l109"></a><a href="#l109">109</a><td> return goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l110"></a><a href="#l110">110</a><td> script);<tr><td><a id="l111"></a><a href="#l111">111</a><td>};<tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td><tr><td><a id="l114"></a><a href="#l114">114</a><td>/**<tr><td><a id="l115"></a><a href="#l115">115</a><td> * Performs an &quot;unchecked conversion&quot; to SafeStyle from a plain string that is<tr><td><a id="l116"></a><a href="#l116">116</a><td> * known to satisfy the SafeStyle type contract.<tr><td><a id="l117"></a><a href="#l117">117</a><td> *<tr><td><a id="l118"></a><a href="#l118">118</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l119"></a><a href="#l119">119</a><td> * that the value of {@code style} satisfies the SafeUrl type contract in all<tr><td><a id="l120"></a><a href="#l120">120</a><td> * possible program states.<tr><td><a id="l121"></a><a href="#l121">121</a><td> *<tr><td><a id="l122"></a><a href="#l122">122</a><td> *<tr><td><a id="l123"></a><a href="#l123">123</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l124"></a><a href="#l124">124</a><td> * this use of this method is safe. May include a security review ticket<tr><td><a id="l125"></a><a href="#l125">125</a><td> * number.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @param {string} style The string to wrap as a SafeStyle.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @return {!goog.html.SafeStyle} The value of {@code style}, wrapped in a<tr><td><a id="l128"></a><a href="#l128">128</a><td> * SafeStyle object.<tr><td><a id="l129"></a><a href="#l129">129</a><td> */<tr><td><a id="l130"></a><a href="#l130">130</a><td>goog.html.uncheckedconversions.safeStyleFromStringKnownToSatisfyTypeContract =<tr><td><a id="l131"></a><a href="#l131">131</a><td> function(justification, style) {<tr><td><a id="l132"></a><a href="#l132">132</a><td> // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l133"></a><a href="#l133">133</a><td> // away in production code.<tr><td><a id="l134"></a><a href="#l134">134</a><td> goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l135"></a><a href="#l135">135</a><td> &#39;must provide justification&#39;);<tr><td><a id="l136"></a><a href="#l136">136</a><td> goog.asserts.assert(<tr><td><a id="l137"></a><a href="#l137">137</a><td> !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l138"></a><a href="#l138">138</a><td> &#39;must provide non-empty justification&#39;);<tr><td><a id="l139"></a><a href="#l139">139</a><td> return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l140"></a><a href="#l140">140</a><td> style);<tr><td><a id="l141"></a><a href="#l141">141</a><td>};<tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td><tr><td><a id="l144"></a><a href="#l144">144</a><td>/**<tr><td><a id="l145"></a><a href="#l145">145</a><td> * Performs an &quot;unchecked conversion&quot; to SafeStyleSheet from a plain string<tr><td><a id="l146"></a><a href="#l146">146</a><td> * that is known to satisfy the SafeStyleSheet type contract.<tr><td><a id="l147"></a><a href="#l147">147</a><td> *<tr><td><a id="l148"></a><a href="#l148">148</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l149"></a><a href="#l149">149</a><td> * that the value of {@code styleSheet} satisfies the SafeUrl type contract in<tr><td><a id="l150"></a><a href="#l150">150</a><td> * all possible program states.<tr><td><a id="l151"></a><a href="#l151">151</a><td> *<tr><td><a id="l152"></a><a href="#l152">152</a><td> *<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l154"></a><a href="#l154">154</a><td> * this use of this method is safe. May include a security review ticket<tr><td><a id="l155"></a><a href="#l155">155</a><td> * number.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @param {string} styleSheet The string to wrap as a SafeStyleSheet.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @return {!goog.html.SafeStyleSheet} The value of {@code styleSheet}, wrapped<tr><td><a id="l158"></a><a href="#l158">158</a><td> * in a SafeStyleSheet object.<tr><td><a id="l159"></a><a href="#l159">159</a><td> */<tr><td><a id="l160"></a><a href="#l160">160</a><td>goog.html.uncheckedconversions.<tr><td><a id="l161"></a><a href="#l161">161</a><td> safeStyleSheetFromStringKnownToSatisfyTypeContract =<tr><td><a id="l162"></a><a href="#l162">162</a><td> function(justification, styleSheet) {<tr><td><a id="l163"></a><a href="#l163">163</a><td> // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l164"></a><a href="#l164">164</a><td> // away in production code.<tr><td><a id="l165"></a><a href="#l165">165</a><td> goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l166"></a><a href="#l166">166</a><td> &#39;must provide justification&#39;);<tr><td><a id="l167"></a><a href="#l167">167</a><td> goog.asserts.assert(<tr><td><a id="l168"></a><a href="#l168">168</a><td> !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l169"></a><a href="#l169">169</a><td> &#39;must provide non-empty justification&#39;);<tr><td><a id="l170"></a><a href="#l170">170</a><td> return goog.html.SafeStyleSheet.<tr><td><a id="l171"></a><a href="#l171">171</a><td> createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(styleSheet);<tr><td><a id="l172"></a><a href="#l172">172</a><td>};<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * Performs an &quot;unchecked conversion&quot; to SafeUrl from a plain string that is<tr><td><a id="l177"></a><a href="#l177">177</a><td> * known to satisfy the SafeUrl type contract.<tr><td><a id="l178"></a><a href="#l178">178</a><td> *<tr><td><a id="l179"></a><a href="#l179">179</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l180"></a><a href="#l180">180</a><td> * that the value of {@code url} satisfies the SafeUrl type contract in all<tr><td><a id="l181"></a><a href="#l181">181</a><td> * possible program states.<tr><td><a id="l182"></a><a href="#l182">182</a><td> *<tr><td><a id="l183"></a><a href="#l183">183</a><td> *<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l185"></a><a href="#l185">185</a><td> * this use of this method is safe. May include a security review ticket<tr><td><a id="l186"></a><a href="#l186">186</a><td> * number.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @param {string} url The string to wrap as a SafeUrl.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @return {!goog.html.SafeUrl} The value of {@code url}, wrapped in a SafeUrl<tr><td><a id="l189"></a><a href="#l189">189</a><td> * object.<tr><td><a id="l190"></a><a href="#l190">190</a><td> */<tr><td><a id="l191"></a><a href="#l191">191</a><td>goog.html.uncheckedconversions.safeUrlFromStringKnownToSatisfyTypeContract =<tr><td><a id="l192"></a><a href="#l192">192</a><td> function(justification, url) {<tr><td><a id="l193"></a><a href="#l193">193</a><td> // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l194"></a><a href="#l194">194</a><td> // away in production code.<tr><td><a id="l195"></a><a href="#l195">195</a><td> goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l196"></a><a href="#l196">196</a><td> &#39;must provide justification&#39;);<tr><td><a id="l197"></a><a href="#l197">197</a><td> goog.asserts.assert(<tr><td><a id="l198"></a><a href="#l198">198</a><td> !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l199"></a><a href="#l199">199</a><td> &#39;must provide non-empty justification&#39;);<tr><td><a id="l200"></a><a href="#l200">200</a><td> return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(url);<tr><td><a id="l201"></a><a href="#l201">201</a><td>};<tr><td><a id="l202"></a><a href="#l202">202</a><td><tr><td><a id="l203"></a><a href="#l203">203</a><td><tr><td><a id="l204"></a><a href="#l204">204</a><td>/**<tr><td><a id="l205"></a><a href="#l205">205</a><td> * Performs an &quot;unchecked conversion&quot; to TrustedResourceUrl from a plain string<tr><td><a id="l206"></a><a href="#l206">206</a><td> * that is known to satisfy the TrustedResourceUrl type contract.<tr><td><a id="l207"></a><a href="#l207">207</a><td> *<tr><td><a id="l208"></a><a href="#l208">208</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l209"></a><a href="#l209">209</a><td> * that the value of {@code url} satisfies the TrustedResourceUrl type contract<tr><td><a id="l210"></a><a href="#l210">210</a><td> * in all possible program states.<tr><td><a id="l211"></a><a href="#l211">211</a><td> *<tr><td><a id="l212"></a><a href="#l212">212</a><td> *<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l214"></a><a href="#l214">214</a><td> * this use of this method is safe. May include a security review ticket<tr><td><a id="l215"></a><a href="#l215">215</a><td> * number.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @param {string} url The string to wrap as a TrustedResourceUrl.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @return {!goog.html.TrustedResourceUrl} The value of {@code url}, wrapped in<tr><td><a id="l218"></a><a href="#l218">218</a><td> * a TrustedResourceUrl object.<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>goog.html.uncheckedconversions.<tr><td><a id="l221"></a><a href="#l221">221</a><td> trustedResourceUrlFromStringKnownToSatisfyTypeContract =<tr><td><a id="l222"></a><a href="#l222">222</a><td> function(justification, url) {<tr><td><a id="l223"></a><a href="#l223">223</a><td> // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l224"></a><a href="#l224">224</a><td> // away in production code.<tr><td><a id="l225"></a><a href="#l225">225</a><td> goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l226"></a><a href="#l226">226</a><td> &#39;must provide justification&#39;);<tr><td><a id="l227"></a><a href="#l227">227</a><td> goog.asserts.assert(<tr><td><a id="l228"></a><a href="#l228">228</a><td> !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l229"></a><a href="#l229">229</a><td> &#39;must provide non-empty justification&#39;);<tr><td><a id="l230"></a><a href="#l230">230</a><td> return goog.html.TrustedResourceUrl.<tr><td><a id="l231"></a><a href="#l231">231</a><td> createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse(url);<tr><td><a id="l232"></a><a href="#l232">232</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/i18n/bidi.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>bidi.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/i18n/bidi.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utility functions for supporting Bidi issues.<tr><td><a id="l17"></a><a href="#l17">17</a><td> */<tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>/**<tr><td><a id="l21"></a><a href="#l21">21</a><td> * Namespace for bidi supporting functions.<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.i18n.bidi&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.i18n.bidi.Dir&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.i18n.bidi.DirectionalString&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.i18n.bidi.Format&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>/**<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @define {boolean} FORCE_RTL forces the {@link goog.i18n.bidi.IS_RTL} constant<tr><td><a id="l31"></a><a href="#l31">31</a><td> * to say that the current locale is a RTL locale. This should only be used<tr><td><a id="l32"></a><a href="#l32">32</a><td> * if you want to override the default behavior for deciding whether the<tr><td><a id="l33"></a><a href="#l33">33</a><td> * current locale is RTL or not.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * {@see goog.i18n.bidi.IS_RTL}<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.define(&#39;goog.i18n.bidi.FORCE_RTL&#39;, false);<tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>/**<tr><td><a id="l41"></a><a href="#l41">41</a><td> * Constant that defines whether or not the current locale is a RTL locale.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * If {@link goog.i18n.bidi.FORCE_RTL} is not true, this constant will default<tr><td><a id="l43"></a><a href="#l43">43</a><td> * to check that {@link goog.LOCALE} is one of a few major RTL locales.<tr><td><a id="l44"></a><a href="#l44">44</a><td> *<tr><td><a id="l45"></a><a href="#l45">45</a><td> * &lt;p&gt;This is designed to be a maximally efficient compile-time constant. For<tr><td><a id="l46"></a><a href="#l46">46</a><td> * example, for the default goog.LOCALE, compiling<tr><td><a id="l47"></a><a href="#l47">47</a><td> * &quot;if (goog.i18n.bidi.IS_RTL) alert(&#39;rtl&#39;) else {}&quot; should produce no code. It<tr><td><a id="l48"></a><a href="#l48">48</a><td> * is this design consideration that limits the implementation to only<tr><td><a id="l49"></a><a href="#l49">49</a><td> * supporting a few major RTL locales, as opposed to the broader repertoire of<tr><td><a id="l50"></a><a href="#l50">50</a><td> * something like goog.i18n.bidi.isRtlLanguage.<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * &lt;p&gt;Since this constant refers to the directionality of the locale, it is up<tr><td><a id="l53"></a><a href="#l53">53</a><td> * to the caller to determine if this constant should also be used for the<tr><td><a id="l54"></a><a href="#l54">54</a><td> * direction of the UI.<tr><td><a id="l55"></a><a href="#l55">55</a><td> *<tr><td><a id="l56"></a><a href="#l56">56</a><td> * {@see goog.LOCALE}<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @type {boolean}<tr><td><a id="l59"></a><a href="#l59">59</a><td> *<tr><td><a id="l60"></a><a href="#l60">60</a><td> * TODO(user): write a test that checks that this is a compile-time constant.<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>goog.i18n.bidi.IS_RTL = goog.i18n.bidi.FORCE_RTL ||<tr><td><a id="l63"></a><a href="#l63">63</a><td> (<tr><td><a id="l64"></a><a href="#l64">64</a><td> (goog.LOCALE.substring(0, 2).toLowerCase() == &#39;ar&#39; ||<tr><td><a id="l65"></a><a href="#l65">65</a><td> goog.LOCALE.substring(0, 2).toLowerCase() == &#39;fa&#39; ||<tr><td><a id="l66"></a><a href="#l66">66</a><td> goog.LOCALE.substring(0, 2).toLowerCase() == &#39;he&#39; ||<tr><td><a id="l67"></a><a href="#l67">67</a><td> goog.LOCALE.substring(0, 2).toLowerCase() == &#39;iw&#39; ||<tr><td><a id="l68"></a><a href="#l68">68</a><td> goog.LOCALE.substring(0, 2).toLowerCase() == &#39;ps&#39; ||<tr><td><a id="l69"></a><a href="#l69">69</a><td> goog.LOCALE.substring(0, 2).toLowerCase() == &#39;sd&#39; ||<tr><td><a id="l70"></a><a href="#l70">70</a><td> goog.LOCALE.substring(0, 2).toLowerCase() == &#39;ug&#39; ||<tr><td><a id="l71"></a><a href="#l71">71</a><td> goog.LOCALE.substring(0, 2).toLowerCase() == &#39;ur&#39; ||<tr><td><a id="l72"></a><a href="#l72">72</a><td> goog.LOCALE.substring(0, 2).toLowerCase() == &#39;yi&#39;) &amp;&amp;<tr><td><a id="l73"></a><a href="#l73">73</a><td> (goog.LOCALE.length == 2 ||<tr><td><a id="l74"></a><a href="#l74">74</a><td> goog.LOCALE.substring(2, 3) == &#39;-&#39; ||<tr><td><a id="l75"></a><a href="#l75">75</a><td> goog.LOCALE.substring(2, 3) == &#39;_&#39;)<tr><td><a id="l76"></a><a href="#l76">76</a><td> ) || (<tr><td><a id="l77"></a><a href="#l77">77</a><td> goog.LOCALE.length &gt;= 3 &amp;&amp;<tr><td><a id="l78"></a><a href="#l78">78</a><td> goog.LOCALE.substring(0, 3).toLowerCase() == &#39;ckb&#39; &amp;&amp;<tr><td><a id="l79"></a><a href="#l79">79</a><td> (goog.LOCALE.length == 3 ||<tr><td><a id="l80"></a><a href="#l80">80</a><td> goog.LOCALE.substring(3, 4) == &#39;-&#39; ||<tr><td><a id="l81"></a><a href="#l81">81</a><td> goog.LOCALE.substring(3, 4) == &#39;_&#39;)<tr><td><a id="l82"></a><a href="#l82">82</a><td> );<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Unicode formatting characters and directionality string constants.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @enum {string}<tr><td><a id="l88"></a><a href="#l88">88</a><td> */<tr><td><a id="l89"></a><a href="#l89">89</a><td>goog.i18n.bidi.Format = {<tr><td><a id="l90"></a><a href="#l90">90</a><td> /** Unicode &quot;Left-To-Right Embedding&quot; (LRE) character. */<tr><td><a id="l91"></a><a href="#l91">91</a><td> LRE: &#39;\u202A&#39;,<tr><td><a id="l92"></a><a href="#l92">92</a><td> /** Unicode &quot;Right-To-Left Embedding&quot; (RLE) character. */<tr><td><a id="l93"></a><a href="#l93">93</a><td> RLE: &#39;\u202B&#39;,<tr><td><a id="l94"></a><a href="#l94">94</a><td> /** Unicode &quot;Pop Directional Formatting&quot; (PDF) character. */<tr><td><a id="l95"></a><a href="#l95">95</a><td> PDF: &#39;\u202C&#39;,<tr><td><a id="l96"></a><a href="#l96">96</a><td> /** Unicode &quot;Left-To-Right Mark&quot; (LRM) character. */<tr><td><a id="l97"></a><a href="#l97">97</a><td> LRM: &#39;\u200E&#39;,<tr><td><a id="l98"></a><a href="#l98">98</a><td> /** Unicode &quot;Right-To-Left Mark&quot; (RLM) character. */<tr><td><a id="l99"></a><a href="#l99">99</a><td> RLM: &#39;\u200F&#39;<tr><td><a id="l100"></a><a href="#l100">100</a><td>};<tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td>/**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * Directionality enum.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @enum {number}<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.i18n.bidi.Dir = {<tr><td><a id="l108"></a><a href="#l108">108</a><td> /**<tr><td><a id="l109"></a><a href="#l109">109</a><td> * Left-to-right.<tr><td><a id="l110"></a><a href="#l110">110</a><td> */<tr><td><a id="l111"></a><a href="#l111">111</a><td> LTR: 1,<tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td> /**<tr><td><a id="l114"></a><a href="#l114">114</a><td> * Right-to-left.<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td> RTL: -1,<tr><td><a id="l117"></a><a href="#l117">117</a><td><tr><td><a id="l118"></a><a href="#l118">118</a><td> /**<tr><td><a id="l119"></a><a href="#l119">119</a><td> * Neither left-to-right nor right-to-left.<tr><td><a id="l120"></a><a href="#l120">120</a><td> */<tr><td><a id="l121"></a><a href="#l121">121</a><td> NEUTRAL: 0<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td>/**<tr><td><a id="l126"></a><a href="#l126">126</a><td> * &#39;right&#39; string constant.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @type {string}<tr><td><a id="l128"></a><a href="#l128">128</a><td> */<tr><td><a id="l129"></a><a href="#l129">129</a><td>goog.i18n.bidi.RIGHT = &#39;right&#39;;<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * &#39;left&#39; string constant.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @type {string}<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td>goog.i18n.bidi.LEFT = &#39;left&#39;;<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * &#39;left&#39; if locale is RTL, &#39;right&#39; if not.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @type {string}<tr><td><a id="l142"></a><a href="#l142">142</a><td> */<tr><td><a id="l143"></a><a href="#l143">143</a><td>goog.i18n.bidi.I18N_RIGHT = goog.i18n.bidi.IS_RTL ? goog.i18n.bidi.LEFT :<tr><td><a id="l144"></a><a href="#l144">144</a><td> goog.i18n.bidi.RIGHT;<tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td><tr><td><a id="l147"></a><a href="#l147">147</a><td>/**<tr><td><a id="l148"></a><a href="#l148">148</a><td> * &#39;right&#39; if locale is RTL, &#39;left&#39; if not.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @type {string}<tr><td><a id="l150"></a><a href="#l150">150</a><td> */<tr><td><a id="l151"></a><a href="#l151">151</a><td>goog.i18n.bidi.I18N_LEFT = goog.i18n.bidi.IS_RTL ? goog.i18n.bidi.RIGHT :<tr><td><a id="l152"></a><a href="#l152">152</a><td> goog.i18n.bidi.LEFT;<tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td>/**<tr><td><a id="l156"></a><a href="#l156">156</a><td> * Convert a directionality given in various formats to a goog.i18n.bidi.Dir<tr><td><a id="l157"></a><a href="#l157">157</a><td> * constant. Useful for interaction with different standards of directionality<tr><td><a id="l158"></a><a href="#l158">158</a><td> * representation.<tr><td><a id="l159"></a><a href="#l159">159</a><td> *<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @param {goog.i18n.bidi.Dir|number|boolean|null} givenDir Directionality given<tr><td><a id="l161"></a><a href="#l161">161</a><td> * in one of the following formats:<tr><td><a id="l162"></a><a href="#l162">162</a><td> * 1. A goog.i18n.bidi.Dir constant.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * 2. A number (positive = LTR, negative = RTL, 0 = neutral).<tr><td><a id="l164"></a><a href="#l164">164</a><td> * 3. A boolean (true = RTL, false = LTR).<tr><td><a id="l165"></a><a href="#l165">165</a><td> * 4. A null for unknown directionality.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {boolean=} opt_noNeutral Whether a givenDir of zero or<tr><td><a id="l167"></a><a href="#l167">167</a><td> * goog.i18n.bidi.Dir.NEUTRAL should be treated as null, i.e. unknown, in<tr><td><a id="l168"></a><a href="#l168">168</a><td> * order to preserve legacy behavior.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @return {?goog.i18n.bidi.Dir} A goog.i18n.bidi.Dir constant matching the<tr><td><a id="l170"></a><a href="#l170">170</a><td> * given directionality. If given null, returns null (i.e. unknown).<tr><td><a id="l171"></a><a href="#l171">171</a><td> */<tr><td><a id="l172"></a><a href="#l172">172</a><td>goog.i18n.bidi.toDir = function(givenDir, opt_noNeutral) {<tr><td><a id="l173"></a><a href="#l173">173</a><td> if (typeof givenDir == &#39;number&#39;) {<tr><td><a id="l174"></a><a href="#l174">174</a><td> // This includes the non-null goog.i18n.bidi.Dir case.<tr><td><a id="l175"></a><a href="#l175">175</a><td> return givenDir &gt; 0 ? goog.i18n.bidi.Dir.LTR :<tr><td><a id="l176"></a><a href="#l176">176</a><td> givenDir &lt; 0 ? goog.i18n.bidi.Dir.RTL :<tr><td><a id="l177"></a><a href="#l177">177</a><td> opt_noNeutral ? null : goog.i18n.bidi.Dir.NEUTRAL;<tr><td><a id="l178"></a><a href="#l178">178</a><td> } else if (givenDir == null) {<tr><td><a id="l179"></a><a href="#l179">179</a><td> return null;<tr><td><a id="l180"></a><a href="#l180">180</a><td> } else {<tr><td><a id="l181"></a><a href="#l181">181</a><td> // Must be typeof givenDir == &#39;boolean&#39;.<tr><td><a id="l182"></a><a href="#l182">182</a><td> return givenDir ? goog.i18n.bidi.Dir.RTL : goog.i18n.bidi.Dir.LTR;<tr><td><a id="l183"></a><a href="#l183">183</a><td> }<tr><td><a id="l184"></a><a href="#l184">184</a><td>};<tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td><tr><td><a id="l187"></a><a href="#l187">187</a><td>/**<tr><td><a id="l188"></a><a href="#l188">188</a><td> * A practical pattern to identify strong LTR characters. This pattern is not<tr><td><a id="l189"></a><a href="#l189">189</a><td> * theoretically correct according to the Unicode standard. It is simplified for<tr><td><a id="l190"></a><a href="#l190">190</a><td> * performance and small code size.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @type {string}<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @private<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>goog.i18n.bidi.ltrChars_ =<tr><td><a id="l195"></a><a href="#l195">195</a><td> &#39;A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02B8\u0300-\u0590\u0800-\u1FFF&#39; +<tr><td><a id="l196"></a><a href="#l196">196</a><td> &#39;\u200E\u2C00-\uFB1C\uFE00-\uFE6F\uFEFD-\uFFFF&#39;;<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>/**<tr><td><a id="l200"></a><a href="#l200">200</a><td> * A practical pattern to identify strong RTL character. This pattern is not<tr><td><a id="l201"></a><a href="#l201">201</a><td> * theoretically correct according to the Unicode standard. It is simplified<tr><td><a id="l202"></a><a href="#l202">202</a><td> * for performance and small code size.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @type {string}<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @private<tr><td><a id="l205"></a><a href="#l205">205</a><td> */<tr><td><a id="l206"></a><a href="#l206">206</a><td>goog.i18n.bidi.rtlChars_ =<tr><td><a id="l207"></a><a href="#l207">207</a><td> &#39;\u0591-\u06EF\u06FA-\u07FF\u200F\uFB1D-\uFDFF\uFE70-\uFEFC&#39;;<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td>/**<tr><td><a id="l211"></a><a href="#l211">211</a><td> * Simplified regular expression for an HTML tag (opening or closing) or an HTML<tr><td><a id="l212"></a><a href="#l212">212</a><td> * escape. We might want to skip over such expressions when estimating the text<tr><td><a id="l213"></a><a href="#l213">213</a><td> * directionality.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @type {RegExp}<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @private<tr><td><a id="l216"></a><a href="#l216">216</a><td> */<tr><td><a id="l217"></a><a href="#l217">217</a><td>goog.i18n.bidi.htmlSkipReg_ = /&lt;[^&gt;]*&gt;|&amp;[^;]+;/g;<tr><td><a id="l218"></a><a href="#l218">218</a><td><tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td>/**<tr><td><a id="l221"></a><a href="#l221">221</a><td> * Returns the input text with spaces instead of HTML tags or HTML escapes, if<tr><td><a id="l222"></a><a href="#l222">222</a><td> * opt_isStripNeeded is true. Else returns the input as is.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * Useful for text directionality estimation.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * Note: the function should not be used in other contexts; it is not 100%<tr><td><a id="l225"></a><a href="#l225">225</a><td> * correct, but rather a good-enough implementation for directionality<tr><td><a id="l226"></a><a href="#l226">226</a><td> * estimation purposes.<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @param {string} str The given string.<tr><td><a id="l228"></a><a href="#l228">228</a><td> * @param {boolean=} opt_isStripNeeded Whether to perform the stripping.<tr><td><a id="l229"></a><a href="#l229">229</a><td> * Default: false (to retain consistency with calling functions).<tr><td><a id="l230"></a><a href="#l230">230</a><td> * @return {string} The given string cleaned of HTML tags / escapes.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @private<tr><td><a id="l232"></a><a href="#l232">232</a><td> */<tr><td><a id="l233"></a><a href="#l233">233</a><td>goog.i18n.bidi.stripHtmlIfNeeded_ = function(str, opt_isStripNeeded) {<tr><td><a id="l234"></a><a href="#l234">234</a><td> return opt_isStripNeeded ? str.replace(goog.i18n.bidi.htmlSkipReg_, &#39;&#39;) :<tr><td><a id="l235"></a><a href="#l235">235</a><td> str;<tr><td><a id="l236"></a><a href="#l236">236</a><td>};<tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td><tr><td><a id="l239"></a><a href="#l239">239</a><td>/**<tr><td><a id="l240"></a><a href="#l240">240</a><td> * Regular expression to check for RTL characters.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @type {RegExp}<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @private<tr><td><a id="l243"></a><a href="#l243">243</a><td> */<tr><td><a id="l244"></a><a href="#l244">244</a><td>goog.i18n.bidi.rtlCharReg_ = new RegExp(&#39;[&#39; + goog.i18n.bidi.rtlChars_ + &#39;]&#39;);<tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>/**<tr><td><a id="l248"></a><a href="#l248">248</a><td> * Regular expression to check for LTR characters.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @type {RegExp}<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @private<tr><td><a id="l251"></a><a href="#l251">251</a><td> */<tr><td><a id="l252"></a><a href="#l252">252</a><td>goog.i18n.bidi.ltrCharReg_ = new RegExp(&#39;[&#39; + goog.i18n.bidi.ltrChars_ + &#39;]&#39;);<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Test whether the given string has any RTL characters in it.<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l259"></a><a href="#l259">259</a><td> * Default: false.<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @return {boolean} Whether the string contains RTL characters.<tr><td><a id="l261"></a><a href="#l261">261</a><td> */<tr><td><a id="l262"></a><a href="#l262">262</a><td>goog.i18n.bidi.hasAnyRtl = function(str, opt_isHtml) {<tr><td><a id="l263"></a><a href="#l263">263</a><td> return goog.i18n.bidi.rtlCharReg_.test(goog.i18n.bidi.stripHtmlIfNeeded_(<tr><td><a id="l264"></a><a href="#l264">264</a><td> str, opt_isHtml));<tr><td><a id="l265"></a><a href="#l265">265</a><td>};<tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td>/**<tr><td><a id="l269"></a><a href="#l269">269</a><td> * Test whether the given string has any RTL characters in it.<tr><td><a id="l270"></a><a href="#l270">270</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @return {boolean} Whether the string contains RTL characters.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @deprecated Use hasAnyRtl.<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td>goog.i18n.bidi.hasRtlChar = goog.i18n.bidi.hasAnyRtl;<tr><td><a id="l275"></a><a href="#l275">275</a><td><tr><td><a id="l276"></a><a href="#l276">276</a><td><tr><td><a id="l277"></a><a href="#l277">277</a><td>/**<tr><td><a id="l278"></a><a href="#l278">278</a><td> * Test whether the given string has any LTR characters in it.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * Default: false.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @return {boolean} Whether the string contains LTR characters.<tr><td><a id="l283"></a><a href="#l283">283</a><td> */<tr><td><a id="l284"></a><a href="#l284">284</a><td>goog.i18n.bidi.hasAnyLtr = function(str, opt_isHtml) {<tr><td><a id="l285"></a><a href="#l285">285</a><td> return goog.i18n.bidi.ltrCharReg_.test(goog.i18n.bidi.stripHtmlIfNeeded_(<tr><td><a id="l286"></a><a href="#l286">286</a><td> str, opt_isHtml));<tr><td><a id="l287"></a><a href="#l287">287</a><td>};<tr><td><a id="l288"></a><a href="#l288">288</a><td><tr><td><a id="l289"></a><a href="#l289">289</a><td><tr><td><a id="l290"></a><a href="#l290">290</a><td>/**<tr><td><a id="l291"></a><a href="#l291">291</a><td> * Regular expression pattern to check if the first character in the string<tr><td><a id="l292"></a><a href="#l292">292</a><td> * is LTR.<tr><td><a id="l293"></a><a href="#l293">293</a><td> * @type {RegExp}<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @private<tr><td><a id="l295"></a><a href="#l295">295</a><td> */<tr><td><a id="l296"></a><a href="#l296">296</a><td>goog.i18n.bidi.ltrRe_ = new RegExp(&#39;^[&#39; + goog.i18n.bidi.ltrChars_ + &#39;]&#39;);<tr><td><a id="l297"></a><a href="#l297">297</a><td><tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td>/**<tr><td><a id="l300"></a><a href="#l300">300</a><td> * Regular expression pattern to check if the first character in the string<tr><td><a id="l301"></a><a href="#l301">301</a><td> * is RTL.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @type {RegExp}<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @private<tr><td><a id="l304"></a><a href="#l304">304</a><td> */<tr><td><a id="l305"></a><a href="#l305">305</a><td>goog.i18n.bidi.rtlRe_ = new RegExp(&#39;^[&#39; + goog.i18n.bidi.rtlChars_ + &#39;]&#39;);<tr><td><a id="l306"></a><a href="#l306">306</a><td><tr><td><a id="l307"></a><a href="#l307">307</a><td><tr><td><a id="l308"></a><a href="#l308">308</a><td>/**<tr><td><a id="l309"></a><a href="#l309">309</a><td> * Check if the first character in the string is RTL or not.<tr><td><a id="l310"></a><a href="#l310">310</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l311"></a><a href="#l311">311</a><td> * @return {boolean} Whether the first character in str is an RTL char.<tr><td><a id="l312"></a><a href="#l312">312</a><td> */<tr><td><a id="l313"></a><a href="#l313">313</a><td>goog.i18n.bidi.isRtlChar = function(str) {<tr><td><a id="l314"></a><a href="#l314">314</a><td> return goog.i18n.bidi.rtlRe_.test(str);<tr><td><a id="l315"></a><a href="#l315">315</a><td>};<tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td>/**<tr><td><a id="l319"></a><a href="#l319">319</a><td> * Check if the first character in the string is LTR or not.<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @return {boolean} Whether the first character in str is an LTR char.<tr><td><a id="l322"></a><a href="#l322">322</a><td> */<tr><td><a id="l323"></a><a href="#l323">323</a><td>goog.i18n.bidi.isLtrChar = function(str) {<tr><td><a id="l324"></a><a href="#l324">324</a><td> return goog.i18n.bidi.ltrRe_.test(str);<tr><td><a id="l325"></a><a href="#l325">325</a><td>};<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>/**<tr><td><a id="l329"></a><a href="#l329">329</a><td> * Check if the first character in the string is neutral or not.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @return {boolean} Whether the first character in str is a neutral char.<tr><td><a id="l332"></a><a href="#l332">332</a><td> */<tr><td><a id="l333"></a><a href="#l333">333</a><td>goog.i18n.bidi.isNeutralChar = function(str) {<tr><td><a id="l334"></a><a href="#l334">334</a><td> return !goog.i18n.bidi.isLtrChar(str) &amp;&amp; !goog.i18n.bidi.isRtlChar(str);<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td>/**<tr><td><a id="l339"></a><a href="#l339">339</a><td> * Regular expressions to check if a piece of text is of LTR directionality<tr><td><a id="l340"></a><a href="#l340">340</a><td> * on first character with strong directionality.<tr><td><a id="l341"></a><a href="#l341">341</a><td> * @type {RegExp}<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @private<tr><td><a id="l343"></a><a href="#l343">343</a><td> */<tr><td><a id="l344"></a><a href="#l344">344</a><td>goog.i18n.bidi.ltrDirCheckRe_ = new RegExp(<tr><td><a id="l345"></a><a href="#l345">345</a><td> &#39;^[^&#39; + goog.i18n.bidi.rtlChars_ + &#39;]*[&#39; + goog.i18n.bidi.ltrChars_ + &#39;]&#39;);<tr><td><a id="l346"></a><a href="#l346">346</a><td><tr><td><a id="l347"></a><a href="#l347">347</a><td><tr><td><a id="l348"></a><a href="#l348">348</a><td>/**<tr><td><a id="l349"></a><a href="#l349">349</a><td> * Regular expressions to check if a piece of text is of RTL directionality<tr><td><a id="l350"></a><a href="#l350">350</a><td> * on first character with strong directionality.<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @type {RegExp}<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @private<tr><td><a id="l353"></a><a href="#l353">353</a><td> */<tr><td><a id="l354"></a><a href="#l354">354</a><td>goog.i18n.bidi.rtlDirCheckRe_ = new RegExp(<tr><td><a id="l355"></a><a href="#l355">355</a><td> &#39;^[^&#39; + goog.i18n.bidi.ltrChars_ + &#39;]*[&#39; + goog.i18n.bidi.rtlChars_ + &#39;]&#39;);<tr><td><a id="l356"></a><a href="#l356">356</a><td><tr><td><a id="l357"></a><a href="#l357">357</a><td><tr><td><a id="l358"></a><a href="#l358">358</a><td>/**<tr><td><a id="l359"></a><a href="#l359">359</a><td> * Check whether the first strongly directional character (if any) is RTL.<tr><td><a id="l360"></a><a href="#l360">360</a><td> * @param {string} str String being checked.<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * Default: false.<tr><td><a id="l363"></a><a href="#l363">363</a><td> * @return {boolean} Whether RTL directionality is detected using the first<tr><td><a id="l364"></a><a href="#l364">364</a><td> * strongly-directional character method.<tr><td><a id="l365"></a><a href="#l365">365</a><td> */<tr><td><a id="l366"></a><a href="#l366">366</a><td>goog.i18n.bidi.startsWithRtl = function(str, opt_isHtml) {<tr><td><a id="l367"></a><a href="#l367">367</a><td> return goog.i18n.bidi.rtlDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(<tr><td><a id="l368"></a><a href="#l368">368</a><td> str, opt_isHtml));<tr><td><a id="l369"></a><a href="#l369">369</a><td>};<tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td><tr><td><a id="l372"></a><a href="#l372">372</a><td>/**<tr><td><a id="l373"></a><a href="#l373">373</a><td> * Check whether the first strongly directional character (if any) is RTL.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {string} str String being checked.<tr><td><a id="l375"></a><a href="#l375">375</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l376"></a><a href="#l376">376</a><td> * Default: false.<tr><td><a id="l377"></a><a href="#l377">377</a><td> * @return {boolean} Whether RTL directionality is detected using the first<tr><td><a id="l378"></a><a href="#l378">378</a><td> * strongly-directional character method.<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @deprecated Use startsWithRtl.<tr><td><a id="l380"></a><a href="#l380">380</a><td> */<tr><td><a id="l381"></a><a href="#l381">381</a><td>goog.i18n.bidi.isRtlText = goog.i18n.bidi.startsWithRtl;<tr><td><a id="l382"></a><a href="#l382">382</a><td><tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td>/**<tr><td><a id="l385"></a><a href="#l385">385</a><td> * Check whether the first strongly directional character (if any) is LTR.<tr><td><a id="l386"></a><a href="#l386">386</a><td> * @param {string} str String being checked.<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l388"></a><a href="#l388">388</a><td> * Default: false.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @return {boolean} Whether LTR directionality is detected using the first<tr><td><a id="l390"></a><a href="#l390">390</a><td> * strongly-directional character method.<tr><td><a id="l391"></a><a href="#l391">391</a><td> */<tr><td><a id="l392"></a><a href="#l392">392</a><td>goog.i18n.bidi.startsWithLtr = function(str, opt_isHtml) {<tr><td><a id="l393"></a><a href="#l393">393</a><td> return goog.i18n.bidi.ltrDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(<tr><td><a id="l394"></a><a href="#l394">394</a><td> str, opt_isHtml));<tr><td><a id="l395"></a><a href="#l395">395</a><td>};<tr><td><a id="l396"></a><a href="#l396">396</a><td><tr><td><a id="l397"></a><a href="#l397">397</a><td><tr><td><a id="l398"></a><a href="#l398">398</a><td>/**<tr><td><a id="l399"></a><a href="#l399">399</a><td> * Check whether the first strongly directional character (if any) is LTR.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @param {string} str String being checked.<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l402"></a><a href="#l402">402</a><td> * Default: false.<tr><td><a id="l403"></a><a href="#l403">403</a><td> * @return {boolean} Whether LTR directionality is detected using the first<tr><td><a id="l404"></a><a href="#l404">404</a><td> * strongly-directional character method.<tr><td><a id="l405"></a><a href="#l405">405</a><td> * @deprecated Use startsWithLtr.<tr><td><a id="l406"></a><a href="#l406">406</a><td> */<tr><td><a id="l407"></a><a href="#l407">407</a><td>goog.i18n.bidi.isLtrText = goog.i18n.bidi.startsWithLtr;<tr><td><a id="l408"></a><a href="#l408">408</a><td><tr><td><a id="l409"></a><a href="#l409">409</a><td><tr><td><a id="l410"></a><a href="#l410">410</a><td>/**<tr><td><a id="l411"></a><a href="#l411">411</a><td> * Regular expression to check if a string looks like something that must<tr><td><a id="l412"></a><a href="#l412">412</a><td> * always be LTR even in RTL text, e.g. a URL. When estimating the<tr><td><a id="l413"></a><a href="#l413">413</a><td> * directionality of text containing these, we treat these as weakly LTR,<tr><td><a id="l414"></a><a href="#l414">414</a><td> * like numbers.<tr><td><a id="l415"></a><a href="#l415">415</a><td> * @type {RegExp}<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @private<tr><td><a id="l417"></a><a href="#l417">417</a><td> */<tr><td><a id="l418"></a><a href="#l418">418</a><td>goog.i18n.bidi.isRequiredLtrRe_ = /^http:\/\/.*/;<tr><td><a id="l419"></a><a href="#l419">419</a><td><tr><td><a id="l420"></a><a href="#l420">420</a><td><tr><td><a id="l421"></a><a href="#l421">421</a><td>/**<tr><td><a id="l422"></a><a href="#l422">422</a><td> * Check whether the input string either contains no strongly directional<tr><td><a id="l423"></a><a href="#l423">423</a><td> * characters or looks like a url.<tr><td><a id="l424"></a><a href="#l424">424</a><td> * @param {string} str String being checked.<tr><td><a id="l425"></a><a href="#l425">425</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l426"></a><a href="#l426">426</a><td> * Default: false.<tr><td><a id="l427"></a><a href="#l427">427</a><td> * @return {boolean} Whether neutral directionality is detected.<tr><td><a id="l428"></a><a href="#l428">428</a><td> */<tr><td><a id="l429"></a><a href="#l429">429</a><td>goog.i18n.bidi.isNeutralText = function(str, opt_isHtml) {<tr><td><a id="l430"></a><a href="#l430">430</a><td> str = goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml);<tr><td><a id="l431"></a><a href="#l431">431</a><td> return goog.i18n.bidi.isRequiredLtrRe_.test(str) ||<tr><td><a id="l432"></a><a href="#l432">432</a><td> !goog.i18n.bidi.hasAnyLtr(str) &amp;&amp; !goog.i18n.bidi.hasAnyRtl(str);<tr><td><a id="l433"></a><a href="#l433">433</a><td>};<tr><td><a id="l434"></a><a href="#l434">434</a><td><tr><td><a id="l435"></a><a href="#l435">435</a><td><tr><td><a id="l436"></a><a href="#l436">436</a><td>/**<tr><td><a id="l437"></a><a href="#l437">437</a><td> * Regular expressions to check if the last strongly-directional character in a<tr><td><a id="l438"></a><a href="#l438">438</a><td> * piece of text is LTR.<tr><td><a id="l439"></a><a href="#l439">439</a><td> * @type {RegExp}<tr><td><a id="l440"></a><a href="#l440">440</a><td> * @private<tr><td><a id="l441"></a><a href="#l441">441</a><td> */<tr><td><a id="l442"></a><a href="#l442">442</a><td>goog.i18n.bidi.ltrExitDirCheckRe_ = new RegExp(<tr><td><a id="l443"></a><a href="#l443">443</a><td> &#39;[&#39; + goog.i18n.bidi.ltrChars_ + &#39;][^&#39; + goog.i18n.bidi.rtlChars_ + &#39;]*$&#39;);<tr><td><a id="l444"></a><a href="#l444">444</a><td><tr><td><a id="l445"></a><a href="#l445">445</a><td><tr><td><a id="l446"></a><a href="#l446">446</a><td>/**<tr><td><a id="l447"></a><a href="#l447">447</a><td> * Regular expressions to check if the last strongly-directional character in a<tr><td><a id="l448"></a><a href="#l448">448</a><td> * piece of text is RTL.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @type {RegExp}<tr><td><a id="l450"></a><a href="#l450">450</a><td> * @private<tr><td><a id="l451"></a><a href="#l451">451</a><td> */<tr><td><a id="l452"></a><a href="#l452">452</a><td>goog.i18n.bidi.rtlExitDirCheckRe_ = new RegExp(<tr><td><a id="l453"></a><a href="#l453">453</a><td> &#39;[&#39; + goog.i18n.bidi.rtlChars_ + &#39;][^&#39; + goog.i18n.bidi.ltrChars_ + &#39;]*$&#39;);<tr><td><a id="l454"></a><a href="#l454">454</a><td><tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td>/**<tr><td><a id="l457"></a><a href="#l457">457</a><td> * Check if the exit directionality a piece of text is LTR, i.e. if the last<tr><td><a id="l458"></a><a href="#l458">458</a><td> * strongly-directional character in the string is LTR.<tr><td><a id="l459"></a><a href="#l459">459</a><td> * @param {string} str String being checked.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l461"></a><a href="#l461">461</a><td> * Default: false.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @return {boolean} Whether LTR exit directionality was detected.<tr><td><a id="l463"></a><a href="#l463">463</a><td> */<tr><td><a id="l464"></a><a href="#l464">464</a><td>goog.i18n.bidi.endsWithLtr = function(str, opt_isHtml) {<tr><td><a id="l465"></a><a href="#l465">465</a><td> return goog.i18n.bidi.ltrExitDirCheckRe_.test(<tr><td><a id="l466"></a><a href="#l466">466</a><td> goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml));<tr><td><a id="l467"></a><a href="#l467">467</a><td>};<tr><td><a id="l468"></a><a href="#l468">468</a><td><tr><td><a id="l469"></a><a href="#l469">469</a><td><tr><td><a id="l470"></a><a href="#l470">470</a><td>/**<tr><td><a id="l471"></a><a href="#l471">471</a><td> * Check if the exit directionality a piece of text is LTR, i.e. if the last<tr><td><a id="l472"></a><a href="#l472">472</a><td> * strongly-directional character in the string is LTR.<tr><td><a id="l473"></a><a href="#l473">473</a><td> * @param {string} str String being checked.<tr><td><a id="l474"></a><a href="#l474">474</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l475"></a><a href="#l475">475</a><td> * Default: false.<tr><td><a id="l476"></a><a href="#l476">476</a><td> * @return {boolean} Whether LTR exit directionality was detected.<tr><td><a id="l477"></a><a href="#l477">477</a><td> * @deprecated Use endsWithLtr.<tr><td><a id="l478"></a><a href="#l478">478</a><td> */<tr><td><a id="l479"></a><a href="#l479">479</a><td>goog.i18n.bidi.isLtrExitText = goog.i18n.bidi.endsWithLtr;<tr><td><a id="l480"></a><a href="#l480">480</a><td><tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td>/**<tr><td><a id="l483"></a><a href="#l483">483</a><td> * Check if the exit directionality a piece of text is RTL, i.e. if the last<tr><td><a id="l484"></a><a href="#l484">484</a><td> * strongly-directional character in the string is RTL.<tr><td><a id="l485"></a><a href="#l485">485</a><td> * @param {string} str String being checked.<tr><td><a id="l486"></a><a href="#l486">486</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l487"></a><a href="#l487">487</a><td> * Default: false.<tr><td><a id="l488"></a><a href="#l488">488</a><td> * @return {boolean} Whether RTL exit directionality was detected.<tr><td><a id="l489"></a><a href="#l489">489</a><td> */<tr><td><a id="l490"></a><a href="#l490">490</a><td>goog.i18n.bidi.endsWithRtl = function(str, opt_isHtml) {<tr><td><a id="l491"></a><a href="#l491">491</a><td> return goog.i18n.bidi.rtlExitDirCheckRe_.test(<tr><td><a id="l492"></a><a href="#l492">492</a><td> goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml));<tr><td><a id="l493"></a><a href="#l493">493</a><td>};<tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td><tr><td><a id="l496"></a><a href="#l496">496</a><td>/**<tr><td><a id="l497"></a><a href="#l497">497</a><td> * Check if the exit directionality a piece of text is RTL, i.e. if the last<tr><td><a id="l498"></a><a href="#l498">498</a><td> * strongly-directional character in the string is RTL.<tr><td><a id="l499"></a><a href="#l499">499</a><td> * @param {string} str String being checked.<tr><td><a id="l500"></a><a href="#l500">500</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l501"></a><a href="#l501">501</a><td> * Default: false.<tr><td><a id="l502"></a><a href="#l502">502</a><td> * @return {boolean} Whether RTL exit directionality was detected.<tr><td><a id="l503"></a><a href="#l503">503</a><td> * @deprecated Use endsWithRtl.<tr><td><a id="l504"></a><a href="#l504">504</a><td> */<tr><td><a id="l505"></a><a href="#l505">505</a><td>goog.i18n.bidi.isRtlExitText = goog.i18n.bidi.endsWithRtl;<tr><td><a id="l506"></a><a href="#l506">506</a><td><tr><td><a id="l507"></a><a href="#l507">507</a><td><tr><td><a id="l508"></a><a href="#l508">508</a><td>/**<tr><td><a id="l509"></a><a href="#l509">509</a><td> * A regular expression for matching right-to-left language codes.<tr><td><a id="l510"></a><a href="#l510">510</a><td> * See {@link #isRtlLanguage} for the design.<tr><td><a id="l511"></a><a href="#l511">511</a><td> * @type {RegExp}<tr><td><a id="l512"></a><a href="#l512">512</a><td> * @private<tr><td><a id="l513"></a><a href="#l513">513</a><td> */<tr><td><a id="l514"></a><a href="#l514">514</a><td>goog.i18n.bidi.rtlLocalesRe_ = new RegExp(<tr><td><a id="l515"></a><a href="#l515">515</a><td> &#39;^(ar|ckb|dv|he|iw|fa|nqo|ps|sd|ug|ur|yi|&#39; +<tr><td><a id="l516"></a><a href="#l516">516</a><td> &#39;.*[-_](Arab|Hebr|Thaa|Nkoo|Tfng))&#39; +<tr><td><a id="l517"></a><a href="#l517">517</a><td> &#39;(?!.*[-_](Latn|Cyrl)($|-|_))($|-|_)&#39;,<tr><td><a id="l518"></a><a href="#l518">518</a><td> &#39;i&#39;);<tr><td><a id="l519"></a><a href="#l519">519</a><td><tr><td><a id="l520"></a><a href="#l520">520</a><td><tr><td><a id="l521"></a><a href="#l521">521</a><td>/**<tr><td><a id="l522"></a><a href="#l522">522</a><td> * Check if a BCP 47 / III language code indicates an RTL language, i.e. either:<tr><td><a id="l523"></a><a href="#l523">523</a><td> * - a language code explicitly specifying one of the right-to-left scripts,<tr><td><a id="l524"></a><a href="#l524">524</a><td> * e.g. &quot;az-Arab&quot;, or&lt;p&gt;<tr><td><a id="l525"></a><a href="#l525">525</a><td> * - a language code specifying one of the languages normally written in a<tr><td><a id="l526"></a><a href="#l526">526</a><td> * right-to-left script, e.g. &quot;fa&quot; (Farsi), except ones explicitly specifying<tr><td><a id="l527"></a><a href="#l527">527</a><td> * Latin or Cyrillic script (which are the usual LTR alternatives).&lt;p&gt;<tr><td><a id="l528"></a><a href="#l528">528</a><td> * The list of right-to-left scripts appears in the 100-199 range in<tr><td><a id="l529"></a><a href="#l529">529</a><td> * http://www.unicode.org/iso15924/iso15924-num.html, of which Arabic and<tr><td><a id="l530"></a><a href="#l530">530</a><td> * Hebrew are by far the most widely used. We also recognize Thaana, N&#39;Ko, and<tr><td><a id="l531"></a><a href="#l531">531</a><td> * Tifinagh, which also have significant modern usage. The rest (Syriac,<tr><td><a id="l532"></a><a href="#l532">532</a><td> * Samaritan, Mandaic, etc.) seem to have extremely limited or no modern usage<tr><td><a id="l533"></a><a href="#l533">533</a><td> * and are not recognized to save on code size.<tr><td><a id="l534"></a><a href="#l534">534</a><td> * The languages usually written in a right-to-left script are taken as those<tr><td><a id="l535"></a><a href="#l535">535</a><td> * with Suppress-Script: Hebr|Arab|Thaa|Nkoo|Tfng in<tr><td><a id="l536"></a><a href="#l536">536</a><td> * http://www.iana.org/assignments/language-subtag-registry,<tr><td><a id="l537"></a><a href="#l537">537</a><td> * as well as Central (or Sorani) Kurdish (ckb), Sindhi (sd) and Uyghur (ug).<tr><td><a id="l538"></a><a href="#l538">538</a><td> * Other subtags of the language code, e.g. regions like EG (Egypt), are<tr><td><a id="l539"></a><a href="#l539">539</a><td> * ignored.<tr><td><a id="l540"></a><a href="#l540">540</a><td> * @param {string} lang BCP 47 (a.k.a III) language code.<tr><td><a id="l541"></a><a href="#l541">541</a><td> * @return {boolean} Whether the language code is an RTL language.<tr><td><a id="l542"></a><a href="#l542">542</a><td> */<tr><td><a id="l543"></a><a href="#l543">543</a><td>goog.i18n.bidi.isRtlLanguage = function(lang) {<tr><td><a id="l544"></a><a href="#l544">544</a><td> return goog.i18n.bidi.rtlLocalesRe_.test(lang);<tr><td><a id="l545"></a><a href="#l545">545</a><td>};<tr><td><a id="l546"></a><a href="#l546">546</a><td><tr><td><a id="l547"></a><a href="#l547">547</a><td><tr><td><a id="l548"></a><a href="#l548">548</a><td>/**<tr><td><a id="l549"></a><a href="#l549">549</a><td> * Regular expression for bracket guard replacement in html.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * @type {RegExp}<tr><td><a id="l551"></a><a href="#l551">551</a><td> * @private<tr><td><a id="l552"></a><a href="#l552">552</a><td> */<tr><td><a id="l553"></a><a href="#l553">553</a><td>goog.i18n.bidi.bracketGuardHtmlRe_ =<tr><td><a id="l554"></a><a href="#l554">554</a><td> /(\(.*?\)+)|(\[.*?\]+)|(\{.*?\}+)|(&amp;lt;.*?(&amp;gt;)+)/g;<tr><td><a id="l555"></a><a href="#l555">555</a><td><tr><td><a id="l556"></a><a href="#l556">556</a><td><tr><td><a id="l557"></a><a href="#l557">557</a><td>/**<tr><td><a id="l558"></a><a href="#l558">558</a><td> * Regular expression for bracket guard replacement in text.<tr><td><a id="l559"></a><a href="#l559">559</a><td> * @type {RegExp}<tr><td><a id="l560"></a><a href="#l560">560</a><td> * @private<tr><td><a id="l561"></a><a href="#l561">561</a><td> */<tr><td><a id="l562"></a><a href="#l562">562</a><td>goog.i18n.bidi.bracketGuardTextRe_ =<tr><td><a id="l563"></a><a href="#l563">563</a><td> /(\(.*?\)+)|(\[.*?\]+)|(\{.*?\}+)|(&lt;.*?&gt;+)/g;<tr><td><a id="l564"></a><a href="#l564">564</a><td><tr><td><a id="l565"></a><a href="#l565">565</a><td><tr><td><a id="l566"></a><a href="#l566">566</a><td>/**<tr><td><a id="l567"></a><a href="#l567">567</a><td> * Apply bracket guard using html span tag. This is to address the problem of<tr><td><a id="l568"></a><a href="#l568">568</a><td> * messy bracket display frequently happens in RTL layout.<tr><td><a id="l569"></a><a href="#l569">569</a><td> * @param {string} s The string that need to be processed.<tr><td><a id="l570"></a><a href="#l570">570</a><td> * @param {boolean=} opt_isRtlContext specifies default direction (usually<tr><td><a id="l571"></a><a href="#l571">571</a><td> * direction of the UI).<tr><td><a id="l572"></a><a href="#l572">572</a><td> * @return {string} The processed string, with all bracket guarded.<tr><td><a id="l573"></a><a href="#l573">573</a><td> */<tr><td><a id="l574"></a><a href="#l574">574</a><td>goog.i18n.bidi.guardBracketInHtml = function(s, opt_isRtlContext) {<tr><td><a id="l575"></a><a href="#l575">575</a><td> var useRtl = opt_isRtlContext === undefined ?<tr><td><a id="l576"></a><a href="#l576">576</a><td> goog.i18n.bidi.hasAnyRtl(s) : opt_isRtlContext;<tr><td><a id="l577"></a><a href="#l577">577</a><td> if (useRtl) {<tr><td><a id="l578"></a><a href="#l578">578</a><td> return s.replace(goog.i18n.bidi.bracketGuardHtmlRe_,<tr><td><a id="l579"></a><a href="#l579">579</a><td> &#39;&lt;span dir=rtl&gt;$&amp;&lt;/span&gt;&#39;);<tr><td><a id="l580"></a><a href="#l580">580</a><td> }<tr><td><a id="l581"></a><a href="#l581">581</a><td> return s.replace(goog.i18n.bidi.bracketGuardHtmlRe_,<tr><td><a id="l582"></a><a href="#l582">582</a><td> &#39;&lt;span dir=ltr&gt;$&amp;&lt;/span&gt;&#39;);<tr><td><a id="l583"></a><a href="#l583">583</a><td>};<tr><td><a id="l584"></a><a href="#l584">584</a><td><tr><td><a id="l585"></a><a href="#l585">585</a><td><tr><td><a id="l586"></a><a href="#l586">586</a><td>/**<tr><td><a id="l587"></a><a href="#l587">587</a><td> * Apply bracket guard using LRM and RLM. This is to address the problem of<tr><td><a id="l588"></a><a href="#l588">588</a><td> * messy bracket display frequently happens in RTL layout.<tr><td><a id="l589"></a><a href="#l589">589</a><td> * This version works for both plain text and html. But it does not work as<tr><td><a id="l590"></a><a href="#l590">590</a><td> * good as guardBracketInHtml in some cases.<tr><td><a id="l591"></a><a href="#l591">591</a><td> * @param {string} s The string that need to be processed.<tr><td><a id="l592"></a><a href="#l592">592</a><td> * @param {boolean=} opt_isRtlContext specifies default direction (usually<tr><td><a id="l593"></a><a href="#l593">593</a><td> * direction of the UI).<tr><td><a id="l594"></a><a href="#l594">594</a><td> * @return {string} The processed string, with all bracket guarded.<tr><td><a id="l595"></a><a href="#l595">595</a><td> */<tr><td><a id="l596"></a><a href="#l596">596</a><td>goog.i18n.bidi.guardBracketInText = function(s, opt_isRtlContext) {<tr><td><a id="l597"></a><a href="#l597">597</a><td> var useRtl = opt_isRtlContext === undefined ?<tr><td><a id="l598"></a><a href="#l598">598</a><td> goog.i18n.bidi.hasAnyRtl(s) : opt_isRtlContext;<tr><td><a id="l599"></a><a href="#l599">599</a><td> var mark = useRtl ? goog.i18n.bidi.Format.RLM : goog.i18n.bidi.Format.LRM;<tr><td><a id="l600"></a><a href="#l600">600</a><td> return s.replace(goog.i18n.bidi.bracketGuardTextRe_, mark + &#39;$&amp;&#39; + mark);<tr><td><a id="l601"></a><a href="#l601">601</a><td>};<tr><td><a id="l602"></a><a href="#l602">602</a><td><tr><td><a id="l603"></a><a href="#l603">603</a><td><tr><td><a id="l604"></a><a href="#l604">604</a><td>/**<tr><td><a id="l605"></a><a href="#l605">605</a><td> * Enforce the html snippet in RTL directionality regardless overall context.<tr><td><a id="l606"></a><a href="#l606">606</a><td> * If the html piece was enclosed by tag, dir will be applied to existing<tr><td><a id="l607"></a><a href="#l607">607</a><td> * tag, otherwise a span tag will be added as wrapper. For this reason, if<tr><td><a id="l608"></a><a href="#l608">608</a><td> * html snippet start with with tag, this tag must enclose the whole piece. If<tr><td><a id="l609"></a><a href="#l609">609</a><td> * the tag already has a dir specified, this new one will override existing<tr><td><a id="l610"></a><a href="#l610">610</a><td> * one in behavior (tested on FF and IE).<tr><td><a id="l611"></a><a href="#l611">611</a><td> * @param {string} html The string that need to be processed.<tr><td><a id="l612"></a><a href="#l612">612</a><td> * @return {string} The processed string, with directionality enforced to RTL.<tr><td><a id="l613"></a><a href="#l613">613</a><td> */<tr><td><a id="l614"></a><a href="#l614">614</a><td>goog.i18n.bidi.enforceRtlInHtml = function(html) {<tr><td><a id="l615"></a><a href="#l615">615</a><td> if (html.charAt(0) == &#39;&lt;&#39;) {<tr><td><a id="l616"></a><a href="#l616">616</a><td> return html.replace(/&lt;\w+/, &#39;$&amp; dir=rtl&#39;);<tr><td><a id="l617"></a><a href="#l617">617</a><td> }<tr><td><a id="l618"></a><a href="#l618">618</a><td> // &#39;\n&#39; is important for FF so that it won&#39;t incorrectly merge span groups<tr><td><a id="l619"></a><a href="#l619">619</a><td> return &#39;\n&lt;span dir=rtl&gt;&#39; + html + &#39;&lt;/span&gt;&#39;;<tr><td><a id="l620"></a><a href="#l620">620</a><td>};<tr><td><a id="l621"></a><a href="#l621">621</a><td><tr><td><a id="l622"></a><a href="#l622">622</a><td><tr><td><a id="l623"></a><a href="#l623">623</a><td>/**<tr><td><a id="l624"></a><a href="#l624">624</a><td> * Enforce RTL on both end of the given text piece using unicode BiDi formatting<tr><td><a id="l625"></a><a href="#l625">625</a><td> * characters RLE and PDF.<tr><td><a id="l626"></a><a href="#l626">626</a><td> * @param {string} text The piece of text that need to be wrapped.<tr><td><a id="l627"></a><a href="#l627">627</a><td> * @return {string} The wrapped string after process.<tr><td><a id="l628"></a><a href="#l628">628</a><td> */<tr><td><a id="l629"></a><a href="#l629">629</a><td>goog.i18n.bidi.enforceRtlInText = function(text) {<tr><td><a id="l630"></a><a href="#l630">630</a><td> return goog.i18n.bidi.Format.RLE + text + goog.i18n.bidi.Format.PDF;<tr><td><a id="l631"></a><a href="#l631">631</a><td>};<tr><td><a id="l632"></a><a href="#l632">632</a><td><tr><td><a id="l633"></a><a href="#l633">633</a><td><tr><td><a id="l634"></a><a href="#l634">634</a><td>/**<tr><td><a id="l635"></a><a href="#l635">635</a><td> * Enforce the html snippet in RTL directionality regardless overall context.<tr><td><a id="l636"></a><a href="#l636">636</a><td> * If the html piece was enclosed by tag, dir will be applied to existing<tr><td><a id="l637"></a><a href="#l637">637</a><td> * tag, otherwise a span tag will be added as wrapper. For this reason, if<tr><td><a id="l638"></a><a href="#l638">638</a><td> * html snippet start with with tag, this tag must enclose the whole piece. If<tr><td><a id="l639"></a><a href="#l639">639</a><td> * the tag already has a dir specified, this new one will override existing<tr><td><a id="l640"></a><a href="#l640">640</a><td> * one in behavior (tested on FF and IE).<tr><td><a id="l641"></a><a href="#l641">641</a><td> * @param {string} html The string that need to be processed.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @return {string} The processed string, with directionality enforced to RTL.<tr><td><a id="l643"></a><a href="#l643">643</a><td> */<tr><td><a id="l644"></a><a href="#l644">644</a><td>goog.i18n.bidi.enforceLtrInHtml = function(html) {<tr><td><a id="l645"></a><a href="#l645">645</a><td> if (html.charAt(0) == &#39;&lt;&#39;) {<tr><td><a id="l646"></a><a href="#l646">646</a><td> return html.replace(/&lt;\w+/, &#39;$&amp; dir=ltr&#39;);<tr><td><a id="l647"></a><a href="#l647">647</a><td> }<tr><td><a id="l648"></a><a href="#l648">648</a><td> // &#39;\n&#39; is important for FF so that it won&#39;t incorrectly merge span groups<tr><td><a id="l649"></a><a href="#l649">649</a><td> return &#39;\n&lt;span dir=ltr&gt;&#39; + html + &#39;&lt;/span&gt;&#39;;<tr><td><a id="l650"></a><a href="#l650">650</a><td>};<tr><td><a id="l651"></a><a href="#l651">651</a><td><tr><td><a id="l652"></a><a href="#l652">652</a><td><tr><td><a id="l653"></a><a href="#l653">653</a><td>/**<tr><td><a id="l654"></a><a href="#l654">654</a><td> * Enforce LTR on both end of the given text piece using unicode BiDi formatting<tr><td><a id="l655"></a><a href="#l655">655</a><td> * characters LRE and PDF.<tr><td><a id="l656"></a><a href="#l656">656</a><td> * @param {string} text The piece of text that need to be wrapped.<tr><td><a id="l657"></a><a href="#l657">657</a><td> * @return {string} The wrapped string after process.<tr><td><a id="l658"></a><a href="#l658">658</a><td> */<tr><td><a id="l659"></a><a href="#l659">659</a><td>goog.i18n.bidi.enforceLtrInText = function(text) {<tr><td><a id="l660"></a><a href="#l660">660</a><td> return goog.i18n.bidi.Format.LRE + text + goog.i18n.bidi.Format.PDF;<tr><td><a id="l661"></a><a href="#l661">661</a><td>};<tr><td><a id="l662"></a><a href="#l662">662</a><td><tr><td><a id="l663"></a><a href="#l663">663</a><td><tr><td><a id="l664"></a><a href="#l664">664</a><td>/**<tr><td><a id="l665"></a><a href="#l665">665</a><td> * Regular expression to find dimensions such as &quot;padding: .3 0.4ex 5px 6;&quot;<tr><td><a id="l666"></a><a href="#l666">666</a><td> * @type {RegExp}<tr><td><a id="l667"></a><a href="#l667">667</a><td> * @private<tr><td><a id="l668"></a><a href="#l668">668</a><td> */<tr><td><a id="l669"></a><a href="#l669">669</a><td>goog.i18n.bidi.dimensionsRe_ =<tr><td><a id="l670"></a><a href="#l670">670</a><td> /:\s*([.\d][.\w]*)\s+([.\d][.\w]*)\s+([.\d][.\w]*)\s+([.\d][.\w]*)/g;<tr><td><a id="l671"></a><a href="#l671">671</a><td><tr><td><a id="l672"></a><a href="#l672">672</a><td><tr><td><a id="l673"></a><a href="#l673">673</a><td>/**<tr><td><a id="l674"></a><a href="#l674">674</a><td> * Regular expression for left.<tr><td><a id="l675"></a><a href="#l675">675</a><td> * @type {RegExp}<tr><td><a id="l676"></a><a href="#l676">676</a><td> * @private<tr><td><a id="l677"></a><a href="#l677">677</a><td> */<tr><td><a id="l678"></a><a href="#l678">678</a><td>goog.i18n.bidi.leftRe_ = /left/gi;<tr><td><a id="l679"></a><a href="#l679">679</a><td><tr><td><a id="l680"></a><a href="#l680">680</a><td><tr><td><a id="l681"></a><a href="#l681">681</a><td>/**<tr><td><a id="l682"></a><a href="#l682">682</a><td> * Regular expression for right.<tr><td><a id="l683"></a><a href="#l683">683</a><td> * @type {RegExp}<tr><td><a id="l684"></a><a href="#l684">684</a><td> * @private<tr><td><a id="l685"></a><a href="#l685">685</a><td> */<tr><td><a id="l686"></a><a href="#l686">686</a><td>goog.i18n.bidi.rightRe_ = /right/gi;<tr><td><a id="l687"></a><a href="#l687">687</a><td><tr><td><a id="l688"></a><a href="#l688">688</a><td><tr><td><a id="l689"></a><a href="#l689">689</a><td>/**<tr><td><a id="l690"></a><a href="#l690">690</a><td> * Placeholder regular expression for swapping.<tr><td><a id="l691"></a><a href="#l691">691</a><td> * @type {RegExp}<tr><td><a id="l692"></a><a href="#l692">692</a><td> * @private<tr><td><a id="l693"></a><a href="#l693">693</a><td> */<tr><td><a id="l694"></a><a href="#l694">694</a><td>goog.i18n.bidi.tempRe_ = /%%%%/g;<tr><td><a id="l695"></a><a href="#l695">695</a><td><tr><td><a id="l696"></a><a href="#l696">696</a><td><tr><td><a id="l697"></a><a href="#l697">697</a><td>/**<tr><td><a id="l698"></a><a href="#l698">698</a><td> * Swap location parameters and &#39;left&#39;/&#39;right&#39; in CSS specification. The<tr><td><a id="l699"></a><a href="#l699">699</a><td> * processed string will be suited for RTL layout. Though this function can<tr><td><a id="l700"></a><a href="#l700">700</a><td> * cover most cases, there are always exceptions. It is suggested to put<tr><td><a id="l701"></a><a href="#l701">701</a><td> * those exceptions in separate group of CSS string.<tr><td><a id="l702"></a><a href="#l702">702</a><td> * @param {string} cssStr CSS spefication string.<tr><td><a id="l703"></a><a href="#l703">703</a><td> * @return {string} Processed CSS specification string.<tr><td><a id="l704"></a><a href="#l704">704</a><td> */<tr><td><a id="l705"></a><a href="#l705">705</a><td>goog.i18n.bidi.mirrorCSS = function(cssStr) {<tr><td><a id="l706"></a><a href="#l706">706</a><td> return cssStr.<tr><td><a id="l707"></a><a href="#l707">707</a><td> // reverse dimensions<tr><td><a id="l708"></a><a href="#l708">708</a><td> replace(goog.i18n.bidi.dimensionsRe_, &#39;:$1 $4 $3 $2&#39;).<tr><td><a id="l709"></a><a href="#l709">709</a><td> replace(goog.i18n.bidi.leftRe_, &#39;%%%%&#39;). // swap left and right<tr><td><a id="l710"></a><a href="#l710">710</a><td> replace(goog.i18n.bidi.rightRe_, goog.i18n.bidi.LEFT).<tr><td><a id="l711"></a><a href="#l711">711</a><td> replace(goog.i18n.bidi.tempRe_, goog.i18n.bidi.RIGHT);<tr><td><a id="l712"></a><a href="#l712">712</a><td>};<tr><td><a id="l713"></a><a href="#l713">713</a><td><tr><td><a id="l714"></a><a href="#l714">714</a><td><tr><td><a id="l715"></a><a href="#l715">715</a><td>/**<tr><td><a id="l716"></a><a href="#l716">716</a><td> * Regular expression for hebrew double quote substitution, finding quote<tr><td><a id="l717"></a><a href="#l717">717</a><td> * directly after hebrew characters.<tr><td><a id="l718"></a><a href="#l718">718</a><td> * @type {RegExp}<tr><td><a id="l719"></a><a href="#l719">719</a><td> * @private<tr><td><a id="l720"></a><a href="#l720">720</a><td> */<tr><td><a id="l721"></a><a href="#l721">721</a><td>goog.i18n.bidi.doubleQuoteSubstituteRe_ = /([\u0591-\u05f2])&quot;/g;<tr><td><a id="l722"></a><a href="#l722">722</a><td><tr><td><a id="l723"></a><a href="#l723">723</a><td><tr><td><a id="l724"></a><a href="#l724">724</a><td>/**<tr><td><a id="l725"></a><a href="#l725">725</a><td> * Regular expression for hebrew single quote substitution, finding quote<tr><td><a id="l726"></a><a href="#l726">726</a><td> * directly after hebrew characters.<tr><td><a id="l727"></a><a href="#l727">727</a><td> * @type {RegExp}<tr><td><a id="l728"></a><a href="#l728">728</a><td> * @private<tr><td><a id="l729"></a><a href="#l729">729</a><td> */<tr><td><a id="l730"></a><a href="#l730">730</a><td>goog.i18n.bidi.singleQuoteSubstituteRe_ = /([\u0591-\u05f2])&#39;/g;<tr><td><a id="l731"></a><a href="#l731">731</a><td><tr><td><a id="l732"></a><a href="#l732">732</a><td><tr><td><a id="l733"></a><a href="#l733">733</a><td>/**<tr><td><a id="l734"></a><a href="#l734">734</a><td> * Replace the double and single quote directly after a Hebrew character with<tr><td><a id="l735"></a><a href="#l735">735</a><td> * GERESH and GERSHAYIM. In such case, most likely that&#39;s user intention.<tr><td><a id="l736"></a><a href="#l736">736</a><td> * @param {string} str String that need to be processed.<tr><td><a id="l737"></a><a href="#l737">737</a><td> * @return {string} Processed string with double/single quote replaced.<tr><td><a id="l738"></a><a href="#l738">738</a><td> */<tr><td><a id="l739"></a><a href="#l739">739</a><td>goog.i18n.bidi.normalizeHebrewQuote = function(str) {<tr><td><a id="l740"></a><a href="#l740">740</a><td> return str.<tr><td><a id="l741"></a><a href="#l741">741</a><td> replace(goog.i18n.bidi.doubleQuoteSubstituteRe_, &#39;$1\u05f4&#39;).<tr><td><a id="l742"></a><a href="#l742">742</a><td> replace(goog.i18n.bidi.singleQuoteSubstituteRe_, &#39;$1\u05f3&#39;);<tr><td><a id="l743"></a><a href="#l743">743</a><td>};<tr><td><a id="l744"></a><a href="#l744">744</a><td><tr><td><a id="l745"></a><a href="#l745">745</a><td><tr><td><a id="l746"></a><a href="#l746">746</a><td>/**<tr><td><a id="l747"></a><a href="#l747">747</a><td> * Regular expression to split a string into &quot;words&quot; for directionality<tr><td><a id="l748"></a><a href="#l748">748</a><td> * estimation based on relative word counts.<tr><td><a id="l749"></a><a href="#l749">749</a><td> * @type {RegExp}<tr><td><a id="l750"></a><a href="#l750">750</a><td> * @private<tr><td><a id="l751"></a><a href="#l751">751</a><td> */<tr><td><a id="l752"></a><a href="#l752">752</a><td>goog.i18n.bidi.wordSeparatorRe_ = /\s+/;<tr><td><a id="l753"></a><a href="#l753">753</a><td><tr><td><a id="l754"></a><a href="#l754">754</a><td><tr><td><a id="l755"></a><a href="#l755">755</a><td>/**<tr><td><a id="l756"></a><a href="#l756">756</a><td> * Regular expression to check if a string contains any numerals. Used to<tr><td><a id="l757"></a><a href="#l757">757</a><td> * differentiate between completely neutral strings and those containing<tr><td><a id="l758"></a><a href="#l758">758</a><td> * numbers, which are weakly LTR.<tr><td><a id="l759"></a><a href="#l759">759</a><td> *<tr><td><a id="l760"></a><a href="#l760">760</a><td> * Native Arabic digits (\u0660 - \u0669) are not included because although they<tr><td><a id="l761"></a><a href="#l761">761</a><td> * do flow left-to-right inside a number, this is the case even if the overall<tr><td><a id="l762"></a><a href="#l762">762</a><td> * directionality is RTL, and a mathematical expression using these digits is<tr><td><a id="l763"></a><a href="#l763">763</a><td> * supposed to flow right-to-left overall, including unary plus and minus<tr><td><a id="l764"></a><a href="#l764">764</a><td> * appearing to the right of a number, and this does depend on the overall<tr><td><a id="l765"></a><a href="#l765">765</a><td> * directionality being RTL. The digits used in Farsi (\u06F0 - \u06F9), on the<tr><td><a id="l766"></a><a href="#l766">766</a><td> * other hand, are included, since Farsi math (including unary plus and minus)<tr><td><a id="l767"></a><a href="#l767">767</a><td> * does flow left-to-right.<tr><td><a id="l768"></a><a href="#l768">768</a><td> *<tr><td><a id="l769"></a><a href="#l769">769</a><td> * @type {RegExp}<tr><td><a id="l770"></a><a href="#l770">770</a><td> * @private<tr><td><a id="l771"></a><a href="#l771">771</a><td> */<tr><td><a id="l772"></a><a href="#l772">772</a><td>goog.i18n.bidi.hasNumeralsRe_ = /[\d\u06f0-\u06f9]/;<tr><td><a id="l773"></a><a href="#l773">773</a><td><tr><td><a id="l774"></a><a href="#l774">774</a><td><tr><td><a id="l775"></a><a href="#l775">775</a><td>/**<tr><td><a id="l776"></a><a href="#l776">776</a><td> * This constant controls threshold of RTL directionality.<tr><td><a id="l777"></a><a href="#l777">777</a><td> * @type {number}<tr><td><a id="l778"></a><a href="#l778">778</a><td> * @private<tr><td><a id="l779"></a><a href="#l779">779</a><td> */<tr><td><a id="l780"></a><a href="#l780">780</a><td>goog.i18n.bidi.rtlDetectionThreshold_ = 0.40;<tr><td><a id="l781"></a><a href="#l781">781</a><td><tr><td><a id="l782"></a><a href="#l782">782</a><td><tr><td><a id="l783"></a><a href="#l783">783</a><td>/**<tr><td><a id="l784"></a><a href="#l784">784</a><td> * Estimates the directionality of a string based on relative word counts.<tr><td><a id="l785"></a><a href="#l785">785</a><td> * If the number of RTL words is above a certain percentage of the total number<tr><td><a id="l786"></a><a href="#l786">786</a><td> * of strongly directional words, returns RTL.<tr><td><a id="l787"></a><a href="#l787">787</a><td> * Otherwise, if any words are strongly or weakly LTR, returns LTR.<tr><td><a id="l788"></a><a href="#l788">788</a><td> * Otherwise, returns UNKNOWN, which is used to mean &quot;neutral&quot;.<tr><td><a id="l789"></a><a href="#l789">789</a><td> * Numbers are counted as weakly LTR.<tr><td><a id="l790"></a><a href="#l790">790</a><td> * @param {string} str The string to be checked.<tr><td><a id="l791"></a><a href="#l791">791</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l792"></a><a href="#l792">792</a><td> * Default: false.<tr><td><a id="l793"></a><a href="#l793">793</a><td> * @return {goog.i18n.bidi.Dir} Estimated overall directionality of {@code str}.<tr><td><a id="l794"></a><a href="#l794">794</a><td> */<tr><td><a id="l795"></a><a href="#l795">795</a><td>goog.i18n.bidi.estimateDirection = function(str, opt_isHtml) {<tr><td><a id="l796"></a><a href="#l796">796</a><td> var rtlCount = 0;<tr><td><a id="l797"></a><a href="#l797">797</a><td> var totalCount = 0;<tr><td><a id="l798"></a><a href="#l798">798</a><td> var hasWeaklyLtr = false;<tr><td><a id="l799"></a><a href="#l799">799</a><td> var tokens = goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml).<tr><td><a id="l800"></a><a href="#l800">800</a><td> split(goog.i18n.bidi.wordSeparatorRe_);<tr><td><a id="l801"></a><a href="#l801">801</a><td> for (var i = 0; i &lt; tokens.length; i++) {<tr><td><a id="l802"></a><a href="#l802">802</a><td> var token = tokens[i];<tr><td><a id="l803"></a><a href="#l803">803</a><td> if (goog.i18n.bidi.startsWithRtl(token)) {<tr><td><a id="l804"></a><a href="#l804">804</a><td> rtlCount++;<tr><td><a id="l805"></a><a href="#l805">805</a><td> totalCount++;<tr><td><a id="l806"></a><a href="#l806">806</a><td> } else if (goog.i18n.bidi.isRequiredLtrRe_.test(token)) {<tr><td><a id="l807"></a><a href="#l807">807</a><td> hasWeaklyLtr = true;<tr><td><a id="l808"></a><a href="#l808">808</a><td> } else if (goog.i18n.bidi.hasAnyLtr(token)) {<tr><td><a id="l809"></a><a href="#l809">809</a><td> totalCount++;<tr><td><a id="l810"></a><a href="#l810">810</a><td> } else if (goog.i18n.bidi.hasNumeralsRe_.test(token)) {<tr><td><a id="l811"></a><a href="#l811">811</a><td> hasWeaklyLtr = true;<tr><td><a id="l812"></a><a href="#l812">812</a><td> }<tr><td><a id="l813"></a><a href="#l813">813</a><td> }<tr><td><a id="l814"></a><a href="#l814">814</a><td><tr><td><a id="l815"></a><a href="#l815">815</a><td> return totalCount == 0 ?<tr><td><a id="l816"></a><a href="#l816">816</a><td> (hasWeaklyLtr ? goog.i18n.bidi.Dir.LTR : goog.i18n.bidi.Dir.NEUTRAL) :<tr><td><a id="l817"></a><a href="#l817">817</a><td> (rtlCount / totalCount &gt; goog.i18n.bidi.rtlDetectionThreshold_ ?<tr><td><a id="l818"></a><a href="#l818">818</a><td> goog.i18n.bidi.Dir.RTL : goog.i18n.bidi.Dir.LTR);<tr><td><a id="l819"></a><a href="#l819">819</a><td>};<tr><td><a id="l820"></a><a href="#l820">820</a><td><tr><td><a id="l821"></a><a href="#l821">821</a><td><tr><td><a id="l822"></a><a href="#l822">822</a><td>/**<tr><td><a id="l823"></a><a href="#l823">823</a><td> * Check the directionality of a piece of text, return true if the piece of<tr><td><a id="l824"></a><a href="#l824">824</a><td> * text should be laid out in RTL direction.<tr><td><a id="l825"></a><a href="#l825">825</a><td> * @param {string} str The piece of text that need to be detected.<tr><td><a id="l826"></a><a href="#l826">826</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l827"></a><a href="#l827">827</a><td> * Default: false.<tr><td><a id="l828"></a><a href="#l828">828</a><td> * @return {boolean} Whether this piece of text should be laid out in RTL.<tr><td><a id="l829"></a><a href="#l829">829</a><td> */<tr><td><a id="l830"></a><a href="#l830">830</a><td>goog.i18n.bidi.detectRtlDirectionality = function(str, opt_isHtml) {<tr><td><a id="l831"></a><a href="#l831">831</a><td> return goog.i18n.bidi.estimateDirection(str, opt_isHtml) ==<tr><td><a id="l832"></a><a href="#l832">832</a><td> goog.i18n.bidi.Dir.RTL;<tr><td><a id="l833"></a><a href="#l833">833</a><td>};<tr><td><a id="l834"></a><a href="#l834">834</a><td><tr><td><a id="l835"></a><a href="#l835">835</a><td><tr><td><a id="l836"></a><a href="#l836">836</a><td>/**<tr><td><a id="l837"></a><a href="#l837">837</a><td> * Sets text input element&#39;s directionality and text alignment based on a<tr><td><a id="l838"></a><a href="#l838">838</a><td> * given directionality. Does nothing if the given directionality is unknown or<tr><td><a id="l839"></a><a href="#l839">839</a><td> * neutral.<tr><td><a id="l840"></a><a href="#l840">840</a><td> * @param {Element} element Input field element to set directionality to.<tr><td><a id="l841"></a><a href="#l841">841</a><td> * @param {goog.i18n.bidi.Dir|number|boolean|null} dir Desired directionality,<tr><td><a id="l842"></a><a href="#l842">842</a><td> * given in one of the following formats:<tr><td><a id="l843"></a><a href="#l843">843</a><td> * 1. A goog.i18n.bidi.Dir constant.<tr><td><a id="l844"></a><a href="#l844">844</a><td> * 2. A number (positive = LRT, negative = RTL, 0 = neutral).<tr><td><a id="l845"></a><a href="#l845">845</a><td> * 3. A boolean (true = RTL, false = LTR).<tr><td><a id="l846"></a><a href="#l846">846</a><td> * 4. A null for unknown directionality.<tr><td><a id="l847"></a><a href="#l847">847</a><td> */<tr><td><a id="l848"></a><a href="#l848">848</a><td>goog.i18n.bidi.setElementDirAndAlign = function(element, dir) {<tr><td><a id="l849"></a><a href="#l849">849</a><td> if (element) {<tr><td><a id="l850"></a><a href="#l850">850</a><td> dir = goog.i18n.bidi.toDir(dir);<tr><td><a id="l851"></a><a href="#l851">851</a><td> if (dir) {<tr><td><a id="l852"></a><a href="#l852">852</a><td> element.style.textAlign =<tr><td><a id="l853"></a><a href="#l853">853</a><td> dir == goog.i18n.bidi.Dir.RTL ?<tr><td><a id="l854"></a><a href="#l854">854</a><td> goog.i18n.bidi.RIGHT : goog.i18n.bidi.LEFT;<tr><td><a id="l855"></a><a href="#l855">855</a><td> element.dir = dir == goog.i18n.bidi.Dir.RTL ? &#39;rtl&#39; : &#39;ltr&#39;;<tr><td><a id="l856"></a><a href="#l856">856</a><td> }<tr><td><a id="l857"></a><a href="#l857">857</a><td> }<tr><td><a id="l858"></a><a href="#l858">858</a><td>};<tr><td><a id="l859"></a><a href="#l859">859</a><td><tr><td><a id="l860"></a><a href="#l860">860</a><td><tr><td><a id="l861"></a><a href="#l861">861</a><td>/**<tr><td><a id="l862"></a><a href="#l862">862</a><td> * Sets element dir based on estimated directionality of the given text.<tr><td><a id="l863"></a><a href="#l863">863</a><td> * @param {!Element} element<tr><td><a id="l864"></a><a href="#l864">864</a><td> * @param {string} text<tr><td><a id="l865"></a><a href="#l865">865</a><td> */<tr><td><a id="l866"></a><a href="#l866">866</a><td>goog.i18n.bidi.setElementDirByTextDirectionality = function(element, text) {<tr><td><a id="l867"></a><a href="#l867">867</a><td> switch (goog.i18n.bidi.estimateDirection(text)) {<tr><td><a id="l868"></a><a href="#l868">868</a><td> case (goog.i18n.bidi.Dir.LTR):<tr><td><a id="l869"></a><a href="#l869">869</a><td> element.dir = &#39;ltr&#39;;<tr><td><a id="l870"></a><a href="#l870">870</a><td> break;<tr><td><a id="l871"></a><a href="#l871">871</a><td> case (goog.i18n.bidi.Dir.RTL):<tr><td><a id="l872"></a><a href="#l872">872</a><td> element.dir = &#39;rtl&#39;;<tr><td><a id="l873"></a><a href="#l873">873</a><td> break;<tr><td><a id="l874"></a><a href="#l874">874</a><td> default:<tr><td><a id="l875"></a><a href="#l875">875</a><td> // Default for no direction, inherit from document.<tr><td><a id="l876"></a><a href="#l876">876</a><td> element.removeAttribute(&#39;dir&#39;);<tr><td><a id="l877"></a><a href="#l877">877</a><td> }<tr><td><a id="l878"></a><a href="#l878">878</a><td>};<tr><td><a id="l879"></a><a href="#l879">879</a><td><tr><td><a id="l880"></a><a href="#l880">880</a><td><tr><td><a id="l881"></a><a href="#l881">881</a><td><tr><td><a id="l882"></a><a href="#l882">882</a><td>/**<tr><td><a id="l883"></a><a href="#l883">883</a><td> * Strings that have an (optional) known direction.<tr><td><a id="l884"></a><a href="#l884">884</a><td> *<tr><td><a id="l885"></a><a href="#l885">885</a><td> * Implementations of this interface are string-like objects that carry an<tr><td><a id="l886"></a><a href="#l886">886</a><td> * attached direction, if known.<tr><td><a id="l887"></a><a href="#l887">887</a><td> * @interface<tr><td><a id="l888"></a><a href="#l888">888</a><td> */<tr><td><a id="l889"></a><a href="#l889">889</a><td>goog.i18n.bidi.DirectionalString = function() {};<tr><td><a id="l890"></a><a href="#l890">890</a><td><tr><td><a id="l891"></a><a href="#l891">891</a><td><tr><td><a id="l892"></a><a href="#l892">892</a><td>/**<tr><td><a id="l893"></a><a href="#l893">893</a><td> * Interface marker of the DirectionalString interface.<tr><td><a id="l894"></a><a href="#l894">894</a><td> *<tr><td><a id="l895"></a><a href="#l895">895</a><td> * This property can be used to determine at runtime whether or not an object<tr><td><a id="l896"></a><a href="#l896">896</a><td> * implements this interface. All implementations of this interface set this<tr><td><a id="l897"></a><a href="#l897">897</a><td> * property to {@code true}.<tr><td><a id="l898"></a><a href="#l898">898</a><td> * @type {boolean}<tr><td><a id="l899"></a><a href="#l899">899</a><td> */<tr><td><a id="l900"></a><a href="#l900">900</a><td>goog.i18n.bidi.DirectionalString.prototype.<tr><td><a id="l901"></a><a href="#l901">901</a><td> implementsGoogI18nBidiDirectionalString;<tr><td><a id="l902"></a><a href="#l902">902</a><td><tr><td><a id="l903"></a><a href="#l903">903</a><td><tr><td><a id="l904"></a><a href="#l904">904</a><td>/**<tr><td><a id="l905"></a><a href="#l905">905</a><td> * Retrieves this object&#39;s known direction (if any).<tr><td><a id="l906"></a><a href="#l906">906</a><td> * @return {?goog.i18n.bidi.Dir} The known direction. Null if unknown.<tr><td><a id="l907"></a><a href="#l907">907</a><td> */<tr><td><a id="l908"></a><a href="#l908">908</a><td>goog.i18n.bidi.DirectionalString.prototype.getDirection;</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>