Astro 4.15 | Astro

Astro 4.15 اکنون در دسترس است! این نسخه Astro Actions را تثبیت می کند، راه حل ما برای عملکردهای Backend کاملاً ایمن. همچنین شامل: پشتیبانی از ریموت های libSQL در Astro DB، گزینه انتظار جدید برای client:idle، و بیشتر.
این نسخه شامل نکات برجسته زیر است:
برای ارتقاء یک پروژه موجود، از خودکار استفاده کنید @astrojs/upgrade ابزار CLI. از طرف دیگر، می توانید با اجرای دستور ارتقاء برای مدیر بسته خود، به صورت دستی ارتقا دهید:
pnpm upgrade astro --latest
yarn upgrade astro --latest
پایدار: اقدامات Astro
Astro Actions دیگر آزمایشی نیست و آماده کمک به ساخت بکاند بعدی شماست.
کنشها استخراج دادههای ایمن، تجزیه JSON و اعتبارسنجی ورودی را برای شما انجام میدهند. این به طور چشمگیری مقدار الگوهای مورد نیاز را در مقایسه با استفاده از نقطه پایانی API کاهش می دهد.
export const POST = ({ request }) => {
const contentType = request.headers.get('Content-Type');
if (contentType !== 'application/json') return new Response('Unsupported body', { status: 415 });
const json = await request.json();
const input = z.object({ email: z.string().email() }).safeParse(json);
if (!input.success) return new Response(JSON.stringify(input.error), { status: 400 });
input: z.object({ email: z.string().email() }),
handler: ({ name }) => { /* ... */ },
اقدامات را می توان از اجزای سمت سرویس گیرنده و فرم های HTML فراخوانی کرد. این به شما انعطافپذیری میدهد تا برنامهها را با استفاده از هر فناوری مانند React، Svelte، تگهای اسکریپت یا فقط اجزای ساده Astro بسازید. این مثال یک اقدام خبرنامه را فراخوانی می کند و نتیجه را با استفاده از یک جزء Astro ارائه می کند:
import { actions } from 'astro:actions';
const result = Astro.getActionResult(actions.newsletter);
{result && !result.error && p>Thanks for signing up!p>}
form method="POST" action={actions.newsletter}>
input type="email" name="email" />
برای اطلاعات بیشتر و نمونههای استفاده، راهنمای اقدام جدید ما را ببینید.
بازنویسی در i18n بازگشتی
یک گزینه جدید به مسیریابی بین المللی (i18n) اضافه شده است که امکان کنترل بیشتر بر نحوه رسیدگی به عقبنشینیها را فراهم میکند. اکنون می توانید تعیین کنید که آیا بازگشت مجدد منجر به بازنویسی شود (الف 200 پاسخ از سرور) یا تغییر مسیر، تنظیم پیش فرض فعلی.
سیستم بازگشتی در i18n به شما این امکان را میدهد تا زمانی که آن محتوا در محلی کاربر در دسترس نیست، مشخص کنید که از کدام محتوا برای محلی استفاده کنید. به عنوان مثال، پیکربندی شما ممکن است به شکل زیر باشد:
import { defineConfig } from "astro/config"
export default defineConfig({
locales: ["es", "en", "fr"],
برای کسب اطلاعات بیشتر در مورد این ویژگی جدید، به مستندات به روز شده ما برای مدیریت مجدد در i18n مراجعه کنید.
ریموت های libSQL در Astro DB
اکنون می توانید یک نمونه سرور libSQL را به عنوان راه دور برای تعیین کنید @astrojs/db. این به شما این امکان را می دهد که سرور libSQL خود را به عنوان جایگزینی برای استفاده از Astro DB با Astro Studio میزبانی کنید. این گزینه با هر پروتکل libSQL پشتیبانی شده کار می کند.
برای استفاده از این تابع، متغیرهای محیطی زیر را تنظیم کنید:
ASTRO_DB_REMOTE_URL: URL برای اتصال به سرور libSQL شما.ASTRO_DB_APP_TOKEN: نشانه احراز هویت سرور libSQL شما.
فعال کردن این ویژگی به شما امکان می دهد در محیط تولید خود به سرور libSQL متصل شوید و همچنین به شما امکان می دهد از دستورات Astro DB Deployment and Push (Migration) با نمونه libSQL استفاده کنید. با تشکر از Fryuni برای این کمک شگفت انگیز!
برای اطلاعات بیشتر در مورد استفاده از سرورهای libSQL در Astro DB، از راهنمای Astro DB ما دیدن کنید.
گزینه منتظر ماندن client:idle
را client:idle برای بارگذاری Astro Island زمانی که CPU کاربر بیکار است (که توسط جاوا اسکریپت دیگر اجرا نمی شود) استفاده می شود. در زیر هود، این تابع به عملکرد مرورگر requestIdleCallback متکی است.
در Astro 4.15 اکنون می توانید a را مشخص کنید timeout خاصیتی که باعث هیدراتاسیون می شود تا اطمینان حاصل شود که عنصر شما در یک دوره زمانی مشخص تعاملی است. این برای افزودن اولویت به مؤلفه ای که ممکن است با سایر مؤلفه های غیرفعال رقابت کند مفید است.
{/* Component loads after a maximum wait of 500ms */}
Counter id="client-idle-timeout" {...someProps} client:idle={{ timeout: 500 }}>
h1>Hello, client:idle={'{{timeout: 500}}'}!h1>
با تشکر از ph1p برای این مشارکت.
کمک کننده ها را با ViewTransionions تعویض کنید
در Astro روتر UX یک برنامه تک صفحه ای (SPA) را به شما می دهد در حالی که DX برنامه چند صفحه ای Astro (MPA) را حفظ می کند. این کار را با بازیابی صفحات در مسیریابی و تعویض محتوا برای مسیریابی سمت مشتری انجام می دهد. در برخی موارد، ممکن است بخواهید کنترل بیشتری بر نحوه عملکرد صرافی داشته باشید، که می تواند با تعویض صرافی در آن انجام شود astro:before-swap یک رویداد
در Astro 4.15، توابع تعویض داخلی اکنون از آن صادر می شوند astro:transitions/client. این کمکها به شما امکان میدهند از بخشهایی از کارهایی که Astro به صورت پیشفرض انجام میدهد استفاده کنید و منطق سفارشی خود را در این بین اضافه کنید.
import { swapFunctions } from 'astro:transitions/client';
document.addEventListener('astro:before-swap', (e) => {
e.swap = () => swapMainOnly(e.newDocument);
function swapMainOnly(doc: Document) {
swapFunctions.deselectScripts(doc);
swapFunctions.swapRootAttributes(doc);
swapFunctions.swapHeadElements(doc);
const restoreFocusFunction = swapFunctions.saveFocus();
const newMain = doc.querySelector('main');
const oldMain = document.querySelector('main');
if (newMain && oldMain) {
swapFunctions.swapBodyElement(newMain, oldMain);
swapFunctions.swapBodyElement(doc.body, document.body);


