Mashup Builder > 函數 > 導覽
導覽
* 
此函數會取代「導覽」小器具。欲建立相同的功能，請將「按鈕」小器具的 Clicked 內容繫結至此函數。
導覽函數是一個非視覺小器具，可用於在應用程式內的混搭之間進行導覽。欲開啟指定的目標混搭，請將事件繫結至 Navigate 服務。您可以繫結其他函數中的事件，例如驗證器函數的 True 內容。這可讓您定義在混搭中控制導覽的 JavaScript 運算式。如果目標混搭包含可繫結參數，您也可以在混搭之間傳遞參數值。
在 ThingWorx 9.3 或更新版本中，可以使用函數在遠端伺服器中傳送及擷取資料。出於安全性方面的考慮，Web 瀏覽器通常會阻止連線至位於不同網域上的遠端伺服器。但是，當目標視窗類型設定為「快顯」或「強制回應快顯」時，仍然可以使用導覽函數在遠端伺服器中傳送及擷取請求。使用函數 Result 內容從伺服器中擷取資料，並將其繫結至混搭中的小器具、函數或資料服務。
函數選項
您可以在建立或修改導覽函數時配置下列選項。
選項
描述
「描述」
設定函數的描述。
「目標混搭」
指定要重新導向至的混搭名稱。
「目標視窗類型」
將目標視窗類型設定為下列其中一個選項：
• 「新增」- 在新視窗中。
• 「取代」- 在目前視窗中。
• 「快顯」- 在快顯視窗中。
• 「強制回應快顯」- 在僅能從快顯視窗內關閉的快顯視窗中。
• 「全螢幕」- 在全螢幕模式中。
「遺失混搭訊息」
指定當目標混搭不可用時顯示的訊息。
「快顯視窗標題」
指定快顯視窗的標題。
「快顯視窗寬度」
設定快顯視窗的寬度。
「快顯視窗高度」
設定快顯視窗的高度。
「包括舊有高度增加」
控制是否將快顯視窗的高度增加 21 個像素。此選項適用於在 ThingWorx 9.3.3 或較早版本中建立的功能。欲禁用高度增加，請將此內容設定為 false。當在 ThingWorx 9.3.4 或更新版本中建立新功能時，會使用實際值來設定快顯視窗高度。
「取代時重新載入」
當目前混搭由新混搭取代時，會重新載入瀏覽器視窗。
「關閉按鈕」
在快顯視窗中顯示關閉按鈕。
「按一下外部關閉」
當使用者按一下視窗外部的區域時，會關閉快顯視窗。
「快顯視窗捲軸」
將捲軸新增至快顯視窗。
「重新導向至」
設定要導覽至的目標類型。可以將目標設定為「混搭」或 URL。
URL
使用者將重新導向至的 URL。
URL 目標類型
用於指定目標 URL 的開啟方式。可以在新視窗、目前視窗、快顯視窗或強制回應快顯視窗中開啟 URL。欲傳送或擷取資料，您必須在快顯或強制回應快顯視窗中開啟目標 URL。
顯示快顯視窗封鎖訊息
瀏覽器封鎖快顯視窗時，系統會顯示一則警示訊息。
快顯視窗封鎖訊息
設定當快顯視窗遭到封鎖時顯示的訊息。
建立導覽函數
1. 在「函數」面板上，按一下 。「新建函數」對話方塊即會開啟。
2. 從下拉清單中選取「導覽」。
3. 輸入函數名稱，然後按一下「下一步」。
4. 在「目標混搭」下，輸入要導覽至的混搭。
5. 視需要修改這些選項。
6. 按一下「完成」。
導覽函數即會新增至「函數」面板。
目標混搭參數
導覽函數可讓您將目前混搭中的值傳遞至目標混搭中的參數。當您選取目標混搭時，其參數會顯示在導覽函數之選項對話方塊中的「混搭預設值」下。您可以為每個參數指定預設值：
混搭參數值
目標混搭的參數也會列在導覽函數下。當您將內容繫結至混搭參數時，預設值會被覆寫。
混搭參數
函數內容
內容
描述
基礎類型
預設值
可繫結? (Y/N)
可當地語系化? (Y/N)
Navigate
用於將使用者重新導向至指定混搭或 URL 的服務。
n/a
n/a
Y
N
MissingMashupMessage
設定當目的地混搭不可用時會顯示的訊息。
STRING
n/a
Y
Y
PopupBlockedMessage
設定當快顯視窗遭到封鎖時顯示的訊息。
STRING
n/a
Y
Y
PopupTitle
設定快顯視窗的標題。
STRING
n/a
Y
Y
PopupWidth
設定快顯視窗的固定寬度。
NUMBER
n/a
Y
N
PopupHeight
設定快顯視窗的固定高度。
NUMBER
n/a
Y
N
Result
從快顯視窗中傳回的資料。
STRING
n/a
Y
Y
URL
STRING
n/a
Y
N
URLTargetType
控制 URL 目標視窗的開啟方式。支援的值有「新建」、「取代」、「快顯」與「強制回應快顯」。
您必須開啟用來在快顯或強制回應快顯視窗中傳送及擷取資料的 URL。
STRING
n/a
Y
N
函數事件
內容
描述
基礎類型
預設值
可繫結? (Y/N)
可當地語系化? (Y/N)
WindowClosed
當快顯視窗關閉時會觸發的事件。
n/a
n/a
Y
N
PopupDone
當快顯視窗關閉並提交資料時觸發的事件。
n/a
n/a
Y
n/a
PopupCanceled
在提交資料之前關閉快顯視窗時觸發的事件。
n/a
n/a
Y
n/a
PopupBlocked
當瀏覽器封鎖快顯視窗時觸發的事件。
n/a
n/a
Y
n/a
這是否有幫助?