الفرق بين المراجعتين ل"Next.js/font optimization"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE:تحسين خطوط الكتابة في Next.js}}</noinclude>
 
<noinclude>{{DISPLAYTITLE:تحسين خطوط الكتابة في Next.js}}</noinclude>
تمتلك Next.js ابتداءً من الإصدار 10.2 آلية مدمجة لتحسين خطوط الكتابة، إذ تُدرج تلقائيًا تنسيقات سطرية لخطوط الكتابة أثناء بناء التطبيق موفّرة جولة إضافية لإحضار تصريحات خطوط الكتابة. وهذا ما سيحسن المؤشرات الحيوية للويب مثل [https://web.dev/fcp/ أولى عناصر المحتوى المرئية] First Contentful Paint واختصارًا (FCP) و[https://vercel.com/blog/core-web-vitals#largest-contentful-paint عناصر المحتوى المرئية الأضخم حجمًا] Largest Contentful Paint واختصارًا (LCP). إليك مثالًا:<syntaxhighlight lang="javascript">
+
تمتلك Next.js ابتداءً من الإصدار 10.2 آلية مدمجة لتحسين خطوط الكتابة، إذ تُدرج تلقائيًا تنسيقات سطرية لخطوط الكتابة أثناء بناء التطبيق موفّرة جولة إضافية لإحضار تصريحات خطوط الكتابة. وهذا ما سيحسن المؤشرات الحيوية للويب مثل [https://web.dev/fcp/ أولى عناصر المحتوى المرئية] First Contentful Paint واختصارًا FCP و[https://vercel.com/blog/core-web-vitals#largest-contentful-paint عناصر المحتوى المرئية الأضخم حجمًا] Largest Contentful Paint واختصارًا LCP وإليك مثالًا:<syntaxhighlight lang="javascript">
 
// قبل
 
// قبل
 
<link
 
<link
سطر 40: سطر 40:
  
 
export default MyDocument
 
export default MyDocument
</syntaxhighlight>لا ننصح بإضافة خطوط من خلال الترويسة لأنها ستُطبق الخطوط على صفحة محددة فقط، ولن تعمل مع معمارية مبنية على تدفق البيانات. تدعم آلية تحسين الخطوط خطوط Google وخطوط Typekit، وستدعم قريبًا خطوطًا أخرى. كما يجري التخطيط لإضافة إمكانية التحكم بأساليب التحميل وقيم الخاصية <code>font-display</code>.<blockquote>'''ملاحظة''': لا تدعم آلية تحسين خطوط الكتابة حاليًا ميزة الاستضافة الذاتية للخطوط self-hosted fonts</blockquote>
+
</syntaxhighlight>لا ننصح بإضافة خطوط من خلال الترويسة <code>next/head</code> لأنها ستُطبق الخطوط على صفحة محددة فقط، ولن تعمل مع معمارية مبنية على تدفق البيانات streaming architecture. تدعم آلية تحسين الخطوط خطوط Google وخطوط Typekit، وستدعم قريبًا خطوطًا أخرى. كما يجري التخطيط لإضافة إمكانية التحكم بأساليب التحميل وقيم الخاصية <code>font-display</code>.
 +
 
 +
'''ملاحظة''': لا تدعم آلية تحسين خطوط الكتابة حاليًا ميزة الاستضافة الذاتية للخطوط self-hosted fonts.
  
 
== تعطيل ميزة تحسين خطوط الكتابة في Next.js ==
 
== تعطيل ميزة تحسين خطوط الكتابة في Next.js ==
سطر 50: سطر 52:
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
== انظر أيضًا ==
 +
 +
* [[Next.js/custom document|المستندات المخصصة في Next.js باستخدام المكوّن <code>Document</code>]]
  
 
== المصادر ==
 
== المصادر ==
  
 
* صفحة [https://nextjs.org/docs/basic-features/font-optimization Font Optimization] من توثيق Next.js الرسمي
 
* صفحة [https://nextjs.org/docs/basic-features/font-optimization Font Optimization] من توثيق Next.js الرسمي

مراجعة 15:59، 2 أغسطس 2022

تمتلك Next.js ابتداءً من الإصدار 10.2 آلية مدمجة لتحسين خطوط الكتابة، إذ تُدرج تلقائيًا تنسيقات سطرية لخطوط الكتابة أثناء بناء التطبيق موفّرة جولة إضافية لإحضار تصريحات خطوط الكتابة. وهذا ما سيحسن المؤشرات الحيوية للويب مثل أولى عناصر المحتوى المرئية First Contentful Paint واختصارًا FCP وعناصر المحتوى المرئية الأضخم حجمًا Largest Contentful Paint واختصارًا LCP وإليك مثالًا:

// قبل
<link
  href="https://fonts.googleapis.com/css2?family=Inter&display=optional"
  rel="stylesheet"
/>

// بعد
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<style data-href="https://fonts.googleapis.com/css2?family=Inter&display=optional">
  @font-face{font-family:'Inter';font-style:normal...
</style>

استخدام خطوط الكتابة في Next.js

لإضافة خط كتابة لمحتوى ويب في تطبيق، أضف الخط إلى مستند مخصص:

// pages/_document.js

import Document, { Html, Head, Main, NextScript } from 'next/document'

class MyDocument extends Document {
  render() {
    return (
      <Html>
        <Head>
          <link
            href="https://fonts.googleapis.com/css2?family=Inter&display=optional"
            rel="stylesheet"
          />
        </Head>
        <body>
          <Main />
          <NextScript />
        </body>
      </Html>
    )
  }
}

export default MyDocument

لا ننصح بإضافة خطوط من خلال الترويسة next/head لأنها ستُطبق الخطوط على صفحة محددة فقط، ولن تعمل مع معمارية مبنية على تدفق البيانات streaming architecture. تدعم آلية تحسين الخطوط خطوط Google وخطوط Typekit، وستدعم قريبًا خطوطًا أخرى. كما يجري التخطيط لإضافة إمكانية التحكم بأساليب التحميل وقيم الخاصية font-display.

ملاحظة: لا تدعم آلية تحسين خطوط الكتابة حاليًا ميزة الاستضافة الذاتية للخطوط self-hosted fonts.

تعطيل ميزة تحسين خطوط الكتابة في Next.js

إن لم تشأ أن تُحسّن Next.js خطوط الكتابة التي تستخدمها، يمكنك إلغاء ذلك كالتالي:

// next.config.js

module.exports = {
  optimizeFonts: false,
}

انظر أيضًا

المصادر