vgscollect/com.verygoodsecurity.vgscollect.widget.compose.state/VgsCardNumberTextFieldState

VgsCardNumberTextFieldState

class VgsCardNumberTextFieldState : BaseFieldState

Immutable state for a VGS card number field.

Obtain an instance with rememberVgsCardNumberTextFieldState inside a composable. The state is replaced (not mutated) on every keystroke; pass the latest instance to your VgsCardNumber…TextField and update it from the widget's onStateChange:

var state by rememberVgsCardNumberTextFieldState(
    collect = vgsCollect,
    fieldName = "data.card_number",
)
VgsCardNumberOutlinedTextField(
    state = state,
    onStateChange = { state = it },
)

Useful properties:

cardBrand — detected brand for the current input.
bin / last4 — non-sensitive metadata, populated only when isValid.
isValid / validationResult — current validation outcome.
fieldName — JSON key used in the submit payload.

Properties

val bin: String?

val cardBrand: VgsCardBrand

val contentLength: Int

current length of the entered value.

val fieldName: String

JSON key the value is sent under in the submit payload.

isCardBrandValidationEnabled

val isCardBrandValidationEnabled: Boolean

val isEmpty: Boolean

true when the field has no input.

val isValid: Boolean

true when every validator reports a valid result.

val last4: String?

supportedCardBrands

val supportedCardBrands: List<VgsCardBrand>

tokenizationConfig

open override val tokenizationConfig: VgsCardNumberTokenizationConfig?

optional tokenization settings; when present, the value is tokenized on submit and the token is sent in its place.

validationResult

val validationResult: List<VgsTextFieldValidationResult>

per-validator outcomes for the current value.

val validators: List<VgsTextFieldValidator>?

custom validators applied to the value, or null to use the field's default validators.

Functions

open override fun toString(): String