如何设置Composable TextField实现键盘自动填充地址？

要让Compose输入文本框支持地址自动填充，需结合Compose的自动填充API与系统自动填充服务（你已开启）实现，以下是具体配置方案：

核心实现步骤 #

• 用AutofillNode定义输入框对应的地址自动填充类型（如街道、城市、邮编等）
• 通过Modifier.autofill()将输入框与自动填充节点绑定
• 匹配对应地址字段的AutofillType枚举值

完整代码示例 #

import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.ui.Modifier
import androidx.compose.ui.autofill.AutofillNode
import androidx.compose.ui.autofill.AutofillType
import androidx.compose.ui.autofill.autofill
import androidx.compose.ui.platform.LocalAutofill
import androidx.compose.ui.platform.LocalAutofillTree
import androidx.compose.ui.unit.dp

@Composable
fun AddressAutofillForm() {
    val streetState = remember { mutableStateOf("") }
    val cityState = remember { mutableStateOf("") }
    val postalCodeState = remember { mutableStateOf("") }

    val autofill = LocalAutofill.current
    val autofillTree = LocalAutofillTree.current

    // 定义各地址字段的自动填充节点
    val streetAutofillNode = AutofillNode(
        autofillTypes = listOf(AutofillType.AddressStreetAddress),
        onFill = { streetState.value = it }
    )
    val cityAutofillNode = AutofillNode(
        autofillTypes = listOf(AutofillType.AddressLocality),
        onFill = { cityState.value = it }
    )
    val postalCodeAutofillNode = AutofillNode(
        autofillTypes = listOf(AutofillType.AddressPostalCode),
        onFill = { postalCodeState.value = it }
    )

    // 将节点加入自动填充树，系统才能识别
    autofillTree += streetAutofillNode
    autofillTree += cityAutofillNode
    autofillTree += postalCodeAutofillNode

    Column(modifier = Modifier.padding(16.dp)) {
        OutlinedTextField(
            value = streetState.value,
            onValueChange = { streetState.value = it },
            label = { Text("街道地址") },
            modifier = Modifier
                .fillMaxWidth()
                .autofill(autofill, streetAutofillNode)
        )

        OutlinedTextField(
            value = cityState.value,
            onValueChange = { cityState.value = it },
            label = { Text("城市") },
            modifier = Modifier
                .fillMaxWidth()
                .padding(top = 8.dp)
                .autofill(autofill, cityAutofillNode)
        )

        OutlinedTextField(
            value = postalCodeState.value,
            onValueChange = { postalCodeState.value = it },
            label = { Text("邮政编码") },
            modifier = Modifier
                .fillMaxWidth()
                .padding(top = 8.dp)
                .autofill(autofill, postalCodeAutofillNode)
        )
    }
}

补充说明 #

• 可根据需求添加更多地址字段的自动填充类型，比如AddressCountryName（国家）、AddressRegion（省份）等
• 输入框获得焦点时，系统会根据绑定的AutofillType自动弹出对应的地址建议，逻辑与你提供的支付卡建议一致

内容的提问来源于stack exchange，提问作者gongie