@snack-uikit/fields 0.53.0 → 0.53.1-preview-210b4b95.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 CHANGED
@@ -559,380 +559,66 @@ FieldStepper в основном предназначен для работы с
559
559
  ### Props
560
560
  | name | type | default value | description |
561
561
  |------|------|---------------|-------------|
562
- | open | `boolean` | - | Открыт color-picker |
563
- | onOpenChange | `(value: boolean) => void` | - | Колбек открытия пикера |
564
- | showCopyButton | `boolean` | - | Отображение кнопки копирования |
565
- | onCopyButtonClick | `() => void` | - | Колбек клика по кнопке Копировать для поля |
566
- | showClearButton | `boolean` | true | Отображение кнопки Очистки поля |
567
- | value | `string` | - | Значение input |
568
- | onChange | `(value: string) => void` | - | |
569
- | withAlpha | `boolean` | - | Значение с альфаканалом |
570
- | autoApply | `boolean` | - | Применять изменения автоматически, если значение false - то изменения происходят по кнопке |
571
- | className | `string` | - | Класснейм |
572
- | colorMode | `{ hex?: boolean; rgb?: boolean; hsv?: boolean; }` | - | |
573
- | id | `string` | - | Значение html-атрибута id |
574
- | name | `string` | - | Значение html-атрибута name |
575
- | disabled | `boolean` | - | Является ли поле деактивированным |
576
- | readonly | `boolean` | - | Является ли поле доступным только для чтения |
577
- | onFocus | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки получения фокуса |
578
- | onBlur | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки потери фокуса |
579
- | placeholder | `string` | - | Значение плейсхолдера |
580
- | autoFocus | `boolean` | false | Включен ли авто-фокус для поля |
581
- | label | `string` | - | Лейбл |
582
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
583
- | required | `boolean` | - | Является ли поле обязательным |
584
- | caption | `string` | - | Подпись справа от лейбла |
585
- | hint | `string` | - | Подсказка внизу |
586
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
587
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
588
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | default | Состояние валидации |
589
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
590
- | error | `string` | - | |
591
562
  | ref | `LegacyRef<HTMLInputElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
592
563
  | key | `Key` | - | |
593
564
  ## FieldDate
594
565
  ### Props
595
566
  | name | type | default value | description |
596
567
  |------|------|---------------|-------------|
597
- | mode* | "date" \| "date-time" | - | |
598
- | open | `boolean` | - | Открыт date-picker |
599
- | onOpenChange | `(value: boolean) => void` | - | Колбек открытия пикера |
600
- | value | `Date` | - | Значение поля |
601
- | onChange | `(value: Date) => void` | - | Колбек смены значения |
602
- | showCopyButton | `boolean` | - | Отображение кнопки копирования |
603
- | onCopyButtonClick | `() => void` | - | Колбек клика по кнопке Копировать для поля |
604
- | showClearButton | `boolean` | true | Отображение кнопки Очистки поля |
605
- | buildCellProps | `(date: Date, viewMode: ViewMode) => { isDisabled?: boolean; isHoliday?: boolean } ;` | - | Колбек установки свойств ячеек календаря. Вызывается на построение каждой ячейки. Принимает два параметра: <br> `Date` - дата ячейки <br> `ViewMode`: <br> - `month` отображение месяца, каждая ячейка - 1 день <br> - `year` отображение года, каждая ячейка - 1 месяц <br> - `decade` отображение декады, каждая ячейка - 1 год <br><br> Колбек должен возвращать объект с полями, отвечающими за отключение и подкраску ячейки. |
606
- | id | `string` | - | Значение html-атрибута id |
607
- | name | `string` | - | Значение html-атрибута name |
608
- | disabled | `boolean` | - | Является ли поле деактивированным |
609
- | readonly | `boolean` | - | Является ли поле доступным только для чтения |
610
- | onFocus | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки получения фокуса |
611
- | onBlur | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки потери фокуса |
612
- | autoFocus | `boolean` | false | Включен ли авто-фокус для поля |
613
- | className | `string` | - | CSS-класс |
614
- | label | `string` | - | Лейбл |
615
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
616
- | required | `boolean` | - | Является ли поле обязательным |
617
- | caption | `string` | - | Подпись справа от лейбла |
618
- | hint | `string` | - | Подсказка внизу |
619
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
620
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
621
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | default | Состояние валидации |
622
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
623
- | error | `string` | - | |
624
568
  | ref | `LegacyRef<HTMLInputElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
625
569
  | key | `Key` | - | |
626
- | showSeconds | `boolean` | - | |
627
570
  ## FieldDecorator
628
571
  ### Props
629
572
  | name | type | default value | description |
630
573
  |------|------|---------------|-------------|
631
- | children* | `ReactNode` | - | Контент |
632
- | className | `string` | - | CSS-класс |
633
- | disabled | `boolean` | - | Деактивирован ли элемент Является ли поле деактивированным |
634
- | readonly | `boolean` | - | Является ли поле доступным только на чтение Доступно ли поле только на чтение |
635
- | error | `string` | - | |
636
- | label | `string` | - | Лейбл |
637
- | caption | `string` | - | Подпись справа от лейбла |
638
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
639
- | labelFor | `string` | - | Аттрибут for |
640
- | required | `boolean` | - | Является ли поле обязательным |
641
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
642
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
643
- | length | `{ current: number; max?: number; }` | - | Допустимая длинна текста |
644
- | hint | `string` | - | Подсказка внизу |
645
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | default | Состояние валидации |
646
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
647
574
  | ref | `LegacyRef<HTMLDivElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
648
575
  | key | `Key` | - | |
649
576
  ## FieldSecure
650
577
  ### Props
651
578
  | name | type | default value | description |
652
579
  |------|------|---------------|-------------|
653
- | hidden | `boolean` | - | Замаскированно ли значение поля |
654
- | onHiddenChange | `(value: boolean) => void` | - | Колбек смены маскирования |
655
- | showCopyButton | `boolean` | - | Отображение кнопки копирования |
656
- | onCopyButtonClick | `() => void` | - | Колбек клика по кнопке Копировать для поля |
657
- | allowMoreThanMaxLength | `boolean` | - | Можно ли вводить больше разрешённого кол-ва символов |
658
- | prefixIcon | `ReactElement<any, string \| JSXElementConstructor<any>>` | - | Иконка-префикс для поля |
659
- | asyncValueGetter | `() => Promise<string>` | - | Свойство позволяет грузить данные в поле по требованию |
660
- | onChange | `(value: string, e?: ChangeEvent<HTMLInputElement>) => void` | - | Колбек смены значения |
661
- | value | `string` | - | Значение input |
662
- | id | `string` | - | Значение html-атрибута id |
663
- | name | `string` | - | Значение html-атрибута name |
664
- | disabled | `boolean` | - | Является ли поле деактивированным |
665
- | readonly | `boolean` | - | Является ли поле доступным только для чтения |
666
- | onFocus | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки получения фокуса |
667
- | onBlur | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки потери фокуса |
668
- | placeholder | `string` | - | Значение плейсхолдера |
669
- | autoFocus | `boolean` | false | Включен ли авто-фокус для поля |
670
- | maxLength | `number` | - | Максимальная длина вводимого значения |
671
- | autoComplete | `string \| boolean` | false | Включен ли автокомплит для поля |
672
- | className | `string` | - | CSS-класс |
673
- | label | `string` | - | Лейбл |
674
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
675
- | required | `boolean` | - | Является ли поле обязательным |
676
- | caption | `string` | - | Подпись справа от лейбла |
677
- | hint | `string` | - | Подсказка внизу |
678
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
679
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
680
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | default | Состояние валидации |
681
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
682
- | error | `string` | - | |
683
580
  | ref | `LegacyRef<HTMLInputElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
684
581
  | key | `Key` | - | |
685
582
  ## FieldSelect
686
583
  ### Props
687
584
  | name | type | default value | description |
688
585
  |------|------|---------------|-------------|
689
- | options* | `OptionProps[]` | - | |
690
- | id | `string` | - | Значение html-атрибута id |
691
- | name | `string` | - | Значение html-атрибута name |
692
- | disabled | `boolean` | false | Является ли поле деактивированным |
693
- | readonly | `boolean` | false false | Является ли поле доступным только для чтения |
694
- | onFocus | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки получения фокуса |
695
- | onBlur | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки потери фокуса |
696
- | placeholder | `string` | - | Значение плейсхолдера |
697
- | autoFocus | `boolean` | false | Включен ли авто-фокус для поля |
698
- | onKeyDown | `KeyboardEventHandler<HTMLInputElement>` | - | Колбек обработки начала нажатия клавиши клавиатуры |
699
- | className | `string` | - | CSS-класс |
700
- | label | `string` | - | Лейбл |
701
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
702
- | required | `boolean` | - | Является ли поле обязательным |
703
- | caption | `string` | - | Подпись справа от лейбла |
704
- | hint | `string` | - | Подсказка внизу |
705
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
706
- | size | enum Size: `"s"`, `"m"`, `"l"` | - | Размер |
707
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | - | Состояние валидации |
708
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
709
- | error | `string` | - | |
710
- | loading | `boolean` | - | |
711
- | prefix | `ReactNode` | - | Произвольный префикс для поля |
712
- | postfix | `ReactNode` | - | Произвольный постфикс для поля |
713
- | onChange | `OnChangeHandler<any>` | - | Controlled обработчик измения состояния |
714
- | value | `ItemId \| ItemId[]` | - | Controlled состояние |
715
- | defaultValue | `ItemId \| ItemId[]` | - | Начальное состояние |
716
- | pinTop | `OptionProps[]` | - | |
717
- | pinBottom | `OptionProps[]` | - | |
718
- | searchable | `boolean` | - | |
719
- | showCopyButton | `boolean` | - | Отображение кнопки Копировать для поля (актуально только для `readonly = true`) |
720
- | onCopyButtonClick | `() => void` | - | Колбек клика по кнопке Копировать для поля |
721
- | showClearButton | `boolean` | true | Отображение кнопки очистки поля |
722
- | prefixIcon | `ReactElement<any, string \| JSXElementConstructor<any>>` | - | Иконка-префикс для поля |
723
- | footer | `ReactNode` | - | |
724
- | widthStrategy | enum PopoverWidthStrategy: `"auto"`, `"gte"`, `"eq"` | - | |
725
- | search | `SearchState` | - | |
726
- | autocomplete | `boolean` | - | |
727
- | addOptionByEnter | `boolean` | - | |
728
- | open | `boolean` | - | |
729
- | enableFuzzySearch | `boolean` | - | Включить нечеткий поиск |
730
- | resetSearchOnOptionSelection | `boolean` | true | Поведение строки поиска при выборе опции из списка, false необходимо при асинхронной подгрузке значений с бэка, в случае если надо поиск оставить как значение при отсутствии данных |
731
- | onOpenChange | `(open: boolean) => void` | - | |
732
- | selectedOptionFormatter | `SelectedOptionFormatter` | - | |
733
- | scrollToSelectedItem | `boolean` | - | Флаг, отвещающий за прокручивание до выбранного элемента |
734
- | virtualized | `boolean` | - | Включить виртуализацию на компоненты списка. Рекомендуется если у вас от 1к элементов списка |
735
- | untouchableScrollbars | `boolean` | - | Отключает возможность взаимодействовать со скролбарами мышью. |
736
- | dataFiltered | `boolean` | - | |
737
- | dataError | `boolean` | - | |
738
- | noDataState | `EmptyStateProps` | - | Экран при отстутствии данных |
739
- | noResultsState | `EmptyStateProps` | - | Экран при отстутствии результатов поиска или фильтров |
740
- | errorDataState | `EmptyStateProps` | - | Экран при ошибке запроса |
741
- | selection | "single" \| "multiple" | - | |
742
- | ref | `LegacyRef<HTMLInputElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
743
- | key | `Key` | - | |
744
- | removeByBackspace | `boolean` | - | |
745
586
  ## FieldSlider
746
587
  ### Props
747
588
  | name | type | default value | description |
748
589
  |------|------|---------------|-------------|
749
- | postfixIcon | `ReactElement<any, string \| JSXElementConstructor<any>>` | - | Иконка-постфикс для поля |
750
- | showScaleBar | `boolean` | true | Отображение линейки |
751
- | textInputFormatter | `TextInputFormatter` | - | Функция для форматирования значений в текстовом поле |
752
- | unbindInputFromMarks | `boolean` | - | Отвязать текстовое поле от значений на линейке |
753
- | prefix | `ReactNode` | - | Произвольный префикс для поля |
754
- | postfix | `ReactNode` | - | Произвольный постфикс для поля |
755
- | id | `string` | - | Значение html-атрибута id |
756
- | name | `string` | - | Значение html-атрибута name |
757
- | disabled | `boolean` | - | Является ли поле деактивированным |
758
- | readonly | `boolean` | - | Является ли поле доступным только для чтения |
759
- | onFocus | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки получения фокуса |
760
- | onBlur | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки потери фокуса |
761
- | autoFocus | `boolean` | false | Включен ли авто-фокус для поля |
762
- | onChange | `(value: number \| number[]) => void` | - | |
763
- | value | `number \| number[]` | - | |
764
- | range | `boolean` | - | |
765
- | tipFormatter | `(value: string \| number) => ReactNode` | - | |
766
- | step | `number` | - | |
767
- | min | `number` | - | |
768
- | max | `number` | - | |
769
- | marks | `Record<string \| number, ReactNode \| MarkObj>` | - | |
770
- | className | `string` | - | CSS-класс |
771
- | label | `string` | - | Лейбл |
772
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
773
- | required | `boolean` | - | Является ли поле обязательным |
774
- | caption | `string` | - | Подпись справа от лейбла |
775
- | hint | `string` | - | Подсказка внизу |
776
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
777
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
778
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
779
590
  | ref | `LegacyRef<HTMLInputElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
780
591
  | key | `Key` | - | |
781
592
  ## FieldStepper
782
593
  ### Props
783
594
  | name | type | default value | description |
784
595
  |------|------|---------------|-------------|
785
- | value | `number` | - | Значение поля |
786
- | onChange | `(value: number, e?: ChangeEvent<HTMLInputElement>) => void` | - | Колбек смены значения |
787
- | step | `number` | 1 | Шаг поля |
788
- | allowMoreThanLimits | `boolean` | true | Можно ли вводить c клавиатуры числа, выходящие за пределы min/max |
789
- | prefix | `ReactNode` | - | Произвольный префикс для поля |
790
- | postfix | `ReactNode` | - | Произвольный постфикс для поля |
791
- | plusButtonTooltip | `TooltipProps` | - | Тултип над кнопкой увеличения значения |
792
- | minusButtonTooltip | `TooltipProps` | - | Тултип над кнопкой уменьшения значения |
793
- | id | `string` | - | Значение html-атрибута id |
794
- | name | `string` | - | Значение html-атрибута name |
795
- | disabled | `boolean` | - | Является ли поле деактивированным |
796
- | readonly | `boolean` | - | Является ли поле доступным только для чтения |
797
- | onFocus | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки получения фокуса |
798
- | onBlur | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки потери фокуса |
799
- | autoFocus | `boolean` | false | Включен ли авто-фокус для поля |
800
- | min | `number` | Number.NEGATIVE_INFINITY | Минимальное значение поля |
801
- | max | `number` | Number.POSITIVE_INFINITY | Максимальное значение поля |
802
- | className | `string` | - | CSS-класс |
803
- | label | `string` | - | Лейбл |
804
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
805
- | required | `boolean` | - | Является ли поле обязательным |
806
- | caption | `string` | - | Подпись справа от лейбла |
807
- | hint | `string` | - | Подсказка внизу |
808
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
809
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
810
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | default | Состояние валидации |
811
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
812
- | error | `string` | - | |
813
596
  | ref | `LegacyRef<HTMLInputElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
814
597
  | key | `Key` | - | |
815
598
  ## FieldText
816
599
  ### Props
817
600
  | name | type | default value | description |
818
601
  |------|------|---------------|-------------|
819
- | showCopyButton | `boolean` | - | Отображение кнопки Копировать для поля (актуально только для `readonly = true`) |
820
- | onCopyButtonClick | `() => void` | - | Колбек клика по кнопке Копировать для поля |
821
- | showClearButton | `boolean` | true | Отображение кнопки очистки поля |
822
- | onClearButtonClick | `() => void` | - | Колбек клика по кнопке очистки поля |
823
- | allowMoreThanMaxLength | `boolean` | - | Можно ли вводить больше разрешённого кол-ва символов |
824
- | prefixIcon | `ReactElement<any, string \| JSXElementConstructor<any>>` | - | Иконка-префикс для поля |
825
- | prefix | `ReactNode` | - | Произвольный префикс для поля |
826
- | postfix | `ReactNode` | - | Произвольный постфикс для поля |
827
- | button | `Button` | - | Кнопка действия внутри поля |
828
- | type | "text" \| "tel" \| "email" | text | |
829
- | onChange | `(value: string, e?: ChangeEvent<HTMLInputElement>) => void` | - | Колбек смены значения |
830
- | value | `string` | - | Значение input |
831
- | inputMode | enum InputMode: `"none"`, `"text"`, `"search"`, `"tel"`, `"email"`, `"decimal"`, `"numeric"`, `"url"` | - | Режим работы экранной клавиатуры |
832
- | id | `string` | - | Значение html-атрибута id |
833
- | name | `string` | - | Значение html-атрибута name |
834
- | disabled | `boolean` | - | Является ли поле деактивированным |
835
- | readonly | `boolean` | - | Является ли поле доступным только для чтения |
836
- | onFocus | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки получения фокуса |
837
- | onBlur | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки потери фокуса |
838
- | placeholder | `string` | - | Значение плейсхолдера |
839
- | autoFocus | `boolean` | false | Включен ли авто-фокус для поля |
840
- | maxLength | `number` | - | Максимальная длина вводимого значения |
841
- | autoComplete | `string \| boolean` | false | Включен ли автокомплит для поля |
842
- | spellCheck | `boolean` | true | Значение атрибута spellcheck (проверка орфографии) |
843
- | pattern | `string` | - | Регулярное выражение валидного инпута |
844
- | onKeyDown | `KeyboardEventHandler<HTMLInputElement>` | - | Колбек обработки начала нажатия клавиши клавиатуры |
845
- | onPaste | `ClipboardEventHandler<HTMLInputElement>` | - | Колбек обработки вставки значения |
846
- | className | `string` | - | CSS-класс |
847
- | label | `string` | - | Лейбл |
848
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
849
- | required | `boolean` | - | Является ли поле обязательным |
850
- | caption | `string` | - | Подпись справа от лейбла |
851
- | hint | `string` | - | Подсказка внизу |
852
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
853
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
854
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | default | Состояние валидации |
855
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
856
- | error | `string` | - | |
857
602
  | ref | `LegacyRef<HTMLInputElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
858
603
  | key | `Key` | - | |
859
604
  ## FieldTextArea
860
605
  ### Props
861
606
  | name | type | default value | description |
862
607
  |------|------|---------------|-------------|
863
- | minRows | `number` | 3 | Минимальное кол-во строк, до которого размер поля может быть увеличен |
864
- | maxRows | `number` | 1000 | Максимальное кол-во строк, до которого размер поля может быть увеличен |
865
- | resizable | `boolean` | - | Может ли ли пользователь изменять размеры поля (если св-во не включено, поле автоматически меняет свой размер) |
866
- | onChange | `(value: string, e?: ChangeEvent<HTMLTextAreaElement>) => void` | - | Колбек смены значения |
867
- | showCopyButton | `boolean` | - | Отображение кнопки Копировать для поля (актуально только для `readonly = true`) |
868
- | onCopyButtonClick | `() => void` | - | Колбек клика по кнопке Копировать для поля |
869
- | showClearButton | `boolean` | true | Отображение кнопки очистки поля |
870
- | allowMoreThanMaxLength | `boolean` | true | Можно ли вводить больше разрешённого кол-ва символов |
871
- | footer | `ReactNode` | - | Нода под футер |
872
- | value | `string` | - | HTML-аттрибут value |
873
- | id | `string` | - | HTML-аттрибут id |
874
- | name | `string` | - | HTML-аттрибут name |
875
- | disabled | `boolean` | - | Является ли поле деактивированным |
876
- | readonly | `boolean` | - | Является ли поле доступным только на чтение |
877
- | onFocus | `FocusEventHandler<HTMLTextAreaElement>` | - | Колбек получения фокуса |
878
- | onBlur | `FocusEventHandler<HTMLTextAreaElement>` | - | Колбек потери фокуса |
879
- | placeholder | `string` | - | Плейсхолдер |
880
- | autoFocus | `boolean` | - | Включен ли авто-фокус |
881
- | maxLength | `number` | - | Максимальное кол-во символов |
882
- | inputMode | enum InputMode: `"none"`, `"text"`, `"search"`, `"tel"`, `"email"`, `"decimal"`, `"numeric"`, `"url"` | - | Режим работы экранной клавиатуры |
883
- | spellCheck | `boolean` | true | Включение проверки орфографии |
884
- | onKeyDown | `KeyboardEventHandler<HTMLTextAreaElement>` | - | Колбек нажатия клавиши клавиатуры |
885
- | className | `string` | - | CSS-класс |
886
- | label | `string` | - | Лейбл |
887
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
888
- | required | `boolean` | - | Является ли поле обязательным |
889
- | caption | `string` | - | Подпись справа от лейбла |
890
- | hint | `string` | - | Подсказка внизу |
891
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
892
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
893
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | default | Состояние валидации |
894
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
895
- | error | `string` | - | |
896
608
  | ref | `LegacyRef<HTMLTextAreaElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
897
609
  | key | `Key` | - | |
898
610
  ## FieldTime
899
611
  ### Props
900
612
  | name | type | default value | description |
901
613
  |------|------|---------------|-------------|
902
- | open | `boolean` | - | Открыт time-picker |
903
- | onOpenChange | `(value: boolean) => void` | - | Колбек открытия пикера |
904
- | value | `TimeValue` | - | Значение поля |
905
- | onChange | `(value?: TimeValue) => void` | - | Колбек смены значения |
906
- | showCopyButton | `boolean` | - | Отображение кнопки копирования |
907
- | onCopyButtonClick | `() => void` | - | Колбек клика по кнопке Копировать для поля |
908
- | showSeconds | `boolean` | true | Показывать ли секунды |
909
- | showClearButton | `boolean` | true | Отображение кнопки Очистки поля |
910
- | id | `string` | - | Значение html-атрибута id |
911
- | name | `string` | - | Значение html-атрибута name |
912
- | disabled | `boolean` | - | Является ли поле деактивированным |
913
- | readonly | `boolean` | - | Является ли поле доступным только для чтения |
914
- | onFocus | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки получения фокуса |
915
- | onBlur | `FocusEventHandler<HTMLInputElement>` | - | Колбек обработки потери фокуса |
916
- | autoFocus | `boolean` | false | Включен ли авто-фокус для поля |
917
- | className | `string` | - | CSS-класс |
918
- | label | `string` | - | Лейбл |
919
- | labelTooltip | `ReactNode` | - | Всплывающая подсказка лейбла |
920
- | required | `boolean` | - | Является ли поле обязательным |
921
- | caption | `string` | - | Подпись справа от лейбла |
922
- | hint | `string` | - | Подсказка внизу |
923
- | showHintIcon | `boolean` | - | Отображать иконку подсказки |
924
- | size | enum Size: `"s"`, `"m"`, `"l"` | SIZE.S | Размер |
925
- | validationState | enum ValidationState: `"error"`, `"default"`, `"warning"`, `"success"` | default | Состояние валидации |
926
- | labelTooltipPlacement | enum Placement: `"left"`, `"left-start"`, `"left-end"`, `"right"`, `"right-start"`, `"right-end"`, `"top"`, `"top-start"`, `"top-end"`, `"bottom"`, `"bottom-start"`, `"bottom-end"` | top | Расположение подсказки лейбла |
927
- | error | `string` | - | |
928
614
  | ref | `LegacyRef<HTMLInputElement>` | - | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
929
615
  | key | `Key` | - | |
930
616
  ## withCharacterCount
931
617
  ### Props
932
618
  | name | type | default value | description |
933
619
  |------|------|---------------|-------------|
934
- | __@metadata@6350* | `DecoratorMetadataObject` | - | |
935
- | __@hasInstance@6348* | `(value: any) => boolean` | - | Determines whether the given value inherits from this function if this function was used as a constructor function. A constructor function can control which objects are recognized as its instances by 'instanceof' by overriding this method. |
620
+ | __@metadata@800* | `DecoratorMetadataObject` | - | |
621
+ | __@hasInstance@798* | `(value: any) => boolean` | - | Determines whether the given value inherits from this function if this function was used as a constructor function. A constructor function can control which objects are recognized as its instances by 'instanceof' by overriding this method. |
936
622
  | name* | `string` | - | Returns the name of the function. Function names are read-only and can not be changed. |
937
623
  | caller* | `Function` | - | |
938
624
  | arguments* | `any` | - | |
@@ -28,4 +28,4 @@ export declare const FieldSelectMultiple: import("react").ForwardRefExoticCompon
28
28
  resetSearchOnOptionSelection?: boolean;
29
29
  onOpenChange?(open: boolean): void;
30
30
  selectedOptionFormatter?: SelectedOptionFormatter;
31
- } & Pick<import("@snack-uikit/list").DroplistProps, "untouchableScrollbars" | "dataError" | "dataFiltered" | "scrollToSelectedItem" | "virtualized" | "noDataState" | "noResultsState" | "errorDataState">, "showCopyButton" | "onCopyButtonClick"> & import("react").RefAttributes<HTMLInputElement>>;
31
+ } & Pick<import("@snack-uikit/list").DroplistProps, "onScroll" | "scrollRef" | "scrollContainerRef" | "untouchableScrollbars" | "dataError" | "dataFiltered" | "scrollToSelectedItem" | "virtualized" | "noDataState" | "noResultsState" | "errorDataState">, "showCopyButton" | "onCopyButtonClick"> & import("react").RefAttributes<HTMLInputElement>>;
@@ -26,4 +26,4 @@ export declare const FieldSelectSingle: import("react").ForwardRefExoticComponen
26
26
  resetSearchOnOptionSelection?: boolean;
27
27
  onOpenChange?(open: boolean): void;
28
28
  selectedOptionFormatter?: SelectedOptionFormatter;
29
- } & Pick<import("@snack-uikit/list").DroplistProps, "untouchableScrollbars" | "dataError" | "dataFiltered" | "scrollToSelectedItem" | "virtualized" | "noDataState" | "noResultsState" | "errorDataState"> & import("react").RefAttributes<HTMLInputElement>>;
29
+ } & Pick<import("@snack-uikit/list").DroplistProps, "onScroll" | "scrollRef" | "scrollContainerRef" | "untouchableScrollbars" | "dataError" | "dataFiltered" | "scrollToSelectedItem" | "virtualized" | "noDataState" | "noResultsState" | "errorDataState"> & import("react").RefAttributes<HTMLInputElement>>;
@@ -74,7 +74,7 @@ type FiledSelectCommonProps = WithSupportProps<{
74
74
  resetSearchOnOptionSelection?: boolean;
75
75
  onOpenChange?(open: boolean): void;
76
76
  selectedOptionFormatter?: SelectedOptionFormatter;
77
- }> & Pick<DroplistProps, 'dataError' | 'noDataState' | 'noResultsState' | 'errorDataState' | 'dataFiltered' | 'untouchableScrollbars' | 'scrollToSelectedItem' | 'virtualized'>;
77
+ }> & Pick<DroplistProps, 'dataError' | 'noDataState' | 'noResultsState' | 'errorDataState' | 'dataFiltered' | 'untouchableScrollbars' | 'scrollToSelectedItem' | 'virtualized' | 'scrollRef' | 'scrollContainerRef' | 'onScroll'>;
78
78
  export type FieldSelectSingleProps = FieldSelectPrivateProps & Omit<SelectionSingleState, 'mode'> & WrapperProps & FiledSelectCommonProps;
79
79
  export type FieldSelectMultipleProps = FieldSelectPrivateProps & {
80
80
  removeByBackspace?: boolean;
@@ -1,3 +1,3 @@
1
1
  import { DroplistProps } from '@snack-uikit/list';
2
2
  import { FieldSelectProps } from '../types';
3
- export declare function extractListProps({ dataError, noDataState, noResultsState, errorDataState, dataFiltered, loading, footer, widthStrategy, scrollToSelectedItem, virtualized, }: Partial<FieldSelectProps>): Partial<DroplistProps>;
3
+ export declare function extractListProps({ dataError, noDataState, noResultsState, errorDataState, dataFiltered, loading, footer, widthStrategy, scrollToSelectedItem, virtualized, scrollRef, scrollContainerRef, onScroll, }: Partial<FieldSelectProps>): Partial<DroplistProps>;
@@ -15,7 +15,10 @@ function extractListProps(_ref) {
15
15
  footer,
16
16
  widthStrategy,
17
17
  scrollToSelectedItem,
18
- virtualized
18
+ virtualized,
19
+ scrollRef,
20
+ scrollContainerRef,
21
+ onScroll
19
22
  } = _ref;
20
23
  return {
21
24
  dataError,
@@ -27,6 +30,9 @@ function extractListProps(_ref) {
27
30
  footer,
28
31
  widthStrategy,
29
32
  scrollToSelectedItem,
33
+ scrollRef,
34
+ scrollContainerRef,
35
+ onScroll,
30
36
  trigger: 'clickAndFocusVisible',
31
37
  placement: 'bottom',
32
38
  'data-test-id': 'field-select__list',
@@ -28,4 +28,4 @@ export declare const FieldSelectMultiple: import("react").ForwardRefExoticCompon
28
28
  resetSearchOnOptionSelection?: boolean;
29
29
  onOpenChange?(open: boolean): void;
30
30
  selectedOptionFormatter?: SelectedOptionFormatter;
31
- } & Pick<import("@snack-uikit/list").DroplistProps, "untouchableScrollbars" | "dataError" | "dataFiltered" | "scrollToSelectedItem" | "virtualized" | "noDataState" | "noResultsState" | "errorDataState">, "showCopyButton" | "onCopyButtonClick"> & import("react").RefAttributes<HTMLInputElement>>;
31
+ } & Pick<import("@snack-uikit/list").DroplistProps, "onScroll" | "scrollRef" | "scrollContainerRef" | "untouchableScrollbars" | "dataError" | "dataFiltered" | "scrollToSelectedItem" | "virtualized" | "noDataState" | "noResultsState" | "errorDataState">, "showCopyButton" | "onCopyButtonClick"> & import("react").RefAttributes<HTMLInputElement>>;
@@ -26,4 +26,4 @@ export declare const FieldSelectSingle: import("react").ForwardRefExoticComponen
26
26
  resetSearchOnOptionSelection?: boolean;
27
27
  onOpenChange?(open: boolean): void;
28
28
  selectedOptionFormatter?: SelectedOptionFormatter;
29
- } & Pick<import("@snack-uikit/list").DroplistProps, "untouchableScrollbars" | "dataError" | "dataFiltered" | "scrollToSelectedItem" | "virtualized" | "noDataState" | "noResultsState" | "errorDataState"> & import("react").RefAttributes<HTMLInputElement>>;
29
+ } & Pick<import("@snack-uikit/list").DroplistProps, "onScroll" | "scrollRef" | "scrollContainerRef" | "untouchableScrollbars" | "dataError" | "dataFiltered" | "scrollToSelectedItem" | "virtualized" | "noDataState" | "noResultsState" | "errorDataState"> & import("react").RefAttributes<HTMLInputElement>>;
@@ -74,7 +74,7 @@ type FiledSelectCommonProps = WithSupportProps<{
74
74
  resetSearchOnOptionSelection?: boolean;
75
75
  onOpenChange?(open: boolean): void;
76
76
  selectedOptionFormatter?: SelectedOptionFormatter;
77
- }> & Pick<DroplistProps, 'dataError' | 'noDataState' | 'noResultsState' | 'errorDataState' | 'dataFiltered' | 'untouchableScrollbars' | 'scrollToSelectedItem' | 'virtualized'>;
77
+ }> & Pick<DroplistProps, 'dataError' | 'noDataState' | 'noResultsState' | 'errorDataState' | 'dataFiltered' | 'untouchableScrollbars' | 'scrollToSelectedItem' | 'virtualized' | 'scrollRef' | 'scrollContainerRef' | 'onScroll'>;
78
78
  export type FieldSelectSingleProps = FieldSelectPrivateProps & Omit<SelectionSingleState, 'mode'> & WrapperProps & FiledSelectCommonProps;
79
79
  export type FieldSelectMultipleProps = FieldSelectPrivateProps & {
80
80
  removeByBackspace?: boolean;
@@ -1,3 +1,3 @@
1
1
  import { DroplistProps } from '@snack-uikit/list';
2
2
  import { FieldSelectProps } from '../types';
3
- export declare function extractListProps({ dataError, noDataState, noResultsState, errorDataState, dataFiltered, loading, footer, widthStrategy, scrollToSelectedItem, virtualized, }: Partial<FieldSelectProps>): Partial<DroplistProps>;
3
+ export declare function extractListProps({ dataError, noDataState, noResultsState, errorDataState, dataFiltered, loading, footer, widthStrategy, scrollToSelectedItem, virtualized, scrollRef, scrollContainerRef, onScroll, }: Partial<FieldSelectProps>): Partial<DroplistProps>;
@@ -1,4 +1,4 @@
1
- export function extractListProps({ dataError, noDataState, noResultsState, errorDataState, dataFiltered, loading, footer, widthStrategy, scrollToSelectedItem, virtualized, }) {
1
+ export function extractListProps({ dataError, noDataState, noResultsState, errorDataState, dataFiltered, loading, footer, widthStrategy, scrollToSelectedItem, virtualized, scrollRef, scrollContainerRef, onScroll, }) {
2
2
  return {
3
3
  dataError,
4
4
  noDataState,
@@ -9,6 +9,9 @@ export function extractListProps({ dataError, noDataState, noResultsState, error
9
9
  footer,
10
10
  widthStrategy,
11
11
  scrollToSelectedItem,
12
+ scrollRef,
13
+ scrollContainerRef,
14
+ onScroll,
12
15
  trigger: 'clickAndFocusVisible',
13
16
  placement: 'bottom',
14
17
  'data-test-id': 'field-select__list',
package/package.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "access": "public"
5
5
  },
6
6
  "title": "Fields",
7
- "version": "0.53.0",
7
+ "version": "0.53.1-preview-210b4b95.0",
8
8
  "sideEffects": [
9
9
  "*.css",
10
10
  "*.woff",
@@ -66,5 +66,5 @@
66
66
  "peerDependencies": {
67
67
  "@snack-uikit/locale": "*"
68
68
  },
69
- "gitHead": "1f7164e6cecf3ccd35444c100907479607cf10f0"
69
+ "gitHead": "b7caebe49d2cd6b14c158e0cb14cd898ed3259f0"
70
70
  }
@@ -139,6 +139,9 @@ type FiledSelectCommonProps = WithSupportProps<{
139
139
  | 'untouchableScrollbars'
140
140
  | 'scrollToSelectedItem'
141
141
  | 'virtualized'
142
+ | 'scrollRef'
143
+ | 'scrollContainerRef'
144
+ | 'onScroll'
142
145
  >;
143
146
 
144
147
  export type FieldSelectSingleProps = FieldSelectPrivateProps &
@@ -13,6 +13,9 @@ export function extractListProps({
13
13
  widthStrategy,
14
14
  scrollToSelectedItem,
15
15
  virtualized,
16
+ scrollRef,
17
+ scrollContainerRef,
18
+ onScroll,
16
19
  }: Partial<FieldSelectProps>): Partial<DroplistProps> {
17
20
  return {
18
21
  dataError,
@@ -24,6 +27,9 @@ export function extractListProps({
24
27
  footer,
25
28
  widthStrategy,
26
29
  scrollToSelectedItem,
30
+ scrollRef,
31
+ scrollContainerRef,
32
+ onScroll,
27
33
  trigger: 'clickAndFocusVisible',
28
34
  placement: 'bottom',
29
35
  'data-test-id': 'field-select__list',