延伸 ContextHub

當提供的ContextHub存放區和模組不符合您的解決方案需求時，請定義這些新型別。

建立自訂商店候選者

ContextHub存放區是從已登入的存放區候選專案建立的。 若要建立自訂商店，您必須建立並註冊商店候選商店。

包含建立及註冊候選商店之程式碼的javascript檔案必須包含在 使用者端資料庫資料夾. 資料夾的類別必須符合以下模式：

contexthub.store.[storeType]

此 storeType 類別的一部分為 storeType 用來登入存放區候選者。 (請參閱 註冊ContextHub存放區候選專案)。 例如，對於storeType contexthub.mystore，使用者端資源庫資料夾的類別必須是 contexthub.store.contexthub.mystore.

建立ContextHub存放區候選專案

若要建立候選商店，請使用 ContextHub.Utils.inheritance.inherit 函式以擴充其中一個基底存放區：

• 'ContextHub.Store.PersistedStore'
• 'ContextHub.Store.SessionStore'
• 'ContextHub.Store.JSONPStore'
• 'ContextHub.Store.PersistedJSONPStore'

每個基礎存放區會延伸 ContextHub.Store.Core 商店。

下列範例會建立 ContextHub.Store.PersistedStore 商店候選者：

myStoreCandidate = function(){};
ContextHub.Utils.inheritance.inherit(myStoreCandidate,ContextHub.Store.PersistedStore);

實際上，您的自訂商店候選者將定義其他功能或覆寫商店的初始設定。 數個 範例商店候選者 會安裝在底下的存放庫中 /libs/granite/contexthub/components/stores.

註冊ContextHub存放區候選專案

註冊存放區候選項，以將其與ContextHub架構整合，並啟用從中建立存放區的功能。 若要註冊候選商店，請使用 registerStoreCandidate 的功能 ContextHub.Utils.storeCandidates 類別。

註冊候選商店時，需提供該商店型別的名稱。 從候選者建立存放區時，您可以使用存放區型別來識別它所依據的候選者。

當您註冊候選商店時，請指出其優先順序。 當使用與已登入的候選商店相同的候選商店型別登入候選商店時，會使用具有較高優先順序的候選商店。 因此，您可以使用新的實作來覆寫現有的商店候選者。

ContextHub.Utils.storeCandidates.registerStoreCandidate(myStoreCandidate,
                                'contexthub.mystorecandidate', 0);

在大多數情況下，只需要一個候選者，而且優先順序可以設定為 0，但如果您有興趣，可瞭解 更進階的註冊， 可讓您根據javascript條件(applies)和候選者優先順序。

建立ContextHub UI模組型別

建立自訂UI模組型別，如果 與ContextHub一起安裝 不符合您的需求。 若要建立UI模組型別，請擴充以建立UI模組轉譯器 ContextHub.UI.BaseModuleRenderer 類別，然後將其註冊到 ContextHub.UI.

若要建立UI模組轉譯器，請建立 Class 包含轉譯UI模組邏輯的物件。 您的類別至少必須執行下列動作：

• 擴充 ContextHub.UI.BaseModuleRenderer 類別。 此類別是所有UI模組轉譯器的基本實施。 此 Class 物件會定義名為的屬性 extend 用來將這個類別命名為要擴充的類別。
• 提供預設設定。 建立 defaultConfig 屬性。 此屬性是一個物件，其中包含為定義的屬性。 contexthub.base UI模組，以及您需要的任何其他屬性。

的來源 ContextHub.UI.BaseModuleRenderer 位於 /libs/granite/contexthub/code/ui/container/js/ContextHub.UI.BaseModuleRenderer.js. 若要註冊轉譯器，請使用 registerRenderer 方法 ContextHub.UI 類別。 您必須提供模組型別的名稱。 管理員根據此轉譯器建立UI模組時，會指定此名稱。

在自動執行的匿名函式中建立並註冊轉譯器類別。 以下範例是根據 contexthub.browserinfo UI模組。 此UI模組是 ContextHub.UI.BaseModuleRenderer 類別。

;(function() {

    var SurferinfoRenderer = new Class({
        extend: ContextHub.UI.BaseModuleRenderer,

        defaultConfig: {
            icon: 'coral-Icon--globe',
            title: 'Browser/OS Information',

            storeMapping: {
                surferinfo: 'surferinfo'
            },

            template:
                '<p>{{surferinfo.browser.family}} {{surferinfo.browser.version}}</p>' +
                '<p>{{surferinfo.os.name}} {{surferinfo.os.version}}</p>'
        }
    });

    ContextHub.UI.registerRenderer('contexthub.browserinfo', new SurferinfoRenderer());

}());

包含建立和註冊轉譯器之程式碼的javascript檔案必須包含在 使用者端資料庫資料夾. 資料夾的類別必須符合以下模式：

contexthub.module.[moduleType]

此 [moduleType] 類別的一部分為 moduleType 模組轉譯器註冊所在的區域。 例如，對於 moduleType 之 contexthub.browserinfo，使用者端資源庫資料夾的類別必須是 contexthub.module.contexthub.browserinfo.