Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

(this page was created automatically. In case of formatting issues, please visit the official Wiki Page)

RFID Scanner

Link to Figma: https://www.figma.com/design/yck1tcUXgdQ5aYX6iUAwrO/GE---Astronaut-Design-System?node-id=15534-397394&t=ftfrOGkPzlG2GaTo-1

Overview

  • The Dynamic RFID Scanner Component enables scanning of RFID codes within applications.
  • It provides localized labels, messages, and dialog titles with full language support.
  • Users can scan RFID tags, enter codes manually, or use pre-populated default values.
  • The component supports role-based access, validation, and local storage persistence.
  • Events allow integration with flows, logging, and backend services during the scanning lifecycle.

...

  • authorizationDisable – Links the component's enabled state to a policy set. For example, setting to "scannerAccessPolicy" will only enable the scanner for users who meet the policy requirements, providing role-based access control.
  • Figma: https://www.figma.com/design/yck1tcUXgdQ5aYX6iUAwrO/GE---Astronaut-Design-System?node-id=15534-397394&t=ftfrOGkPzlG2GaTo-1
  • Live style guide: tba

Guidelines

Usage

  • Capture RFID values directly into a form field by binding the destination with dataField.
  • Offer a manual entry fallback using alternativeInputLabelTranslations.
  • Use readonly: true on review screens to prevent edits.
  • Prefill known identifiers with defaultValue when appropriate.

...

  • Stage-specific, localized text communicates status to assistive tech: labelTranslations, scanningMessageTranslations, postScanningMessageTranslations, dialogTitleTranslations, alternativeInputLabelTranslations, confirmButtonLabelTranslations.
    • Keep titles and labels concise to minimize truncation (dialogTitleTranslations, labelTranslations).
  • Participate in validation announcements using required.
  • Prevent non-functional interaction with readonly or enabled: false.
  • Reduce focus churn by auto-dismissing completed scans via closeDialogOnSuccess.
  • Convey permission limits with a perceivable disabled state via authorizationDisable.
  • Avoid color-only meaning; use clear status messages via scanningMessageTranslations and postScanningMessageTranslations.
  • Make the manual path discoverable with alternativeInputLabelTranslations.
  • Keep titles and labels concise to minimize truncation (dialogTitleTranslations, labelTranslations).
  • Use confirmButtonLabelTranslations to make the action purpose explicit.
  • Where repeat scans are typical, reduce repeated input effort with saveInLocalStorage.