Đặt câu hỏi và nhận tóm tắt tài liệu bằng cách tham chiếu trang này và nhà cung cấp AI bạn chọn
Lịch sử phiên bản
- "Thêm tài liệu cho useIntlayer, useDictionary, useLocale hooks, middleware và formatters"v9.5.519/9/2026
- "Hợp nhất tài liệu cho tất cả các bản xuất"v8.0.021/1/2026
Nội dung của trang này đã được dịch bằng AI.
Xem phiên bản mới nhất của nội dung gốc bằng tiếng AnhNếu bạn có ý tưởng để cải thiện tài liệu này, vui lòng đóng góp bằng cách gửi pull request trên GitHub.
Liên kết GitHub tới tài liệuSao chép Markdown của tài liệu vào bộ nhớ tạm
Gói astro-intlayer
Gói astro-intlayer cung cấp các công cụ cần thiết để tích hợp Intlayer vào các ứng dụng Astro. Nó cấu hình định tuyến dựa trên ngôn ngữ, quản lý từ điển, viết lại trang trong quá trình build, middleware xử lý yêu cầu và các hook để truy cập nội dung đa ngôn ngữ trên cả các thành phần .astro được render trên máy chủ và các script phía client.
Cài đặt
Sao chép mã vào clipboard
Các bản xuất (Exports)
Tích hợp (Integration)
Gói astro-intlayer cung cấp tích hợp Astro để thiết lập Intlayer trong dự án của bạn.
Nhập (Import):
Sao chép mã vào clipboard
hoặc nhập mặc định trong astro.config.mjs:
Sao chép mã vào clipboard
Mở bảng trong một cửa sổ bật lên để xem toàn bộ nội dung dữ liệu một cách rõ ràng
| Hàm | Mô tả | Tài liệu liên quan |
|---|---|---|
intlayer | Tích hợp Astro chuẩn bị từ điển, cấu hình plugin Vite (alias, proxy định tuyến, cắt tỉa mã build), tự động đăng ký middleware yêu cầu và xuất các trang prerender tại các URL được bản địa hóa. | intlayer |
Hooks (Máy chủ & Client)
Nhập (Import):
Sao chép mã vào clipboard
Mở bảng trong một cửa sổ bật lên để xem toàn bộ nội dung dữ liệu một cách rõ ràng
| Hook | Mô tả | Tài liệu liên quan |
|---|---|---|
useIntlayer | Chọn một từ điển theo khóa và trả về nội dung được bản địa hóa. Trong frontmatter .astro, nó đọc ngôn ngữ từ Astro.locals. Trong <script> client, nó đọc từ store của client. | useIntlayer |
useDictionary | Chuyển đổi một đối tượng từ điển và trả về nội dung cho ngôn ngữ đã giải quyết. Hoạt động trong frontmatter và script phía client. | useDictionary |
useLocale | Trả về ngôn ngữ hiện tại, ngôn ngữ mặc định, danh sách các ngôn ngữ khả dụng và hàm để cập nhật ngôn ngữ. | useLocale |
Middleware (astro-intlayer/middleware)
Nhập (Import):
Sao chép mã vào clipboard
Mở bảng trong một cửa sổ bật lên để xem toàn bộ nội dung dữ liệu một cách rõ ràng
| Bản xuất | Kiểu | Mô tả | Tài liệu liên quan |
|---|---|---|---|
onRequest | MiddlewareHandler | Middleware của Astro phát hiện ngôn ngữ của yêu cầu và gán vào Astro.locals.intlayer. Được đăng ký tự động bởi intlayer() hoặc được nhập thủ công. | onRequest |
Tiện ích (Utilities)
Nhập (Import):
Sao chép mã vào clipboard
Mở bảng trong một cửa sổ bật lên để xem toàn bộ nội dung dữ liệu một cách rõ ràng
| Hàm | Mô tả | Tài liệu liên quan |
|---|---|---|
getIntlayerLocals | Hàm hỗ trợ lấy đối tượng IntlayerLocals hiện tại từ phạm vi lưu trữ yêu cầu bên ngoài Astro.locals. | - |
Tiện ích Client (astro-intlayer/client)
Nhập (Import):
Sao chép mã vào clipboard
Khi được nhập trong trình duyệt hoặc bên trong thẻ <script> của client, astro-intlayer tự động ánh xạ tới astro-intlayer/client (được cung cấp bởi vanilla-intlayer), cung cấp các hàm lấy từ điển phía client, bộ lắng nghe store và các công cụ lưu trữ ngôn ngữ.
Trình định dạng (astro-intlayer/format)
Nhập (Import):
Sao chép mã vào clipboard
Mở bảng trong một cửa sổ bật lên để xem toàn bộ nội dung dữ liệu một cách rõ ràng
| Hook | Mô tả |
|---|---|
useIntl | Trả về một phiên bản Intl gắn liền với ngôn ngữ yêu cầu hoặc client với khả năng lưu vào bộ nhớ cache. |
useDate | Trả về hàm định dạng ngày tháng được liên kết sẵn với ngôn ngữ hiện tại (Intl.DateTimeFormat). |
useNumber | Trả về hàm định dạng số được liên kết sẵn với ngôn ngữ hiện tại (Intl.NumberFormat). |
useCurrency | Trả về hàm định dạng tiền tệ được liên kết sẵn với ngôn ngữ hiện tại. |
usePercentage | Trả về hàm định dạng phần trăm được liên kết sẵn với ngôn ngữ hiện tại. |
useRelativeTime | Trả về hàm định dạng thời gian tương đối được liên kết sẵn với ngôn ngữ hiện tại (Intl.RelativeTimeFormat). |
useList | Trả về hàm định dạng danh sách được liên kết sẵn với ngôn ngữ hiện tại (Intl.ListFormat). |
useUnit | Trả về hàm định dạng đơn vị đo lường được liên kết sẵn với ngôn ngữ hiện tại. |
useCompact | Trả về hàm định dạng số thu gọn được liên kết sẵn với ngôn ngữ hiện tại (ví dụ: 1.5K). |
Tiện ích HTML (astro-intlayer/html)
Nhập (Import):
Sao chép mã vào clipboard
Mở bảng trong một cửa sổ bật lên để xem toàn bộ nội dung dữ liệu một cách rõ ràng
| Bản xuất | Kiểu | Mô tả |
|---|---|---|
renderHTML | Function | Hàm tiện ích độc lập để render các nút HTML. |
useHTML | Hook | Hook để lấy context nhà cung cấp HTML và cấu hình. |
useHTMLRenderer | Hook | Hook để lấy hàm render HTML đã được cấu hình trước. |
Tiện ích Markdown (astro-intlayer/markdown)
Nhập (Import):
Sao chép mã vào clipboard
Mở bảng trong một cửa sổ bật lên để xem toàn bộ nội dung dữ liệu một cách rõ ràng
| Bản xuất | Kiểu | Mô tả |
|---|---|---|
compileMarkdown | Function | Biên dịch chuỗi markdown thành cấu trúc phân tích cú pháp. |
renderMarkdown | Function | Render nội dung markdown thành các nút đầu ra. |
parseMarkdown | Function | Phân tích cú pháp nội dung markdown thô thành AST. |
useMarkdown | Hook | Hook để lấy context nhà cung cấp markdown. |
useMarkdownRenderer | Hook | Hook để lấy hàm render Markdown đã được cấu hình trước. |
Kiểu dữ liệu (Types)
Nhập (Import):
Sao chép mã vào clipboard
Mở bảng trong một cửa sổ bật lên để xem toàn bộ nội dung dữ liệu một cách rõ ràng
| Kiểu | Mô tả |
|---|---|
IntlayerLocals | Đối tượng được gắn vào Astro.locals.intlayer chứa locale, defaultLocale và availableLocales. |
UseLocaleProps | Các thuộc tính cấu hình tùy chọn được chấp nhận bởi useLocale(). |
UseLocaleResult | Kiểu trả về của useLocale(), cung cấp các thuộc tính ngôn ngữ và các phương thức cập nhật. |
