Components
Statement of Truth
use: deployed WebExamples
Default
View va-statement-of-truth in Storybook
With Input Error
View va-statement-of-truth in Storybook
With Custom heading
View va-statement-of-truth in Storybook
With Prefilling
View va-statement-of-truth in Storybook
Usage
When to use Statement of Truth
- To collect a signature.: This component collects a digital signature from the user to certify their submission. This component is used in the Ask users for a signature pattern.
How this component works
The component works by asking the user to populate the text-input field with their name. That name must match the name entered earlier into the form on a previous step. If the name does not match, an error message is returned.
Behavior
- When using this pattern, do not add the privacy policy checkbox at the end of the form. The user does not need to check another checkbox for privacy policy.
Placement
- Place the component underneath the accordions on the review page. Do not hide this component inside an accordion.
Instances of this component in production
- Application for Family Caregiver Benefits (VA Form 10-10CG)
- Submit a lay or witness statement to support a VA claim - Lay/Witness Statement (VA Form 21-10210)
- Request personal records - Freedom of Information Act (FOIA) or Privacy Act (PA) Request (VA Form 20-10206)
Code usage
Content considerations
Error message templates
When a user doesn’t enter the name they entered previously in the form
Your signature must match your first and last name as previously entered.
When a user doesn’t check the checkbox for certification
Must certify by checking box
Component checklist
Web Platform
8 of 12 complete
Maturity
-
Guidance
-
Web
Examples, usage, code usage, content considerations, and accessibility considerations are all complete. -
Research
-
Web
VFS team conducted research on this component which is linked from this page. -
Stability
-
Web
Component has been in production for more than 3 months with no significant issues found. -
Adoption
-
Web
Multiple teams have adopted this component.
Accessibility
-
Accessibility testing -
This component has been tested using the VA Accessibility Test Library.
Code assets
-
Variations
-
Web
Storybook includes all variations (style, size, orientation, optional iconography, selection, error state, etc.) -
Responsive
-
Web
Component depicted in all responsive breakpoints. -
Interactive states
-
Web
Includes all interactive states that are applicable (hover, active, focus, keyboard focus, disabled). -
Tokens
-
N/A Web
All design attributes (color, typography, layout, etc.) are available as tokens. -
Internationalization
-
Web
Describes i18n attributes.
Visual assets
-
Variations
-
Web
Figma library includes all variations (style, size, orientation, optional iconography, selection, error state, etc.) -
Responsive
-
Web
Component designed to work in all responsive breakpoints. -
Interactive states
-
Web
Includes all interactive states that are applicable (hover, active, focus, keyboard focus, disabled). -
Tokens
-
N/A Web
All design attributes (color, typography, layout, etc.) are available as tokens.
Legend:
-
Complete -
Incomplete - N/A Not applicable
Provide feedback
Share your feedback, report issues, or suggest improvements for the Statement of Truth component. Your input helps us make the design system better for everyone.
- Get immediate support in #platform-design-system for technical or urgent issues.
- Explore all feedback channels for additional ways to share your input.