停用 SemanticsProperties.focusable 與 SemanticsConfiguration.isFocusable

SemanticsProperties.focusable 與 SemanticsConfiguration.isFocusable 參數已被棄用，建議改用 SemanticsProperties.focused 與 SemanticsConfiguration.isFocused 參數。

focused 參數現在可為 nullable。將其設為 true 或 false 時會自動將 isFocusable 設為 true，而設為 null 則會將 isFocusable 設為 false。

SemanticsConfiguration.isFocusable 屬性是一個布林值，用來表示 語意節點（semantics node）是否可以取得輸入焦點，

SemanticsConfiguration.isFocused 則是一個布林值，表示該 語意節點目前是否擁有輸入焦點。

此變更同樣適用於 SemanticsProperties.focusable 與 SemanticsProperties.focused。

我們棄用了 isFocusable，因為其功能已由 isFocused 所涵蓋。 isFocused 屬性現在在引擎中以三態旗標（tristate flag）儲存， 此變更讓 framework 與引擎行為保持一致。

SemanticsConfiguration.isFocusable 屬性已被棄用， 建議改用 SemanticsConfiguration.isFocused。此屬性為可為 null 的布林值； 設為 true 或 false 時會自動將 isFocusable 設為 true，設為 null 則會將 isFocusable 設為 false。

請將 SemanticsConfiguration.isFocusable 替換為 SemanticsConfiguration.isFocused。

遷移前的程式碼：

void describeSemanticsConfiguration(SemanticsConfiguration config) {
  config.isFocusable = true;
  config.isFocused = true;
}

遷移後的程式碼：

void describeSemanticsConfiguration(SemanticsConfiguration config) {
  config.isFocused = true;
}

遷移前的程式碼：

void describeSemanticsConfiguration(SemanticsConfiguration config) {
  config.isFocusable = false;
  config.isFocused = false;
}

遷移後的程式碼：

void describeSemanticsConfiguration(SemanticsConfiguration config) {
  config.isFocused = null;
}

納入版本：3.37.0-0.0.pre
穩定版釋出：3.38

API 文件：

• SemanticsConfiguration
• SemanticsProperties
• SemanticsNode

相關議題：

• Issue 166092

相關 PR：

• PR 170935