This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

SecureField

用于密码输入的 SwiftUI SecureField 组件。

iOS
tvOS
Included in Expo Go
Recommended version:
~58.0.15

Expo UI SecureField 与官方 SwiftUI SecureField API 相匹配,并提供一个文本字段,用于掩盖用户输入的密码和其他敏感文本。

🌐 Expo UI SecureField matches the official SwiftUI SecureField API and provides a text field that masks user input for passwords and other sensitive text.

Three SecureField rows for changing a passwordThree SecureField rows for changing a password

安装

🌐 Installation

Terminal
- npx expo install @expo/ui
- yarn expo install @expo/ui
- pnpm expo install @expo/ui
- bun expo install @expo/ui

If you are installing this in an existing React Native app, make sure to install expo in your project.

用法

🌐 Usage

基本安全字段

🌐 Basic secure field

BasicSecureFieldExample.tsx
import { useState } from 'react'; import { Host, SecureField } from '@expo/ui/swift-ui'; export default function BasicSecureFieldExample() { const [password, setPassword] = useState(''); // A secure field stretches to the width it is given, so give the host a size. return ( <Host style={{ flex: 1 }}> <SecureField placeholder="Password" onTextChange={setPassword} /> </Host> ); }

提交处理

🌐 Submit handling

使用 submitLabel 和 onSubmit 修饰符来处理来自键盘的表单提交。

🌐 Use the submitLabel and onSubmit modifiers to handle form submission from the keyboard.

SecureFieldSubmitExample.tsx
import { useState } from 'react'; import { Host, SecureField } from '@expo/ui/swift-ui'; import { submitLabel, onSubmit } from '@expo/ui/swift-ui/modifiers'; export default function SecureFieldSubmitExample() { const [password, setPassword] = useState(''); return ( <Host style={{ flex: 1 }}> <SecureField placeholder="Password" onTextChange={setPassword} modifiers={[ submitLabel('done'), onSubmit(() => console.log('Login submitted')), ]} /> </Host> ); }

命令参考

🌐 Imperative ref

使用引用以命令式地设置文本、聚焦或失焦安全字段。

🌐 Use a ref to imperatively set text, focus, or blur the secure field.

ImperativeSecureFieldExample.tsx
import { useRef } from 'react'; import { Host, SecureField, SecureFieldRef, Button, HStack, VStack, } from '@expo/ui/swift-ui'; import { buttonStyle } from '@expo/ui/swift-ui/modifiers'; export default function ImperativeSecureFieldExample() { const ref = useRef<SecureFieldRef>(null); return ( <Host style={{ flex: 1 }}> <VStack> <SecureField ref={ref} placeholder="Password" /> <HStack spacing={12}> <Button modifiers={[buttonStyle('bordered')]} onPress={() => ref.current?.focus()} label="Focus" /> <Button modifiers={[buttonStyle('bordered')]} onPress={() => ref.current?.blur()} label="Blur" /> <Button modifiers={[buttonStyle('bordered')]} onPress={() => ref.current?.setText('secret123')} label="Set text" /> </HStack> </VStack> </Host> ); }

应用接口

🌐 API

import { SecureField } from '@expo/ui/swift-ui';

No API data file found, sorry!