用Eclipse開發iPhone Web 應用程序
加入技術交流群
iDoc UI
本文引用地址：http://cqxgywz.com/article/87266.htm針對 iPhone 進行開發時，必須只關注 iPhone。應用程序應當快速地完成特定任務，不應該嘗試包括所有可能的功能。使用 iDoc，用戶必須找到關于 Java 類的基本文檔，例如類名、方法名、方法簽名和注釋。通過指向目標詳細信息頁面的三個導航級別顯示這些信息。
包導航
頂層包
類導航
包內的類、接口、異常和錯誤
類中的描述、字段、構造函數和方法
注釋、簽名和參數
為了使 iDoc 保持整齊并且以任務為目的，需要省略一些傳統 Javadoc 功能。例如，不顯示包描述注釋。由于這些功能通常不包含有用信息（例如，acme.client 包含客戶機代碼），并且有時被同時省略，因此把它們從 iDoc 中移除并簡化接口就顯得十分有意義。
要獲得三個導航級別，請使用邊對邊 (edge-to-edge) 列表。這是在本機 iPhone 應用程序中常用的構造，用于瀏覽聯系人、電子郵件和音樂。邊對邊列表將在 44 像素的等高行中顯示項，并且有助于在大量信息中滾動查找。Apple 的 iPhone 人機接口指南 提供了構造邊對邊列表的規格，包括字體、字體大小和邊框間距。iUi 框架用 CSS 和 JavaScript 語言實現這些規格，允許您創建像本機 iPhone 組件那樣顯示的簡單 HTML 列表。
清單 1 顯示了頁眉，以及 java.applet 和 java.rmi 包的前兩個導航級別。
清單 1. 帶有頁眉和前兩個導航級別的 HTML 文檔
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>iDoc</title>
<meta name="viewport" content="width=320; initial-scale=1.0;
maximum-scale=1.0;
user-scalable=0;"/>
<style type="text/css" media="screen">@import
"iui/iui.css";</style>
<style type="text/css" media="screen">@import
"iDoc.css";</style>
<script type="application/x-javascript"
src="iui/iui.js"></script>
</head>
<body onclick="console.log('Hello', event.target);">
<div class="toolbar">
<h1 id="pageTitle"></h1>
<a id="backButton" class="button"
href="#"></a>
<ul id="home" title="Packages" selected="true">
<li><a href="#java.applet">java.applet</a></li>
<!-- more packages...-->
<li><a href="#java.rmi">java.rmi</a></li>
</ul>
<ul id="java.applet" title="java.applet">
<li class="group">Interfaces</li>
<li><a href="java.applet.AppletContext.html">
AppletContext</a></li>
AppletStub</a></li>
AudioClip</a></li>
<li class="group">Classes</li>
<li><a href="java.applet.Applet.html">Applet
</a></li>
<li><a href="java.applet.Applet.AccessibleApplet.html">
AccessibleApplet</a></li>
</ul>
<ul id="java.rmi" title="java.rmi">
<li class="group">Interfaces</li>
<li><a href="java.rmi.Remote.html">
Remote</a></li>
<li class="group">Classes</li>
<li><a href="java.rmi.MarshalledObject.html">
MarshalledObject</a></li>
<li><a href="java.rmi.Naming.html">
Naming</a></li>
<li><a href="java.rmi.RMISecurityManager.html">
RMISecurityManager</a></li>
<li class="group">Exceptions</li>
<li><a href="java.rmi.AccessException.html">
AccessException</a></li>
<li><a href="java.rmi.AlreadyBoundException.html">
AlreadyBoundException</a></li>
<li><a href="java.rmi.ConnectException.html">
ConnectException</a></li>
<li><a href="java.rmi.ConnectIOException.html">
ConnectIOException</a></li>
<li><a href="java.rmi.MarshalException.html">
MarshalException</a></li>
<li><a href="java.rmi.NoSuchObjectException.html">
NoSuchObjectException</a></li>
<li><a href="java.rmi.NotBoundException.html">
NotBoundException</a></li>
<li><a href="java.rmi.RemoteException.html">
RemoteException</a></li>
<li><a href="java.rmi.RMISecurityException.html">
RMISecurityException</a></li>
ServerError</a></li>
<li><a href="java.rmi.ServerException.html">
ServerException</a></li>
<li><a href="java.rmi.ServerRuntimeException.html">
ServerRuntimeException</a></li>
<li><a href="java.rmi.StubNotFoundException.html">
StubNotFoundException</a></li>
<li><a href="java.rmi.UnexpectedException.html">
UnexpectedException</a></li>
<li><a href="java.rmi.UnknownHostException.html">
UnknownHostException</a></li>
<li><a href="java.rmi.UnmarshalException.html">
UnmarshalException</a></li>
</ul>
圖 8 顯示了使用邊對邊列表生成的頂層選擇包導航級別。
圖 8. 像導航本機 iPhone 應用程序一樣導航 Javadoc 包
圖 9 顯示了在 iPhone Preview 模式下顯示的最終的 java.rmi 包。
圖 9. 在 java.rmi 包中導航接口、類和異常
對于 iDoc 的目標詳細信息頁面，使用另一種 iPhone 構造：圓角矩形列表。這些列表對于分組信息十分有用，并且 iPhone 中的設置面板都使用這種列表。使用圓角矩形列表可以分隔方法簽名與參數及異常清單。在 V0.13 中，iUi 只支持將圓角矩形列表用于表單輸入；將其元素用于靜態文本將生成格式錯誤的塊。 使用定制的 iDoc.css 文件擴展這些 CSS（如清單 2 所示），以添加用于顯示帶有靜態文本的圓角矩形列表的 textRow 元素。
評論