支援HTML5表單的指令碼

HTML5表單中支援的JavaScript、FormCalc屬性和方法列於下列：

$event

屬性 說明
 例外
prevText 指定欄位變更前的內容，以回應使用者的動作。 此值可以召回，類似於還原功能。

無法用於下拉式清單和清單方塊。 PrevText 無法正確運作：

  • 在iPad的「數值」欄位中鍵入一些特殊字元鍵(例如$、()、&、@等)，以及
  • 對於「日期」欄位（通過日曆輸入日期時）。

不支援透過指令碼設定值。
target 指定事件在其上執行的對象。 不支援通過指令碼設定值。
newtext 指定欄位在變更後，因應使用者動作的內容。

newText屬性在下列情況下無法正常運作：

  • 論文本的選取與替換
  • 在刪除、複製和貼上文字時。
  • 在「數值」欄位中鍵入一些特殊字元鍵(例如$、(、)、&、@等)時，
  • 使用shift+字母數字組合。
  • 使用日期／時間欄位時。
不支援透過指令碼設定值。
變更 指定用戶在執行操作後立即鍵入或貼上到欄位中的值。

變更屬性在下列情況下無法正常運作：

  • 論文本的選取與替換
  • 在刪除、複製和貼上文字時。
  • 在「數值」欄位中鍵入一些特殊字元鍵(例如$、(、)、&、@等)時，
  • 使用shift+字母數字組合。
  • 使用日期／時間欄位時。

不支援透過指令碼設定值。
keydown 確定用戶是否按箭頭鍵進行選擇。 此屬性僅適用於清單框和下拉清單。 無
修飾詞 確定在特定事件執行時是否按住修飾鍵鍵（例如Microsoft® Windows®上的Ctrl）。 無

$host

屬性 說明 例外
apptype 返回主機的應用程式類型。 僅適用於客戶端應用程式。 傳回HTML 5。
name 傳回目前應用程式的名稱。 傳回瀏覽器名稱及其版本。 例如，在Chrome瀏覽器中，傳回的值是 Chrome <version>.
numPages 返回文檔中的頁數。 HTML5表格的分頁原則與PDF表格分頁原則不相同。 因此，numPages API可在這兩種情況下傳回不同的值。
platform 傳回代表執行指令碼之電腦平台的字串。 無
title 指定文檔的標題。 它僅適用於客戶端應用程式。 它會傳回HTML檔案的表單標題，而非PDF表單的表單中繼資料標題。
version 傳回代表目前應用程式版本號碼的字串。 它會傳回表單版本。
calculationsEnabled 指定計算指令碼是否將執行。
 無
validationsEnabled 指定驗證指令碼是否將執行。
 無
pageUp 移至上一頁。 HTML5表格不遵循與PDF表格相同的分頁原則，因此HTML5表格的上一頁與PDF表格的上一頁不同。
pageDown 移至表單的下一頁。 在執行時期使用pageDown方法。
setFocus 將鍵盤焦點設定為指定的欄位。 欄位被指定為對象，或由欄位的SOM表達式指定。 它僅適用於客戶端應用程式。
resetdata 將檔案中的欄位重設為預設值。 清除具有合併資料的表單中的所有資料，而非將其還原為預設值。
messageBox 在螢幕上顯示一個對話框。 它僅適用於客戶端應用程式 「是／否」類型的消息框將轉換為「確定／取消」。 不支援含有三個按鈕的訊息方塊。
currentPage

在運行時設定文檔的當前活動頁面。

頁面值是以0為基礎，因此檔案的第一頁會傳回0的值。

當layout:ready在用戶端上執行時，currentPage屬性即可使用。 但是，當layout:ready在伺服器上執行時，它不可用，因為只有在表單配置執行之前，屬性才會執行。

 無

欄位

屬性 說明
 例外
presence 控制關聯物件在不同處理階段的參與率。 如果物件是容器，容器的內容會繼承此控制項所套用的任何限制。 無
access 控制使用者對內容的存取。 不適用於排除群組。 此外，HTML5表格對非互動和受保護的物件也提供相同的處理方式。
name 用於在指令碼表達式中標識此元素的標識符。 HTML5表格不允許為物件設定name屬性。 它是HTML5表單的唯讀屬性。
value 包含單一資料內容的內容元素。 無
rawValue 指定此欄位的未格式化值。 無
formattedValue 指定此欄位的格式化值。 不支援透過指令碼設定formattedValue。
editValue 指定此欄位的編輯值。 不支援通過指令碼設定editValue 。
formatMessage 指定此欄位的格式驗證消息字串。 不支援通過指令碼設定formatMessage 。
fillcolor 指定此欄位的背景顏色值。 您需要將border.fill.presence屬性設為可個別顯示。 無法正確傳回欄位的預設顏色。
border 邊框物件描述物件周圍的邊框。
ui ui對象封裝了表單對象的用戶介面描述。
mandatory 指定欄位的nullTest值。
borderColor 指定此欄位的邊框顏色值。 您需要將border.edge.presence屬性設為可個別顯示。 無法正確傳回欄位的預設邊框顏色。
length 清單中的項目數。 無
addItem 新增項目至目前欄位。 無
clearItem 從欄位中移除所有項目。 無
boundItem 取得下拉式清單或清單方塊中特定顯示項目的系結值。 無
execCalculate 執行欄位的計算指令碼。 無
execValidate 執行欄位的驗證指令碼。 無
execEvent 執行對象的事件指令碼。 無
getItemState 傳回指定項目的選擇狀態 無
setItemState 設定指定項的選擇狀態。 無
getDisplayItem 檢索指定項目索引的項目顯示文本。 無
getSaveItem 檢索指定項索引的資料值。 無
deleteItem 刪除指定索引處的項目。 無
setItems 在當前欄位中設定指定的項。 它會取代預先存在的項目。 無
h 版面高度的測量。 無
寫 指定版面寬度的測量。 無
x 指定放置定位版面時，容器錨點相對於父容器左上角的x座標。 無
y 指定放置定位版面時，容器錨點相對於父容器左上角的y座標。 無
caption 標題對象描述了與表單設計對象關聯的描述性標籤。
 無
驗證 驗證對象控制表單上用戶提供資料的驗證。 在表單生命週期中，可多次激活驗證對象。 無
parentSubform 指定此欄位的父子表單（頁）。 一律傳回父子表單，而非傳回第一個非範圍劃分的父子表單。
selectedIndex 第一個選定項的索引。 無

表單

屬性 說明 例外
formNodes 返回綁定到指定資料對象的所有表單模型對象的清單。

InstanceManager

屬性 說明
name 用於在指令碼表達式中標識此元素的標識符。
occur 說明其封閉容器允許的例項數限制。
min 指定可實例化的最小實例數。
max 指定可實例化的實例數上限。
count 指定實例化的當前實例數。
setInstances 從此節點添加或刪除指定的子表單或子表單集。
addInstance 將子表單或子表單集的新實例添加到此節點。
removeInstance 從此節點中刪除子表單或子表單集。
moveInstance 將表單模型對象的子對象移動到表單模型中的另一個指定位置。 該對象的相應資料模型資訊也被重新定位在資料模型內。
insertInstance 將子表單或子表單集的新實例插入到此節點。

清單

屬性 說明
length 清單中的元素數。
item 系列中的零基索引。
append 在節點清單的末尾附加一個節點。
remove 從節點清單中刪除節點。
insert 在節點清單中的特定節點之前插入節點。

節點

屬性 說明 例外
createNode 根據有效的類名建立新節點。 無
isContainer 指定此物件是否為容器物件。 無
isNull 指示當前資料值是否為空值。 無
resolveNode 從當前XML表單對象模型對象開始計算指定的SOM表達式，並返回在SOM表達式中指定的對象值。 無
resolveNodes 從當前XML表單對象模型對象開始計算指定的SOM表達式，並返回在SOM表達式中指定的對象值。 無
oneOfChild 根據有效的類名建立新節點。 無
getElement 返回指定的子對象。 無
getAttribute 獲取指定的屬性值。 無
setAttribute 設定指定屬性的值。 無

型號

屬性 說明 例外
不適用 不適用 不適用

子表單

屬性 說明 例外
instanceIndex 指定對象的索引，相對於其他實例化實例。 無
execEvent 執行對象的事件指令碼。 無
getInvalidObjects 傳回子表單（含）中包含的未通過驗證測試的節點清單。 無
邊界 邊框物件描述物件周圍的邊框。 無
borderColor 指定此欄位的邊框顏色值。 您需要將border.edge.presence屬性設為可個別顯示。 無
h 版面高度的測量。 無
寫 指定版面寬度的測量。 無
x 指定放置定位版面時，容器錨點相對於父容器左上角的x座標。 無
y 指定放置定位版面時，容器錨點相對於父容器左上角的y座標。 無
驗證 驗證對象控制表單上用戶提供資料的驗證。 在表單生命週期中，可多次激活驗證對象。 無
名稱 用於在指令碼表達式中標識此元素的標識符。 無
存在 指定物件的可見性。 無
存取 控制用戶對容器對象（如子表單）內容的訪問。 無
execValidate 根據子表單或子表單集相對於相同表單對象的其他實例的位置計算其索引。 無
instanceManager instanceManager對象管理表單模型對象的實例建立、刪除和移動。
 無

提交

屬性 說明
目標 提交資料的URL。 遺漏此屬性意味著XFA處理應用程式使用產品特定技術（如訪問配置對象中的產品特定資訊）來獲取URI。

樹

屬性 說明 例外
節點 返回當前對象的所有子對象的清單。
  • xfa.nodes不支援， desc
  • PDF和HTML的報告節點數不同。
名稱 指定此節點的名稱。 HTML中不允許使用指令碼設定名稱。
parent 獲取此節點的父節點。 無
索引 傳回此節點在其類似命名、範圍內、類似子代關係節點集合中的位置。 無
somExpression 獲取此節點的SOM表達式。 無
resolveNode 從當前XML表單對象模型對象開始計算指定的SOM表達式，並返回在SOM表達式中指定的對象值。 無
resolveNodes 從當前XML表單對象模型對象開始計算指定的SOM表達式，並返回在SOM表達式中指定的對象值。 無

subformset

屬性 說明 例外
instanceManager instanceManager對象管理表單模型對象的實例建立、刪除和移動。 無

content

屬性 說明 例外
isNull 指示當前資料值是否為空值。

dataValue

屬性 說明 例外
isNull 指示當前資料值是否為空值。

edge

屬性 說明 例外
色彩 color屬性說明圖樣物件的唯一顏色。
  • 無法檢索預設值。
  • 這些變更會反映在模型中，可用於編寫指令碼，但不會同步到HTML元素。 因此，變更不會反映在UI中。

fill

屬性 說明 例外
色彩 顏色屬性定義填充的唯一顏色。
  • 無法檢索預設值。
  • 這些變更會反映在模型中，可用於編寫指令碼，但不會同步到HTML元素。 因此，變更不會反映在UI中。

線性

屬性 說明 例外
色彩 color屬性說明表格上線性漸層填色的唯一顏色。
  • 無法檢索預設值。
  • 這些變更會反映在模型中，可用於編寫指令碼，但不會同步到HTML元素。 因此，變更不會反映在UI中。

折線圖

屬性 說明 例外
邊緣 邊對象描述圓弧、直線或邊框或矩形的一側。
 不支援顏色、頂蓋等屬性。

模式

屬性 說明 例外
色彩 color屬性說明圖樣物件的唯一顏色。
  • 無法檢索預設值。
  • 這些變更會反映在模型中，可用於編寫指令碼，但不會同步到HTML元素。 因此，變更不會反映在UI中。

徑向

屬性 說明 例外
色彩 color屬性描述徑向對象的唯一顏色
  • 無法檢索預設值。
  • 這些變更會反映在模型中，可用於編寫指令碼，但不會同步到HTML元素。 因此，變更不會反映在UI中。

stiple

屬性 說明 例外
色彩 color屬性說明筆觸物件的唯一顏色。
  • 無法檢索預設值。
  • 這些變更會反映在模型中，並可用於編寫指令碼，但不會同步到HTML元素。 因此，變更不會反映在UI中。

draw

屬性 說明 例外
ui ui對象包含表單對象的用戶介面說明。
標題 標題對象描述了與表單設計對象相關聯的描述性標籤。
存在 指定物件的可見性。
名稱 指定可用於在指令碼表達式中指定此對象或事件的標識符。 不支援在執行時期設定值
值 值對象包含單個資料內容單位。

拐角

屬性 說明 例外
色彩 color屬性描述拐角對象的唯一顏色。
  • 無法檢索預設值。
  • 這些變更會反映在模型中，並可用於編寫指令碼，但不會同步到HTML元素。 因此，變更不會反映在UI中。

checkButton

屬性 說明 例外
邊界 border對象描述了checkButton對象周圍的邊框。 這些變更會反映在模型中，並可用於編寫指令碼，但不會同步到HTML元素。 因此，變更不會反映在UI中。

choiceList

屬性
 說明 例外
邊界 邊框物件描述choiceList物件的邊框。

dateTimeEdit

屬性 說明 例外
邊界 邊框物件說明dateTimeEdit物件的邊框。

影像

屬性 說明 例外
contentType 指定引用文檔中的內容類型，以MIME類型表示。 無
名稱
 用於在指令碼表達式中標識此元素的標識符。 無

imageEdit

屬性 說明 例外
邊界 邊框物件描述imageEdit物件的邊框。

numericEdit

屬性 說明 例外
邊界 邊框物件描述物件周圍的邊框。 無

物件

屬性 說明 例外
className 確定此對象類的名稱。
 無

矩形

屬性 說明 例外
邊緣 邊對象描述圓弧、直線或邊框或矩形的一側。
 不支援顏色、頂蓋等屬性。

textEdit

屬性 說明 例外
邊界 邊框物件描述物件周圍的邊框。
 無

exclGroup

屬性 說明 例外
配置 指定此對象要使用的佈局策略。 無
邊界 指定此欄位周圍的邊框。 無
強制 指定欄位的nullTest值。 無
borderColor 指定此欄位的邊框顏色值。必須先定義邊框，然後才能通過指令碼更改顏色。 無
borderWidth 指定此欄位的邊框寬度。 無
h 版面高度的測量。 無
瞬態 指定處理應用程式是否必須將排除群組的值儲存為表單提交或儲存作業的一部分。 無
寫 指定版面寬度的測量。 無
x 指定放置定位版面時，容器錨點相對於父容器左上角的x座標。 無
y 指定放置定位版面時，容器錨點相對於父容器左上角的y座標。 無
標題 標題對象描述了與表單設計對象關聯的描述性標籤。
 無
驗證 驗證對象控制表單上用戶提供資料的驗證。 在表單生命週期中，可多次激活驗證對象。 無
dataNode 獲取合併後表單節點綁定到的資料節點。 無
存在 指定物件的可見性。
存取 控制用戶對容器對象（如子表單）內容的訪問。 對於exclgrp中的各個項目，它始終返回open。
名稱 指定可用於在指令碼表達式中指定此對象或事件的標識符。 無
成員 指定排除群組的成員。 無
selectedMember 傳回排除群組的選定成員。 無
execCalculate 對指定對象的計算事件和任何子對象執行任何指令碼。 無
計算 計算對象控制欄位值的計算。
 無

弧

屬性 說明 例外
邊緣 邊對象描述圓弧、直線或邊框或矩形的一側。
 不支援顏色、頂蓋等屬性。

邊框

屬性 說明 例外
邊緣 邊對象描述圓弧、直線或邊框或矩形的一側。
 不支援顏色、頂蓋等屬性。

$配置

屬性 說明 例外
h 確定給定表單設計對象的高度。
  • 頁面區域和內容區域不支援高度(h)屬性。
  • 不支援參數「與XFA-Form物件發生的第一個內容區域偏移」。
寫 確定給定表單設計對象的寬度。
  • 頁面區域和內容區域不支援Width(w)屬性。
  • 不支援參數「與XFA-Form物件發生的第一個內容區域偏移」。
x 確定給定表單設計對象相對於其父對象的x坐標。
  • 頁面區域和內容區域不支援x座標(x)屬性。
  • 不支援參數「與XFA-Form物件發生的第一個內容區域偏移」。
y 確定給定表單設計對象相對於其父對象的y坐標。
  • 頁面區域和內容區域不支援y座標(y)屬性。
  • 不支援參數「與XFA-Form物件發生的第一個內容區域偏移」。
pagecount 決定目前表單的頁數。
  • layout.pageCount()方法會傳回PDF和HTML表格的不同值。
  • 在透過隱藏物件來減少頁數時，abspagecount方法會傳回錯誤值。
pagecontent 從表單的指定頁面檢索表單設計對象的類型。 無
absPageCount 決定目前表單的頁數。
  • layout.pageCount()方法會傳回PDF和HTML表格的不同值。
  • 在透過隱藏物件來減少頁數時，abspagecount方法會傳回錯誤值。

項目

屬性 說明 例外
存在 指定物件的可見性。 無

FormCalc

FormCalc是XFA專用的語言，用於建立e-form中心邏輯和計算根。 FormCalculation提供一組功能強大的構建函式。

FormCalc支援的函式

FormCalc運算式支援

類別 說明 範例
簡單運算式 加、減、乘、除和括弧 (a+b)*3
變數宣告 定義變數 var a
var a=3
a=3
邏輯運算式
  • 邏輯（及／或）
  • 比較（大／小/等）
 A或1↑[a0/]1↑[2]↑[a1/]A NE B↑[a2/]A或1↑[a3/]1↑[2]↑[a4/]A NE B
If運算式
if(a>b), then 2 endif
while
while(ilt 5)do i = i + 1 endwhile
的
對於i = 100，從1
do s = s + i結束
每個
對於(1, 2, 3)
中的每個i, s = s + iendfor
函式聲明 在FormCalc中定義自定義函式 func foo(n)do var f = n個endfunc

Acrobat API支援

  1. 算術函式

    1. Abs()
    2. Avg()
    3. Ceil()
    4. 計數()
    5. Floor()
    6. 最大值()
    7. 最小值()
    8. Mod()
    9. Round()
    10. 總計()

  2. 科學功能

    1. Acos()
    2. Asin()
    3. Atan()
    4. Atan2()
    5. Cos()
    6. Sin()
    7. Tan()
    8. Exp()
    9. 記錄檔()
    10. Pow()
    11. Sqrt()
    12. Deg2Rad()
    13. Rad2Deg()
    14. Pi()

  3. 財務職能

    1. 4月()
    2. Cterm()
    3. Fv()
    4. Ipmt()
    5. Npv()
    6. Pmt()
    7. Ppmt()
    8. Pv()
    9. Rate()
    10. 詞彙()

  4. 邏輯函式

    1. 選擇()
    2. If()
    3. Oneof()
    4. Within()

  5. 字串函式

    1. 於()
    2. Concat()
    3. 左()
    4. Len()
    5. Lower()
    6. Ltrim()
    7. 取代()
    8. 右()
    9. Rtrim()
    10. 空間()
    11. Stuff()
    12. Substr()
    13. Upper()
    14. WordNum()

  6. 日期和時間

    1. 日期()
    2. num2date()
    3. DateFmt()
API 說明 像差
console.println() 此Acrobat API會將輸出轉儲至javascript主控台。
app.alert() 此Acrobat API會透過javascript快顯功能表傳送警報訊息。
app.beep() 使系統播放聲音。 不執行任何操作。
app.execDialog() 向用戶顯示模型對話框。 用戶必須先關閉「模式」對話框，才能直接再次使用主機應用程式。 不執行任何操作。
app.launchURL() 在瀏覽器視窗中啟動URL。
app.setInterval() 指定JavaScript指令碼和時段。 每次經過該時段時，就會執行該指令碼。 此方法的傳回值必須保存在JavaScript變數中。 否則，間隔對象將受到廢棄項目收集的約束，這將導致時鐘停止。 要終止週期性執行，請將返回的間隔對象傳遞給clearInterval。
app.setTimeOut() 指定JavaScript指令碼和時段。 該指令碼僅在經過時段後執行一次。此方法的返回值必須保存在JavaScript變數中。 否則，逾時物件會受到廢棄項目收集的約束，這會導致時鐘停止。 若要取消逾時事件，請將傳回的逾時物件傳遞至clearTimeOut。
app.clearInterval() 取消由setInterval方法最初設定的先前註冊的間隔。 在HTML5表格中，API無法正常運作。
app.clearTimeOut() 取消先前註冊的超時間隔。 這種間隔最初由setTimeOut設定。 在HTML5表單中，API無法正常運作。
app.eval() 執行指定的指令碼。
app.activeDocs 包含每個活動文檔的Doc對象的陣列。 如果沒有作用中的檔案，activeDocs將不會傳回任何內容；也就是說，它在核心JavaScript中的行為與d = new Array(0)相同。 傳回HTMl5表單的空白陣列。
app.calculate 如果為true（預設值），則可執行計算。 若為false，則不允許計算。 HTMl5 Forms一律為true。
app.constants 一種用於保持各種常數值的包裝器對象。 目前，此屬性返回具有單一屬性(align)的對象。 HTML5表格會傳回空對齊物件。
app.focusRect 開啟和關閉焦點矩形。 焦點矩形是按鈕、核取方塊、選項按鈕和簽名周圍的淡淡虛線，用以指出表單欄位具有鍵盤焦點。 值true會開啟焦點矩形。 HTML5表格一律為true。
app.formsVersion 檢視器表單軟體的版本號碼。 如果要在指令碼中保持向後相容性，請檢查此屬性以確定軟體較新版本中的對象、屬性或方法是否可用。 11.001永遠。
app.language 執行中Acrobat檢視器的語言。 對於HTMl5表單，一律為"ENU"。

支援的XFA事件

支援下列用戶端XFA事件：

  • 初始化
  • 驗證
  • 計算
  • 按一下
  • Enter
  • 結束
  • 變更
  • ValidationState
注意

HTML5表格會在用戶端（瀏覽器）上轉譯。 建議使用客戶端​validate​和​calculate​指令碼，而不是伺服器端指令碼。

本頁內容