React-toastify v-마지막으로 쉽게 사용자 정의 가능

react-toastify에 대해 들어본 적이 없으신가요? 데모를 확인해보세요

v11의 새로운 기능

이번 출시가 정말 기대됩니다! 주요 초점은 맞춤화에 있었으며, 제 목표는 귀하(그리고 나 자신)가 알림의 모양과 느낌을 완전히 개인화할 수 있도록 하는 것이었습니다.

요컨대, React-toastify는 어떤 디자인 시스템에도 조화를 이룰 수 있어야 합니다.

더 이상 CSS 파일을 가져올 필요가 없습니다.

이제 스타일시트가 자동으로 삽입되므로 더 이상 가져올 필요가 없습니다. CSS 파일은 여전히 ​​라이브러리에서 내보내집니다.

  import { ToastContainer, toast } from 'react-toastify';

  function App(){
    const notify = () => toast("Wow so easy !");

    return (
      <div>
        <button onClick={notify}>Notify !</button>
        <ToastContainer />
      </div>
    );
  }

쉬운 사용자 정의!

가장 많은 요청 중 하나는 알림을 맞춤설정하는 방법이었습니다. 공평하게 말하면, 이번 릴리스까지는 사용자가 수많은 CSS 클래스를 재정의해야 했기 때문에 상당히 어려웠습니다.

외부 div 요소, 중첩 요소 등을 제거하여 알림의 DOM 구조를 단순화했습니다. 이는 획기적인 변화이지만 실제로 노력할 가치가 있습니다. 이제 라이브러리는 모든 디자인 시스템에 완벽하게 통합될 수 있다고 자신있게 말할 수 있습니다.

아래에서는 Tailwind만을 사용하여 몇 가지 다른 디자인을 구현했습니다. react-toastify에서 CSS 클래스 하나도 재정의하지 않았나요?!

Stackblitz로 이동하여 코드를 확인하세요.

실제로 어떻게 작동하나요? 왼쪽에는 이전 DOM 구조가 있고 오른쪽에는 새 DOM 구조가 있습니다.

• Toastify__toast-body 및 해당 하위 항목은 이제 완전히 사라졌습니다.
• 이제 CloseButton은 절대 위치를 사용합니다.

이러한 변경 덕분에 어떤 것도 귀하의 콘텐츠를 방해하지 않을 것입니다.

Toastify__toast에는 CSS를 사용하거나 관련 CSS 변수를 업데이트하여 사용자 정의할 수 있는 합리적인 기본값(예: border-radius, Shadow 등)이 있습니다.

width: var(--toastify-toast-width);
min-height: var(--toastify-toast-min-height);
padding: var(--toastify-toast-padding);
border-radius: var(--toastify-toast-bd-radius);
box-shadow: var(--toastify-toast-shadow);
max-height: var(--toastify-toast-max-height);
font-family: var(--toastify-font-family);

사용자 정의 진행률 표시줄

이번 릴리스를 작업하는 동안 사용자 정의 진행률 표시줄을 허용하는 것은 내 할 일 목록에 전혀 없었습니다. 하지만 이제 알림을 맞춤설정하는 것이 얼마나 쉬운지 보니 거부할 수 없었습니다.

가장 좋은 점은 autoClose, PauseOnHover, PauseOnFocusLoss 또는 제어된 진행률 표시줄과 같은 기능을 포기할 필요가 없다는 것입니다. 원활하게 작동합니다.

여기에 작은 요점이 있습니다.

function App() {
  const notify = () => {
    toast(CustomComponent, {
      autoClose: 8000,
      // removes the built-in progress bar
      customProgressBar: true
    });
  };

  return (
    <div>
      <button onClick={notify}>notify</button>
      <ToastContainer />
    </div>
  );
}

// isPaused is now available in your component
// it tells you when to pause the animation: pauseOnHover, pauseOnFocusLoss etc...
function CustomComponent({ isPaused, closeToast }: ToastContentProps) {
  return (
    <div>
      <span>Hello</span>
      <MyCustomProgressBar isPaused={isPaused} onAnimationEnd={() => closeToast()} />
    </div>
  );
}

실제 사례를 보려면 stackblitz로 이동하세요.

접근성 및 키보드 탐색

ToastContainer와 toast는 ariaLabel prop을 받아들입니다(마침내...). 이는 스크린 리더와 테스트에 매우 유용합니다.
예를 들어, cypress에서는 cy.findByRole("alert", {name: "the aria label you selected"})를 수행할 수 있습니다.

  import { ToastContainer, toast } from 'react-toastify';

  function App(){
    const notify = () => toast("Wow so easy !");

    return (
      <div>
        <button onClick={notify}>Notify !</button>
        <ToastContainer />
      </div>
    );
  }

알림이 표시되고 사용자가 Alt t를 누르면 사용자가 Tab을 사용하여 알림 내의 다양한 요소를 탐색할 수 있도록 첫 번째 알림에 초점이 맞춰집니다.

단축키는 물론 변경 가능합니다.

width: var(--toastify-toast-width);
min-height: var(--toastify-toast-min-height);
padding: var(--toastify-toast-padding);
border-radius: var(--toastify-toast-bd-radius);
box-shadow: var(--toastify-toast-shadow);
max-height: var(--toastify-toast-max-height);
font-family: var(--toastify-font-family);

onClose 콜백을 통한 알림 제거 이유

사용자가 알림을 닫았는지 아니면 자동으로 닫혔는지 알고 싶으십니까? 이제 가능하니 안심하세요!

onClose 콜백의 서명은 이제 onClose(reason?: boolean | string) =>입니다. 무효입니다.

사용자가 알림을 닫으면 이유 인수는 true와 같습니다. 아래 예에서는 인수의 이름을 지정했습니다
삭제ByUser 의도를 명확하게 합니다.

function App() {
  const notify = () => {
    toast(CustomComponent, {
      autoClose: 8000,
      // removes the built-in progress bar
      customProgressBar: true
    });
  };

  return (
    <div>
      <button onClick={notify}>notify</button>
      <ToastContainer />
    </div>
  );
}

// isPaused is now available in your component
// it tells you when to pause the animation: pauseOnHover, pauseOnFocusLoss etc...
function CustomComponent({ isPaused, closeToast }: ToastContentProps) {
  return (
    <div>
      <span>Hello</span>
      <MyCustomProgressBar isPaused={isPaused} onAnimationEnd={() => closeToast()} />
    </div>
  );
}

알림에 사용자 정의 구성요소를 사용하는 경우 특히 여기에 포함된 경우 이유를 더 세밀하게 제어할 수 있습니다.
다양한 클릭 유도문안

toast("hello", {
  ariaLabel: "something"
})

? 주요 변경 사항

useToastContainer 및 useToast가 더 이상 노출되지 않습니다.

이러한 후크는 함께 연결하는 방법을 이해하기 위해 React-toastify 소스 코드를 자세히 살펴보지 않는 한 사용할 수 없습니다. 이는 제가 사용자에게 바라는 바가 아닙니다. 애초에 사용자를 노출시킨 것은 잘못된 결정이었고 좋은 교훈을 얻었습니다.

onClose 및 onOpen은 더 이상 하위 소품을 받지 않습니다.

돌이켜보면 이런 짓은 하지 말았어야 했는데. 이 기능은 사실상 사용되지 않습니다. 각 콜백의 새 서명 아래:

• onOpen: () => 무효
• onClose: (이유?: 부울 | 문자열) => 무효

스타일링

• React-toastify/dist/ReactToastify.minimal.css가 제거되었습니다.
• Scss는 현재 사진에서 사라졌습니다. 라이브러리는 오래된 CSS를 사용합니다.
• bodyClassName 및 bodyStyle은 더 이상 필요하지 않습니다.
• API 표면을 줄이기 위해 ProgressBarStyle을 사용합니다. 이제 인라인 스타일에 의존하지 않고 모든 것을 사용자 정의하는 더 나은 방법입니다.
• injectStyle이 제거되었습니다. 이 기능은 더 이상 필요하지 않습니다.
• CSS 클래스 Toastify__toast-body와 직계 하위 항목이 제거되었습니다.

? 버그 수정

• react19 #1177 #1185에 대한 지원 추가
• CloseButtonProps #1165 다시 내보내기
• 이번에는 NewOnTop을 실제로 수정하세요 #1176
• 이 추악한 오류가 더 이상 발생하지 않습니다. 정의되지 않은 속성을 설정할 수 없습니다('토글' 설정) #1170
• 종료 애니메이션이 완료될 때까지 onClose 콜백이 더 이상 지연되지 않습니다. #1179

?다음은 무엇입니까?

문서의 일부를 점차적으로 다시 작성하고 있습니다. 저는 stackblitz에 컬렉션을 만들었습니다. 이렇게 하면 모든 예제를 한 곳에서 찾을 수 있습니다. 앞으로 계속 예시를 추가하겠습니다.

위 내용은 React-toastify v-마지막으로 쉽게 사용자 정의 가능의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!