內容參數

實作時,大多數元件的內容不會是靜態的,而是會根據提供給元件的資料而定。如要在設計中反映這種情況,您可以使用內容參數。藉助內容參數,您可以指定設計中的哪些部分包含資料,而不必對實際資料進行硬式編碼。

外掛程式中的標題參數

新增內容參數

  1. 在 Figma 檔案中,選取元件並開啟 Relay for Figma 外掛程式 (「Plugins」>「Relay for Figma」)。

    已選取 hello 資訊卡的 Figma 外掛程式
  2. 在主要 Figma 視窗中,選取「Title」圖層 (在 Mac 上使用 + 點選,或在 Windows 和 Linux 上使用 Ctrl + 點選」)。然後,在外掛程式中按一下「Parameters」旁邊的「+」,然後選取「text-content」來為圖層新增參數。

    Figma 外掛程式中的參數選取選單
  3. 如要變更標題文字參數的名稱,請在「Name」中輸入該名稱。在本教學課程中,請輸入「Title」

    Figma 外掛程式中的參數詳細資料

    除了編輯名稱之外,您也可以選取不同的屬性類型,或是新增說明,以在程式碼中產生註解。請與開發人員合作,找出最合適的命名配置。內容參數的名稱會轉譯為所產生可組合項中的參數名稱。

儲存已命名版本

現在,讓我們將這個版本標示為準備就緒,以便匯入程式碼中。

  1. 開啟 Figma Relay 外掛程式 (如果尚未開啟)。
  2. 按一下「與開發人員分享」
  3. 在「與開發人員共用」畫面上,輸入版本的名稱和說明。

    標題範例:Hello World Card V3

    範例說明:新增參數

在 Android Studio 中更新元件

更新 Android Studio 中的元件。

  1. 在 Android Studio 中,確認「Project」工具視窗位於「Android view」。接著,在 app/ui-packages/hello_card/ 上按一下滑鼠右鍵,然後按一下「Update UI Package」

    在內容選單中更新 UI 套件選項
  2. 按一下 「Make Project」按鈕 即可再次建構專案。

    工具列中的建構按鈕

    若開啟 app/java/com/example/hellofigma/hellocard/HelloCard.kt,您會發現已新增參數:title。參數名稱是我們在 Figma 中指定的內容參數名稱:

    Figma 和所產生程式碼中的標題參數
  3. 開啟 app/java/com/example/hellofigma/MainActivity.kt

  4. 變更 MainActivity 類別中的一行程式碼,為 title 參數新增值:

    class MainActivity : ComponentActivity() {
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContent {
                HelloFigmaTheme {
                    // A surface container using the 'background' color from the theme
                    Surface(color = MaterialTheme.colors.background) {
                        HelloCard(title="Balloon World!") // Change this line
                    }
                }
            }
        }
    }
    
  5. 在同一個檔案中,在組件的預覽畫面中變更一行程式碼:

    @Preview(showBackground = true)
    @Composable
    fun DefaultPreview() {
        HelloFigmaTheme {
            HelloCard(title="Balloon World!") // Change this line
        }
    }
    
  6. 再次建構專案,並在預覽中查看更新的元件!請注意,您現在可以看到新的參數值。

    以更新的文字樣式預覽 Hello 資訊卡
  7. 執行應用程式,即可查看模擬器中的相同更新。

    太棒了!您已瞭解 Relay 工作流程的基本概念。

下一步

基本教學課程到此結束。雖然您已瞭解 Relay 工作流程的許多功能,但還有一些其他功能可用。如果您有興趣瞭解如何使用互動處理常式等功能,以及使用包含多個 Figma 變化版本的元件,請接著前往進階教學課程