This version of the documentation is outdated! Click here for the latest released version.

iOS 配置

config.xml檔控制應用於每個應用程式和 CordovaWebView 實例的應用程式的基本設置。本節詳細說明僅適用于 iOS 版本的首選項。有關全域配置選項的資訊，請參閱 config.xml 檔。

EnableViewportScale(boolean 類型的值，預設值為 false ）：設置為 true ，以便視區元標記來禁用或限制的範圍的使用者比例，這預設啟用的。
```
<preference name="EnableViewportScale" value="true"/>
```
放置在 HTML 中禁用縮放和適合的視口，如下內容靈活地內呈現 web 視圖：
```
<meta name='viewport' content='width=device-width, initial-scale=1, user-scalable=no' />
```
MediaPlaybackAllowsAirPlay(預設為true的布林值): 設置為false ，以防止空氣發揮被使用在此視圖中。在預設 UIWebView 和 WKWebView 中可用。
```
<preference name="MediaPlaybackAllowsAirPlay" value="false"/>
```
MediaPlaybackRequiresUserAction(預設為false的布林值): 設置為true以防止自動播放自動播放屬性或通過 JavaScript HTML5 視頻或音訊。
```
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
```
AllowInlineMediaPlayback(預設為false的布林值): 設置為true ，允許 HTML5 媒體重播顯示內聯在螢幕佈局，使用瀏覽器提供的控制項，而不是本機控制項內。這項工作，將添加到任何< video >元素的webkit playsinline屬性。
```
<preference name="AllowInlineMediaPlayback" value="true"/>
```
BackupWebStorage(字串，要麼none，local，或預設雲): 設置為cloud以允許通過 iCloud 備份 web 存儲資料。設置為local以允許只有本地備份通過 iTunes 同步。設置為none防止 web 存儲備份。
```
<preference name="BackupWebStorage" value="local"/>
```
TopActivityIndicator(字串，預設為gray): 控制狀態列指示大量的處理器活動中旋轉的小圖示的外觀。有效值為whiteLarge、white和gray.
```
<preference name="TopActivityIndicator" value="white"/>
```
KeyboardDisplayRequiresUserAction(預設為true的布林值): 設置為false以允許鍵盤顯示表單輸入調用focus ()時。
```
<preference name="KeyboardDisplayRequiresUserAction" value="false"/>
```
SuppressesIncrementalRendering(預設為false的布林值): 設置為true ，等待，直到在呈現到螢幕之前已收到的所有內容。
```
<preference name="SuppressesIncrementalRendering" value="true"/>
```
GapBetweenPages(浮動，預設值為``): 的大小，以磅為單位，頁面之間的差距。
```
<preference name="GapBetweenPages" value="0"/>
```
PageLength(浮動，預設值為``): 每個頁面，在頁面流的方向點的大小。當 PaginationMode 是從右至左或從左至右，此屬性工作表示每個頁面的寬度。當 PaginationMode 是 topToBottom 或 bottomToTop 時，此屬性工作表示每個頁面的高度。預設值為 0，這意味著佈局使用視區的大小來確定頁面的大小。
```
<preference name="PageLength" value="0"/>
```
PaginationBreakingMode(字串，預設為頁面): 有效值為頁和列。在列或頁破發生的方式。此屬性確定是否某些 CSS 屬性關於列和頁破是榮幸還是忽略。當此屬性設置為列時，內容方面與到位的頁破斷列相關的 CSS 屬性。
```
<preference name="PaginationBreakingMode" value="page"/>
```
PaginationMode(字串，預設為unpaginated): 有效值為unpaginated， leftToRight、 topToBottom、 bottomToTop和rightToLeft。此屬性可確定是否在 web 視圖中的內容分解成頁面全屏顯示視圖一次，或一個長的滾動視圖所示。如果設置為分頁的表單，此屬性切換分頁的佈局的內容，其內容造成 web 視圖使用場地的 PageLength 和 GapBetweenPages 的值。
```
<preference name="PaginationMode" value="unpaginated"/>
```
UIWebViewDecelerationSpeed(字串，預設為normal): 有效的值都是normal，fast。此屬性控制減速的勢頭滾動。對於大多數本機應用程式的預設速度是normal和fast是移動 Safari 的預設值。
```
<preference name="UIWebViewDecelerationSpeed" value="fast" />
```
ErrorUrl(字串，預設情況下未設置): 如果設置，將顯示在應用程式中出現錯誤時所引用的本地網頁。
```
<preference name="ErrorUrl" value="myErrorPage.html"/>
```
OverrideUserAgent(字串，預設情況下未設置): 如果設置，值將替換舊使用者代理的 web 視圖。它有利於從應用程式或瀏覽器請求時請求遠端頁面，識別。使用持謹慎態度，這可能導致與 web 伺服器的 compitiable 問題。對於大多數情況下，改用 AppendUserAgent。
```
<preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" />
```
AppendUserAgent(字串，預設情況下未設置): 如果設置，值將附加到年底老使用者代理的 web 視圖。當使用 OverrideUserAgent，此值將被忽略。
```
<preference name="AppendUserAgent" value="My Browser" />
```