19.13.0 • Published 8 months ago

@commercetools-uikit/field-warnings v19.13.0

Weekly downloads
-
License
MIT
Repository
github
Last release
8 months ago

FieldWarnings

Description

The FieldWarnings component allows the user to display field warnings.

Installation

yarn add @commercetools-uikit/field-warnings
npm --save install @commercetools-uikit/field-warnings

Additionally install the peer dependencies (if not present)

yarn add react react-intl
npm --save install react react-intl

Usage

import FieldWarnings from '../src/field-warnings';

const Example = () => (
  // This example shows how to handle custom warnings on top of the
  // predefined warnings of FieldWarnings which this component and other
  // Field components use under the hood.
  <FieldWarnings
    warnings={{
      customWarning: true,
      defaultWarning: true,
    }}
    isVisible={true}
    renderWarning={(key) => {
      switch (key) {
        case 'customWarning':
          return 'The current password is weak, You may want to use a stronger password';
        default:
          // When null is returned then the default warning handling from
          // renderDefaultWarning will kick in for that warning.
          return null;
      }
    }}
    renderDefaultWarning={(key) => {
      switch (key) {
        case 'defaultWarning':
          return 'Always use a strong password';
        default:
          // When null is returned then the warning handling defined in
          // FieldWarning itself will kick in
          return null;
      }
    }}
  />
);

export default Example;

Properties

PropsTypeRequiredDefaultDescription
idstringID of the warning field.
warningsRecordList of warnings. Only entries with truthy values will count as active warnings.
isVisiblebooleantrue when the warning messages should be rendered. Usually you'd pass in a touched state of fields.
renderWarningFunctionSee signature.Function which gets called with each warning key (from the warnings prop) and may render a warning message or return null to hand the warning handling off to renderDefaultWarning.
renderDefaultWarningFunctionSee signature.Function which gets called with each warning key (from the warnings prop) for which renderWarning returned null. It may render a warning message or return null to hand the warning handling off to FieldWarnings built-in warning handling.

Signatures

Signature renderWarning

(key: string, warning?: boolean) => ReactNode;

Signature renderDefaultWarning

(key: string, warning?: boolean) => ReactNode;
19.13.0

9 months ago

19.12.1

9 months ago

19.12.0

10 months ago

19.11.0

10 months ago

19.4.0

1 year ago

19.8.0

11 months ago

19.10.0

11 months ago

19.7.0

12 months ago

19.6.0

1 year ago

19.5.0

1 year ago

19.9.0

11 months ago

19.3.1

1 year ago

19.3.0

1 year ago

19.2.0

1 year ago

19.1.0

1 year ago

19.0.0

1 year ago

18.5.0

1 year ago

18.4.0

1 year ago

18.3.0

1 year ago

18.2.0

1 year ago

18.1.0

1 year ago

18.0.0

1 year ago

17.1.0

1 year ago

17.0.1

1 year ago

17.0.0

1 year ago