TextObfuscationMode

Defines how the text will be obscured in secure text fields.

Text obscuring refers to replacing the original text content with a mask via various methods. It is most common in password fields.

Users are generally accustomed to different default experiences for secure text input on various platforms. On desktop, the convention is to keep the input entirely hidden. Conversely, mobile platforms typically offer a brief reveal of the last typed character. This reveal lasts for a short duration or until another character is entered, aiding users in tracking their input while maintaining privacy by not exposing too much information.

Summary

Public companion properties
TextObfuscationMode

All characters are hidden.
Cmn
TextObfuscationMode

Reveals the last typed character for a short amount of time.
Cmn
TextObfuscationMode

Gives the choice to the platform to hide or show characters.
Cmn
TextObfuscationMode

Do not obscure any content, making all the content visible.
Cmn

Public properties
Int
Cmn

Public companion properties

Hidden

Cmn
Added in 1.7.0
val Hidden: TextObfuscationMode

All characters are hidden.

RevealLastTyped

Cmn
Added in 1.7.0
val RevealLastTyped: TextObfuscationMode

Reveals the last typed character for a short amount of time.

Forces reveal behavior regardless of platform settings. For platform-dependent behavior, e.g. Androids "Show Passwords" setting, use System.

System

Cmn 
val System: TextObfuscationMode

Gives the choice to the platform to hide or show characters.

On most platforms, the behavior depends on that platform's conventions (typically defaulting to Hidden).

Android Specific: If the system setting is set to "Show" this setting mimics RevealLastTyped, otherwise it mimics Hidden. Additionally, there are differences, depending on the SDK version:

  • SDK 37 and later: Respects granular platform settings that can differentiate between touch input and physical keyboard input.

  • Below SDK 37: Respects the system-wide "Show passwords" toggle (Settings.System.TEXT_SHOW_PASSWORD) for all input types.

Visible

Cmn
Added in 1.7.0
val Visible: TextObfuscationMode

Do not obscure any content, making all the content visible.

It can be useful when you want to briefly reveal the content by toggling a reveal icon.

Public properties

value

Cmn
Added in 1.7.0
val value: Int