الفرق بين المراجعتين ل"Next.js/static file serving"
< Next.js
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق) |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:تخديم الملفات الساكنة في Next.js}}</noinclude> | <noinclude>{{DISPLAYTITLE:تخديم الملفات الساكنة في Next.js}}</noinclude> | ||
| − | تستطيع Next.js تخديم الملفات الساكنة مثل الصور التي توجد في المجلد <code>public</code> ضمن المجلد الجذري. يمكن الإشارة عندها إلى تلك الملفات باسم الملف يسبقه عنوان URL الجذري | + | تستطيع Next.js تخديم الملفات الساكنة static files أي الملفات الثابتة التي لا تتغير مثل الصور التي توجد في المجلد <code>public</code> ضمن المجلد الجذري. يمكن الإشارة عندها إلى تلك الملفات باسم الملف يسبقه عنوان URL الجذري <code>/</code>. |
فلو أضفت الصورة <code>me.png</code> مثلًا إلى المجلد <code>public</code>، ستتمكن من الوصول إليها من خلال الشيفرة التالية:<syntaxhighlight lang="javascript"> | فلو أضفت الصورة <code>me.png</code> مثلًا إلى المجلد <code>public</code>، ستتمكن من الوصول إليها من خلال الشيفرة التالية:<syntaxhighlight lang="javascript"> | ||
| سطر 10: | سطر 10: | ||
export default Avatar | export default Avatar | ||
| − | </syntaxhighlight> | + | </syntaxhighlight> |
| − | + | * ولهذا المجلد فائدته في احتواء ملفات أخرى مثل <code>robots.txt</code> و <code>favicon.ico</code> وتقنية Google للتحقق من المواقع Google Site Verification وغيرها من الملفات الساكنة بما فيها ملفات <code>html.</code>. | |
| − | ''' | + | '''ملاحظات''': |
| − | + | * يتطلب استخدام المكتبة <code>next/image</code> النسخة 10 وما بعدها من Next.js. | |
| − | + | * لا تُسمي المجلد <code>public</code> بأي اسم آخر. فلا يمكن تغيير اسم هذا المجلد وهو المجلد الوحيد الذي يخدّم التطبيق بالملفات الساكنة. | |
| − | + | * تأكد من عدم تسمية أي ملف موجود في المجلد <code>public</code> بنفس اسم ملف موجود في المجلد <code>/pages</code>، [https://nextjs.org/docs/messages/conflicting-public-file-page إذ يسبب ذلك خطأً.] | |
| + | * تخدّم Next.js أثناء بناء التطبيق الأصول assets في المجلد <code>public</code>، لكنها لن تخدم الأصول المتاحة أثناء التنفيذ. ننصح باستخدام خدمات مصدرها طرف آخر مثل [https://aws.amazon.com/s3/ AWS S3] لتوفير ملفات بصورة دائمة. | ||
== المصادر == | == المصادر == | ||
* الصفحة [https://nextjs.org/docs/basic-features/static-file-serving Static file serving] من توثيق Next.js الرسمي. | * الصفحة [https://nextjs.org/docs/basic-features/static-file-serving Static file serving] من توثيق Next.js الرسمي. | ||
مراجعة 16:04، 2 أغسطس 2022
تستطيع Next.js تخديم الملفات الساكنة static files أي الملفات الثابتة التي لا تتغير مثل الصور التي توجد في المجلد public ضمن المجلد الجذري. يمكن الإشارة عندها إلى تلك الملفات باسم الملف يسبقه عنوان URL الجذري /.
فلو أضفت الصورة me.png مثلًا إلى المجلد public، ستتمكن من الوصول إليها من خلال الشيفرة التالية:
import Image from 'next/image'
function Avatar() {
return <Image src="/me.png" alt="me" width="64" height="64" />
}
export default Avatar
- ولهذا المجلد فائدته في احتواء ملفات أخرى مثل
robots.txtوfavicon.icoوتقنية Google للتحقق من المواقع Google Site Verification وغيرها من الملفات الساكنة بما فيها ملفاتhtml..
ملاحظات:
- يتطلب استخدام المكتبة
next/imageالنسخة 10 وما بعدها من Next.js. - لا تُسمي المجلد
publicبأي اسم آخر. فلا يمكن تغيير اسم هذا المجلد وهو المجلد الوحيد الذي يخدّم التطبيق بالملفات الساكنة. - تأكد من عدم تسمية أي ملف موجود في المجلد
publicبنفس اسم ملف موجود في المجلد/pages، إذ يسبب ذلك خطأً. - تخدّم Next.js أثناء بناء التطبيق الأصول assets في المجلد
public، لكنها لن تخدم الأصول المتاحة أثناء التنفيذ. ننصح باستخدام خدمات مصدرها طرف آخر مثل AWS S3 لتوفير ملفات بصورة دائمة.
المصادر
- الصفحة Static file serving من توثيق Next.js الرسمي.