Nhận thông báo về các bản phát hành sắp tới của Intlayer
    Ngày tạo:2025-04-18Cập nhật lần cuối:2025-10-28

    Dịch trang web Vite và Preact của bạn bằng Intlayer | Quốc tế hóa (i18n)

    Gói này đang trong quá trình phát triển. Xem vấn đề để biết thêm thông tin. Thể hiện sự quan tâm của bạn đến Intlayer cho Preact bằng cách thích vấn đề này

    Mục lục

    Intlayer là gì?

    Intlayer là một thư viện quốc tế hóa (i18n) mã nguồn mở sáng tạo, được thiết kế để đơn giản hóa việc hỗ trợ đa ngôn ngữ trong các ứng dụng web hiện đại.

    Với Intlayer, bạn có thể:

    • Dễ dàng quản lý bản dịch bằng cách sử dụng các từ điển khai báo ở cấp độ component.
    • Địa phương hóa động metadata, các route và nội dung.
    • Đảm bảo hỗ trợ TypeScript với các kiểu được tạo tự động, cải thiện tính năng tự hoàn thành và phát hiện lỗi.
    • Tận hưởng các tính năng nâng cao, như phát hiện và chuyển đổi locale động.

    Hướng Dẫn Từng Bước Để Cài Đặt Intlayer Trong Ứng Dụng Vite và Preact

    Xem Mẫu Ứng Dụng trên GitHub.

    Bước 1: Cài Đặt Các Phụ Thuộc

    Cài đặt các gói cần thiết bằng npm:

    npm install intlayer preact-intlayernpm install vite-intlayer --save-dev
    • intlayer

      Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, khai báo nội dung, chuyển đổi mã, và các lệnh CLI.

    • preact-intlayer Gói tích hợp Intlayer với ứng dụng Preact. Nó cung cấp các context provider và hook cho việc quốc tế hóa trong Preact.

    • vite-intlayer Bao gồm plugin Vite để tích hợp Intlayer với Vite bundler, cũng như middleware để phát hiện ngôn ngữ ưu tiên của người dùng, quản lý cookie và xử lý chuyển hướng URL.

    Bước 2: Cấu hình dự án của bạn

    Tạo một file cấu hình để cấu hình các ngôn ngữ của ứng dụng của bạn:

    intlayer.config.ts
    import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  internationalization: {    locales: [      Locales.ENGLISH,      Locales.FRENCH,      Locales.SPANISH,      // Các ngôn ngữ khác của bạn    ],    defaultLocale: Locales.ENGLISH,  },  routing: {    mode: "prefix-no-default", // Mặc định: thêm tiền tố cho tất cả các ngôn ngữ ngoại trừ ngôn ngữ mặc định    storage: ["cookie", "header"], // Mặc định: lưu ngôn ngữ trong cookie và phát hiện từ header  },};export default config;
    Thông qua tệp cấu hình này, bạn có thể thiết lập URL đa ngôn ngữ, chế độ định tuyến, tùy chọn lưu trữ, tên cookie, vị trí và phần mở rộng của các khai báo nội dung, tắt các log của Intlayer trên console, và nhiều hơn nữa. Để xem danh sách đầy đủ các tham số có sẵn, hãy tham khảo tài liệu cấu hình.

    Bước 3: Tích hợp Intlayer vào cấu hình Vite của bạn

    Thêm plugin intlayer vào cấu hình của bạn.

    vite.config.ts
    import { defineConfig } from "vite";import preact from "@preact/preset-vite";import { intlayer } from "vite-intlayer";// https://vitejs.dev/config/export default defineConfig({  plugins: [preact(), intlayer()],});
    Plugin Vite intlayer() được sử dụng để tích hợp Intlayer với Vite. Nó đảm bảo việc xây dựng các file khai báo nội dung và giám sát chúng trong chế độ phát triển. Nó định nghĩa các biến môi trường Intlayer trong ứng dụng Vite. Ngoài ra, nó còn cung cấp các bí danh để tối ưu hiệu suất.

    Bước 4: Khai báo Nội dung của Bạn

    Tạo và quản lý các khai báo nội dung để lưu trữ bản dịch:

    src/app.content.tsx
    import { t, type Dictionary } from "intlayer";import type { ComponentChildren } from "preact";const appContent = {  key: "app",  content: {    viteLogo: t({      en: "Vite logo",      fr: "Logo Vite",      es: "Logo Vite",    }),    preactLogo: t({      en: "Preact logo",      fr: "Logo Preact",      es: "Logo Preact",    }),    title: "Vite + Preact",    count: t({      en: "count is ",      fr: "le compte est ",      es: "el recuento es ",    }),    edit: t<ComponentChildren>({      en: (        <>          Chỉnh sửa <code>src/app.tsx</code> và lưu để thử HMR        </>      ),      fr: (        <>          Éditez <code>src/app.tsx</code> et enregistrez pour tester HMR        </>      ),      es: (        <>          Edita <code>src/app.tsx</code> y guarda para probar HMR        </>      ),    }),    readTheDocs: t({      en: "Nhấn vào logo Vite và Preact để tìm hiểu thêm",      fr: "Cliquez sur les logos Vite et Preact pour en savoir plus",      es: "Haga clic en los logotipos de Vite y Preact para obtener más información",    }),  },} satisfies Dictionary;export default appContent;
    Các khai báo nội dung của bạn có thể được định nghĩa ở bất kỳ đâu trong ứng dụng của bạn miễn là chúng được đưa vào thư mục contentDir (mặc định là ./src). Và phải phù hợp với phần mở rộng của file khai báo nội dung (mặc định là .content.{json,ts,tsx,js,jsx,mjs,mjx,cjs,cjx}).
    Để biết thêm chi tiết, hãy tham khảo tài liệu khai báo nội dung.
    Nếu file nội dung của bạn bao gồm mã TSX, bạn có thể cần import import { h } from "preact"; hoặc đảm bảo pragma JSX của bạn được thiết lập đúng cho Preact.

    Bước 5: Sử dụng Intlayer trong Code của Bạn

    Truy cập các từ điển nội dung trong toàn bộ ứng dụng của bạn:

    src/app.tsx
    import { useState } from "preact/hooks";import type { FunctionalComponent } from "preact";import preactLogo from "./assets/preact.svg"; // Giả sử bạn có file preact.svgimport viteLogo from "/vite.svg";import "./app.css"; // Giả sử file CSS của bạn tên là app.cssimport { IntlayerProvider, useIntlayer } from "preact-intlayer";const AppContent: FunctionalComponent = () => {  const [count, setCount] = useState(0);  const content = useIntlayer("app");  return (    <>      <div>        <a href="https://vitejs.dev" target="_blank">          <img src={viteLogo} class="logo" alt={content.viteLogo.value} />        </a>        <a href="https://preactjs.com" target="_blank">          <img            src={preactLogo}            class="logo preact"            alt={content.preactLogo.value}          />        </a>      </div>      <h1>{content.title}</h1>      <div class="card">        <button onClick={() => setCount((count) => count + 1)}>          {content.count}          {count}        </button>        <p>{content.edit}</p>      </div>      <p class="read-the-docs">{content.readTheDocs}</p>    </>  );};const App: FunctionalComponent = () => (  <IntlayerProvider>    <AppContent />  </IntlayerProvider>);export default App;
    Nếu bạn muốn sử dụng nội dung của mình trong một thuộc tính string, chẳng hạn như alt, title, href, aria-label, v.v., bạn phải gọi giá trị của hàm, ví dụ:
    <img src={content.image.src.value} alt={content.image.value} />
    Lưu ý: Trong Preact, className thường được viết là class.
    Để tìm hiểu thêm về hook useIntlayer, hãy tham khảo tài liệu (API tương tự cho preact-intlayer).

    (Tùy chọn) Bước 6: Thay đổi ngôn ngữ của nội dung

    Để thay đổi ngôn ngữ của nội dung, bạn có thể sử dụng hàm setLocale được cung cấp bởi hook useLocale. Hàm này cho phép bạn thiết lập locale của ứng dụng và cập nhật nội dung tương ứng.

    src/components/LocaleSwitcher.tsx
    import type { FunctionalComponent } from "preact";import { Locales } from "intlayer";import { useLocale } from "preact-intlayer";const LocaleSwitcher: FunctionalComponent = () => {  const { setLocale } = useLocale();  return (    <button onClick={() => setLocale(Locales.ENGLISH)}>      Thay đổi ngôn ngữ sang tiếng Anh    </button>  );};export default LocaleSwitcher;
    Để tìm hiểu thêm về hook useLocale, hãy tham khảo tài liệu (API tương tự cho preact-intlayer).

    (Tùy chọn) Bước 7: Thêm định tuyến có bản địa hóa vào ứng dụng của bạn

    Mục đích của bước này là tạo các tuyến đường duy nhất cho mỗi ngôn ngữ. Điều này hữu ích cho SEO và các URL thân thiện với SEO. Ví dụ:

    - https://example.com/about- https://example.com/es/about- https://example.com/fr/about
    Mặc định, các route không được thêm tiền tố cho locale mặc định (routing.mode: "prefix-no-default"). Nếu bạn muốn thêm tiền tố cho locale mặc định, bạn có thể đặt tùy chọn routing.mode thành "prefix-all" trong cấu hình của bạn. Xem thêm tại tài liệu cấu hình để biết thêm thông tin.

    Để thêm routing theo locale vào ứng dụng của bạn, bạn có thể tạo một component LocaleRouter bao bọc các route của ứng dụng và xử lý routing dựa trên locale. Dưới đây là ví dụ sử dụng preact-iso:

    Đầu tiên, cài đặt preact-iso:

    npm install preact-iso
    src/components/LocaleRouter.tsx
    import { configuration, getPathWithoutLocale, type Locale } from "intlayer";import type { ComponentChildren, FunctionalComponent } from "preact";import { useEffect } from "preact/hooks";import { IntlayerProvider } from "preact-intlayer";import { LocationProvider, useLocation } from "preact-iso";const { internationalization, routing } = configuration;const { locales, defaultLocale } = internationalization;const Navigate: FunctionalComponent<{ to: string; replace?: boolean }> = ({  to,  replace,}) => {  const { route } = useLocation();  useEffect(() => {    route(to, replace);  }, [to, replace, route]);  return null;};/**/** * Một component xử lý việc địa phương hóa và bao bọc các phần tử con với ngữ cảnh locale phù hợp. * Nó quản lý việc phát hiện và xác thực locale dựa trên URL. */const AppLocalized: FunctionalComponent<{  children: ComponentChildren;  locale?: Locale;}> = ({ children, locale }) => {  const { path: pathname, url } = useLocation();  if (!url) {    return null;  }  const search = url.substring(pathname.length);  // Xác định locale hiện tại, nếu không có thì sử dụng locale mặc định  const currentLocale = locale ?? defaultLocale;  // Loại bỏ tiền tố locale khỏi đường dẫn để tạo đường dẫn cơ sở  const pathWithoutLocale = getPathWithoutLocale(    pathname // Đường dẫn URL hiện tại  );  /**   * Nếu routing.mode là 'prefix-all', locale mặc định luôn phải được thêm tiền tố.   */  if (routing.mode === "prefix-all") {    // Xác thực locale    if (!locale || !locales.includes(locale)) {      // Chuyển hướng đến locale mặc định với đường dẫn đã cập nhật      return (        <Navigate          to={`/${defaultLocale}/${pathWithoutLocale}${search}`}          replace // Thay thế mục lịch sử hiện tại bằng mục mới        />      );    }    // Bao bọc các phần tử con với IntlayerProvider và thiết lập locale hiện tại    return (      <IntlayerProvider locale={currentLocale}>{children}</IntlayerProvider>    );  } else {    /**     * Khi routing.mode không phải 'prefix-all', locale mặc định sẽ không có tiền tố.     * Đảm bảo rằng locale hiện tại hợp lệ và không phải là locale mặc định.     */    if (      currentLocale.toString() !== defaultLocale.toString() &&      !locales        .filter(          (loc) => loc.toString() !== defaultLocale.toString() // Loại trừ locale mặc định        )        .includes(currentLocale) // Kiểm tra xem locale hiện tại có trong danh sách các locale hợp lệ không    ) {      // Chuyển hướng đến đường dẫn không có tiền tố locale      return <Navigate to={`${pathWithoutLocale}${search}`} replace />;    }    // Bao bọc children với IntlayerProvider và đặt locale hiện tại    return (      <IntlayerProvider locale={currentLocale}>{children}</IntlayerProvider>    );  }};const RouterContent: FunctionalComponent<{  children: ComponentChildren;}> = ({ children }) => {  const { path } = useLocation();  if (!path) {    return null;  }  const pathLocale = path.split("/")[1] as Locale;  const isLocaleRoute = locales    .filter(      (locale) => routing.mode === "prefix-all" || locale !== defaultLocale    )    .some((locale) => locale.toString() === pathLocale);  if (isLocaleRoute) {    return <AppLocalized locale={pathLocale}>{children}</AppLocalized>;  }  return (    <AppLocalized      locale={routing.mode !== "prefix-all" ? defaultLocale : undefined}    >      {children}    </AppLocalized>  );};/** * Một component router thiết lập các route theo locale cụ thể. * Nó sử dụng preact-iso để quản lý điều hướng và render các component theo locale. */export const LocaleRouter: FunctionalComponent<{  children: ComponentChildren;}> = ({ children }) => (  <LocationProvider>    <RouterContent>{children}</RouterContent>  </LocationProvider>);

    Sau đó, bạn có thể sử dụng component LocaleRouter trong ứng dụng của mình:

    src/app.tsx
    import { LocaleRouter } from "./components/LocaleRouter";import type { FunctionalComponent } from "preact";// ... Component AppContent của bạn (được định nghĩa trong Bước 5)const App: FunctionalComponent = () => (  <LocaleRouter>    <AppContent />  </LocaleRouter>);export default App;

    Trong khi đó, bạn cũng có thể sử dụng intlayerProxy để thêm routing phía server vào ứng dụng của bạn. Plugin này sẽ tự động phát hiện locale hiện tại dựa trên URL và thiết lập cookie locale phù hợp. Nếu không có locale nào được chỉ định, plugin sẽ xác định locale phù hợp nhất dựa trên ngôn ngữ trình duyệt của người dùng. Nếu không phát hiện được locale nào, nó sẽ chuyển hướng đến locale mặc định.

    Lưu ý rằng để sử dụng intlayerProxy trong môi trường production, bạn cần chuyển gói vite-intlayer từ devDependencies sang dependencies.
    vite.config.ts
    import { defineConfig } from "vite";import preact from "@preact/preset-vite";import { intlayer, intlayerProxy } from "vite-intlayer";// https://vitejs.dev/config/export default defineConfig({  plugins: [preact(), intlayer(), intlayerProxy()],});

    (Tùy chọn) Bước 8: Thay đổi URL khi locale thay đổi

    Để thay đổi URL khi locale thay đổi, bạn có thể sử dụng prop onLocaleChange được cung cấp bởi hook useLocale. Đồng thời, bạn có thể sử dụng useLocationroute từ preact-iso để cập nhật đường dẫn URL.

    src/components/LocaleSwitcher.tsx
    import { useLocation, route } from "preact-iso";import {  Locales,  getHTMLTextDir,  getLocaleName,  getLocalizedUrl,} from "intlayer";import { useLocale } from "preact-intlayer";import type { FunctionalComponent } from "preact";const LocaleSwitcher: FunctionalComponent = () => {  const location = useLocation();  plugins: [preact(), intlayer(), intlayerProxy()],});

    (Tùy chọn) Bước 8: Thay đổi URL khi thay đổi locale

    Để thay đổi URL khi locale thay đổi, bạn có thể sử dụng prop onLocaleChange được cung cấp bởi hook useLocale. Đồng thời, bạn có thể sử dụng useLocationroute từ preact-iso để cập nhật đường dẫn URL.

    src/components/LocaleSwitcher.tsx
    import { useLocation, route } from "preact-iso";import {  Locales,  getHTMLTextDir,  getLocaleName,  getLocalizedUrl,} from "intlayer";import { useLocale } from "preact-intlayer";import type { FunctionalComponent } from "preact";const LocaleSwitcher: FunctionalComponent = () => {  const location = useLocation();  const { locale, availableLocales, setLocale } = useLocale({    onLocaleChange: (newLocale) => {      const currentFullPath = location.url; // preact-iso cung cấp URL đầy đủ      // Xây dựng URL với locale được cập nhật      // Ví dụ: /es/about?foo=bar      const pathWithLocale = getLocalizedUrl(currentFullPath, newLocale);      // Cập nhật đường dẫn URL      route(pathWithLocale, true); // true để thay thế    },  });  return (    <div>      <button popovertarget="localePopover">{getLocaleName(locale)}</button>      <div id="localePopover" popover="auto">        {availableLocales.map((localeItem) => (          <a            href={getLocalizedUrl(location.url, localeItem)}            hreflang={localeItem}            aria-current={locale === localeItem ? "page" : undefined}            onClick={(e) => {              e.preventDefault();              setLocale(localeItem);              // Điều hướng lập trình sau khi đặt locale sẽ được xử lý bởi onLocaleChange            }}            key={localeItem}          >            <span>              {/* Locale - ví dụ: FR */}              {localeItem}            </span>            <span>              {/* Ngôn ngữ trong chính Locale của nó - ví dụ: Français */}              {getLocaleName(localeItem, localeItem)}            </span>            <span dir={getHTMLTextDir(localeItem)} lang={localeItem}>              {/* Ngôn ngữ trong Locale hiện tại - ví dụ: Francés với locale hiện tại được đặt thành Locales.SPANISH */}              {getLocaleName(localeItem, locale)}            </span>            <span dir="ltr" lang={Locales.ENGLISH}>              {/* Ngôn ngữ bằng tiếng Anh - ví dụ: French */}              {getLocaleName(localeItem, Locales.ENGLISH)}            </span>          </a>        ))}      </div>    </div>  );};export default LocaleSwitcher;

    Tham khảo tài liệu:

    - useLocale hook (API tương tự cho preact-intlayer) > - getLocaleName hook > - getLocalizedUrl hook > - getHTMLTextDir hook > - Thuộc tính hreflang > - Thuộc tính lang > - Thuộc tính dir > - Thuộc tính aria-current > - API Popoverla.org/en-US/docs/Web/HTML/Globalattributes/dir)> - aria-current attribute> - [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/PopoverAPI)

    Dưới đây là Bước 9 được cập nhật với các giải thích bổ sung và ví dụ mã được tinh chỉnh:


    (Tùy chọn) Bước 9: Chuyển đổi thuộc tính Ngôn ngữ và Hướng của thẻ HTML

    Khi ứng dụng của bạn hỗ trợ nhiều ngôn ngữ, việc cập nhật các thuộc tính langdir của thẻ <html> để phù hợp với locale hiện tại là rất quan trọng. Việc này đảm bảo:

    • Khả năng truy cập: Các trình đọc màn hình và công nghệ hỗ trợ dựa vào thuộc tính lang chính xác để phát âm và hiểu nội dung một cách chính xác.
    • Hiển thị văn bản: Thuộc tính dir (hướng) đảm bảo văn bản được hiển thị theo đúng thứ tự (ví dụ: từ trái sang phải cho tiếng Anh, từ phải sang trái cho tiếng Ả Rập hoặc tiếng Do Thái), điều này rất cần thiết cho khả năng đọc.
    • SEO: Các công cụ tìm kiếm sử dụng thuộc tính lang để xác định ngôn ngữ của trang, giúp phục vụ nội dung địa phương hóa phù hợp trong kết quả tìm kiếm.

    Bằng cách cập nhật các thuộc tính này một cách động khi locale thay đổi, bạn đảm bảo trải nghiệm nhất quán và dễ tiếp cận cho người dùng trên tất cả các ngôn ngữ được hỗ trợ.

    Triển khai Hook

    Tạo một hook tùy chỉnh để quản lý các thuộc tính HTML. Hook này lắng nghe sự thay đổi của locale và cập nhật các thuộc tính tương ứng:

    src/hooks/useI18nHTMLAttributes.tsx
    import { useEffect } from "preact/hooks";import { useLocale } from "preact-intlayer";import { getHTMLTextDir } from "intlayer";/** * Cập nhật thuộc tính `lang` và `dir` của phần tử <html> dựa trên locale hiện tại. * - `lang`: Thông báo cho trình duyệt và công cụ tìm kiếm về ngôn ngữ của trang. * - `dir`: Đảm bảo thứ tự đọc đúng (ví dụ: 'ltr' cho tiếng Anh, 'rtl' cho tiếng Ả Rập). * * Việc cập nhật động này rất quan trọng để hiển thị văn bản đúng cách, hỗ trợ truy cập và SEO. */export const useI18nHTMLAttributes = () => {  const { locale } = useLocale();  useEffect(() => {    // Cập nhật thuộc tính ngôn ngữ thành locale hiện tại.    document.documentElement.lang = locale;    // Đặt hướng văn bản dựa trên locale hiện tại.    document.documentElement.dir = getHTMLTextDir(locale);  }, [locale]);};

    Sử dụng Hook trong Ứng dụng của Bạn

    Tích hợp hook vào thành phần chính của bạn để các thuộc tính HTML được cập nhật mỗi khi locale thay đổi:

    src/app.tsx
    import type { FunctionalComponent } from "preact";import { IntlayerProvider } from "preact-intlayer"; // useIntlayer đã được import nếu AppContent cầnimport { useI18nHTMLAttributes } from "./hooks/useI18nHTMLAttributes";import "./app.css";// Định nghĩa AppContent từ Bước 5const AppWithHooks: FunctionalComponent = () => {  // Áp dụng hook để cập nhật các thuộc tính lang và dir của thẻ <html> dựa trên locale.  useI18nHTMLAttributes();  // Giả sử AppContent là thành phần hiển thị nội dung chính của bạn từ Bước 5  return <AppContent />;};const App: FunctionalComponent = () => (  <IntlayerProvider>    <AppWithHooks />  </IntlayerProvider>);export default App;

    Bằng cách áp dụng những thay đổi này, ứng dụng của bạn sẽ:

    • Đảm bảo thuộc tính ngôn ngữ (lang) phản ánh chính xác locale hiện tại, điều này quan trọng cho SEO và hành vi của trình duyệt.
    • Điều chỉnh hướng văn bản (dir) theo locale, nâng cao khả năng đọc và tính tiện dụng cho các ngôn ngữ có thứ tự đọc khác nhau.
    • Cung cấp trải nghiệm dễ tiếp cận hơn, vì các công nghệ hỗ trợ phụ thuộc vào các thuộc tính này để hoạt động tối ưu.

    Để đảm bảo điều hướng trong ứng dụng của bạn tôn trọng ngôn ngữ hiện tại, bạn có thể tạo một thành phần Link tùy chỉnh. Thành phần này tự động thêm tiền tố ngôn ngữ hiện tại vào các URL nội bộ.

    Hành vi này hữu ích vì một số lý do:

    • SEO và Trải nghiệm người dùng: URL có địa phương hóa giúp các công cụ tìm kiếm lập chỉ mục chính xác các trang theo ngôn ngữ và cung cấp nội dung cho người dùng theo ngôn ngữ ưu tiên của họ.
    • Tính nhất quán: Bằng cách sử dụng liên kết có địa phương hóa trong toàn bộ ứng dụng, bạn đảm bảo điều hướng luôn nằm trong ngôn ngữ hiện tại, tránh việc chuyển đổi ngôn ngữ không mong muốn.
    • Dễ bảo trì: Tập trung logic địa phương hóa trong một component duy nhất giúp đơn giản hóa việc quản lý các URL.

    Đối với Preact khi dùng preact-iso, bạn thường dùng thẻ <a> cho điều hướng nội bộ. Để đảm bảo các liên kết phù hợp với locale hiện tại, bạn nên tạo một component anchor tùy chỉnh tự động thêm tiền tố locale và xử lý điều hướng phía client bằng route từ preact-iso. Dưới đây là ví dụ hoàn chỉnh:

    src/components/LocalizedLink.tsx
    import { getLocalizedUrl } from "intlayer";import { useLocale } from "preact-intlayer";import { useLocation, route } from "preact-iso";import type { JSX } from "preact";import { forwardRef } from "preact/compat";/** Kiểm tra một đường dẫn có phải là liên kết ngoài không */export const checkIsExternalLink = (href?: string) =>  /^https?:\/\//.test(href ?? "");export interface LocalizedLinkProps  extends JSX.HTMLAttributes<HTMLAnchorElement> {  href: string;  replace?: boolean;}/** * LocalizedLink là một thẻ <a> tự động nối locale hiện tại vào đường dẫn nội bộ * và điều hướng route phía client mà không load lại trang. */export const LocalizedLink = forwardRef<HTMLAnchorElement, LocalizedLinkProps>(  ({ href, children, onClick, replace = false, ...props }, ref) => {    const { locale } = useLocale();    const location = useLocation();    const isExternal = checkIsExternalLink(href);    const hrefLocalized =      href && !isExternal ? getLocalizedUrl(href, locale) : href;    const handleClick = (event: JSX.TargetedMouseEvent<HTMLAnchorElement>) => {      if (onClick) onClick(event);      if (        !isExternal &&        href &&        event.button === 0 &&        !event.metaKey &&        !event.ctrlKey &&        !event.shiftKey &&        !event.altKey &&        !props.target      ) {        event.preventDefault();        if (location.url !== hrefLocalized) {          route(hrefLocalized, replace);        }      }    };    return (      <a href={hrefLocalized} ref={ref} onClick={handleClick} {...props}>        {children}      </a>    );  });

    Cách Hoạt Động

    • Phát hiện Liên kết Ngoài:
      Hàm trợ giúp checkIsExternalLink xác định xem một URL có phải là liên kết ngoài hay không. Các liên kết ngoài sẽ không bị thay đổi.
    • Lấy Ngôn ngữ Hiện tại:
      Hook useLocale cung cấp ngôn ngữ hiện tại.
    • Địa phương hóa URL:
      Đối với các liên kết nội bộ, getLocalizedUrl sẽ thêm tiền tố ngôn ngữ hiện tại vào URL.
    • Điều hướng phía Client: Hàm handleClick kiểm tra xem đó có phải là liên kết nội bộ và liệu điều hướng tiêu chuẩn có nên bị ngăn chặn hay không. Nếu đúng, nó sử dụng hàm route của preact-iso (lấy qua useLocation hoặc nhập trực tiếp) để thực hiện điều hướng phía client. Điều này cung cấp hành vi giống SPA mà không cần tải lại toàn bộ trang.
    • Trả về Liên kết:
      Component trả về một phần tử <a> với URL đã được địa phương hóa và trình xử lý sự kiện click tùy chỉnh.

    Cấu hình TypeScript

    Intlayer sử dụng module augmentation để tận dụng lợi ích của TypeScript và làm cho codebase của bạn mạnh mẽ hơn.

    Tự động hoàn thành

    Lỗi dịch thuật

    Đảm bảo cấu hình TypeScript của bạn bao gồm các kiểu được tạo tự động.

    tsconfig.json
    {  // ... Các cấu hình TypeScript hiện có của bạn  "compilerOptions": {    // ...    "jsx": "react-jsx",    "jsxImportSource": "preact", // Khuyến nghị cho Preact 10+    // ...  },  "include": [    // ... Các cấu hình TypeScript hiện có của bạn    ".intlayer/**/*.ts", // Bao gồm các kiểu được tạo tự động  ],}
    Đảm bảo tsconfig.json của bạn được thiết lập cho Preact, đặc biệt là jsxjsxImportSource hoặc jsxFactory/jsxFragmentFactory cho các phiên bản Preact cũ hơn nếu không sử dụng mặc định của preset-vite.

    Cấu hình Git

    Khuyến nghị bỏ qua các tệp được tạo bởi Intlayer. Điều này giúp bạn tránh việc commit chúng vào kho Git của mình.

    Để làm điều này, bạn có thể thêm các hướng dẫn sau vào tệp .gitignore của mình:

    # Bỏ qua các tệp được tạo bởi Intlayer.intlayer

    Tiện ích mở rộng VS Code

    Để cải thiện trải nghiệm phát triển với Intlayer, bạn có thể cài đặt Tiện ích mở rộng Intlayer cho VS Code chính thức.

    Cài đặt từ VS Code Marketplace

    Tiện ích mở rộng này cung cấp:

    • Tự động hoàn thành cho các khóa dịch.
    • Phát hiện lỗi thời gian thực cho các bản dịch bị thiếu.
    • Xem trước nội tuyến của nội dung đã dịch.
    • Hành động nhanh để dễ dàng tạo và cập nhật bản dịch.

    Để biết thêm chi tiết về cách sử dụng tiện ích mở rộng, hãy tham khảo tài liệu Tiện ích mở rộng Intlayer cho VS Code.


    Đi xa hơn

    Để đi xa hơn, bạn có thể triển khai trình soạn thảo trực quan hoặc tách nội dung của bạn ra bên ngoài bằng cách sử dụng CMS.

    Nhận thông báo về các bản phát hành sắp tới của Intlayer