ngx-vest-forms 2.0.0 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -0
- package/fesm2022/ngx-vest-forms.mjs +2167 -1963
- package/fesm2022/ngx-vest-forms.mjs.map +1 -1
- package/package.json +1 -1
- package/types/ngx-vest-forms.d.ts +129 -61
package/README.md
CHANGED
|
@@ -172,6 +172,9 @@ For `ngModelGroup` containers, prefer using `<ngx-form-group-wrapper>` (group-sa
|
|
|
172
172
|
- [Accessibility Guide](./docs/ACCESSIBILITY.md)
|
|
173
173
|
- [`ControlWrapperComponent` docs](./projects/ngx-vest-forms/src/lib/components/control-wrapper/README.md)
|
|
174
174
|
|
|
175
|
+
> **Styling note**: `ngx-control-wrapper` uses Tailwind CSS utility classes for default styling.
|
|
176
|
+
> If your project doesn't use Tailwind, see the [component docs](./projects/ngx-vest-forms/src/lib/components/control-wrapper/README.md#styling-dependency-tailwind-css) for alternatives.
|
|
177
|
+
|
|
175
178
|
**Available modes:**
|
|
176
179
|
|
|
177
180
|
- **`on-blur-or-submit`** (default) — Show errors after field is touched OR form is submitted
|
|
@@ -211,6 +214,13 @@ Access complete form and field state through the `FormErrorDisplayDirective` or
|
|
|
211
214
|
- `errorMessages()` / `warningMessages()` — Current validation messages
|
|
212
215
|
- `shouldShowErrors()` — Computed based on display mode and state
|
|
213
216
|
|
|
217
|
+
**Warnings behavior:**
|
|
218
|
+
|
|
219
|
+
- Warnings are **non-blocking** and do not make a field invalid.
|
|
220
|
+
- Warnings are stored separately from `control.errors` and are cleared on `resetForm()`.
|
|
221
|
+
- Warnings may appear after `validationConfig` triggers validation, even if the field
|
|
222
|
+
- was not touched yet. Use `NGX_WARNING_DISPLAY_MODE_TOKEN` to require touch-only display.
|
|
223
|
+
|
|
214
224
|
**Tip**: For async validations, use `createDebouncedPendingState()` to prevent "Validating..." messages from flashing when validation completes quickly (< 200ms).
|
|
215
225
|
|
|
216
226
|
📖 **[Complete Guide: Custom Control Wrappers](./docs/CUSTOM-CONTROL-WRAPPERS.md)**
|