lion/docs/components/input-iban/use-cases.md
2024-08-08 14:17:37 +02:00

102 lines
2.9 KiB
Markdown

# Input Iban >> Use Cases ||20
```js script
import { html } from '@mdjs/mdjs-preview';
import { loadDefaultFeedbackMessages } from '@lion/ui/validate-messages.js';
import { IsCountryIBAN, IsNotCountryIBAN } from '@lion/ui/input-iban.js';
import '@lion/ui/define/lion-input-iban.js';
```
## Prefilled
```js preview-story
export const prefilled = () => html`
<lion-input-iban .modelValue="${'NL20INGB0001234567'}" name="iban" label="IBAN"></lion-input-iban>
`;
```
## Faulty Prefilled
```js preview-story
export const faultyPrefilled = () => html`
<lion-input-iban
.modelValue="${'NL20INGB0001234567XXXX'}"
name="iban"
label="IBAN"
></lion-input-iban>
`;
```
## Country Restrictions
By default, we validate the input to ensure the IBAN is valid.
To get the default feedback message for this default validator, use `loadDefaultFeedbackMessages` from `@lion/form-core`.
In the example below, we show how to use an additional validator that restricts the `input-iban` to IBANs from only certain countries.
```js preview-story
export const countryRestrictions = () => {
loadDefaultFeedbackMessages();
return html`
<lion-input-iban
.modelValue="${'DE89370400440532013000'}"
.validators="${[new IsCountryIBAN('NL')]}"
name="iban"
label="IBAN"
></lion-input-iban>
<br />
<small>Demo instructions: you can use NL20 INGB 0001 2345 67</small>
`;
};
```
You can pass a single string value, or an array of strings.
The latter may be useful, for example if you only want to allow BeNeLux IBANs.
```js preview-story
export const countryRestrictionsMultiple = () => {
loadDefaultFeedbackMessages();
return html`
<lion-input-iban
.modelValue="${'DE89370400440532013000'}"
.validators="${[new IsCountryIBAN(['BE', 'NL', 'LU'])]}"
name="iban"
label="IBAN"
></lion-input-iban>
<br />
<small>Demo instructions: you can use:</small>
<ul>
<li><small>BE68 5390 0754 7034</small></li>
<li><small>NL20 INGB 0001 2345 67</small></li>
<li><small>LU28 0019 4006 4475 0000</small></li>
</ul>
`;
};
```
## Blacklisted Country
By default, we validate the input to ensure the IBAN is valid.
To get the default feedback message for this default validator, use `loadDefaultFeedbackMessages` from `@lion/form-core`.
In the example below, we show how to use an additional validator that blocks IBANs from certain countries.
You can pass a single string value, or an array of strings.
```js preview-story
export const blacklistedCountry = () => {
loadDefaultFeedbackMessages();
return html`
<lion-input-iban
.modelValue="${'DE89370400440532013000'}"
.validators="${[new IsNotCountryIBAN(['RO', 'NL'])]}"
name="iban"
label="IBAN"
></lion-input-iban>
<br />
<small>
Demo instructions: Try <code>RO 89 RZBR 6997 3728 4864 5577</code> and watch it fail
</small>
`;
};
```