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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ صفحة فارغة)
 
سطر 1: سطر 1:
  
 +
= الواجهة البرمجية للمكوّن next/amp في Next.js =
 +
<blockquote>يُعد دعم صفحات AMP أحد الميزات المتقدمة في Next.js، ويمكن الاطلاع أكثر عليها في صفحة [[Next.js/amp support|توثيق AMP]]</blockquote>لتمكين دعم صفحات AMP أضف الإعداد التالي إلى صفحتك:<syntaxhighlight lang="javascript">
 +
export const config = { amp: true }
 +
</syntaxhighlight>يقبل الإعداد <code>amp</code> القيمتين التاليتين:
 +
 +
* <code>true</code>: ستكون الصفحة عندها AMP فقط.
 +
* <code>hybrid</code>: سيكون للصفحة نسختان الأولى AMP والثانية HTML.
 +
 +
== صفحة AMP الأولى ==
 +
إلق نظرة على المثال التالي:<syntaxhighlight lang="javascript">
 +
export const config = { amp: true }
 +
 +
function About(props) {
 +
  return <h3>My AMP About Page!</h3>
 +
}
 +
 +
export default About
 +
</syntaxhighlight>إن الصفحة في المثال السابق هي صفحة AMP فقط ويعني ذلك:
 +
 +
* لا تمتلك الصفحة شيفرة تشغيل Next.js أو React.
 +
* الصفحة محسّنة تلقائيًا من خلال محسّن AMP المدمج الذي يطبق نفس التحويلات عندما تُخزّن صفحة AMP مؤقتًا (مما يحسن الأداء بنسبة 42%).
 +
* للصفحة نسخة يمكن للمستخدم الوصول إليها (محسّنة) ونسخة يمكن فهرستها من قبل محركات البحث (غير محسّنة)
 +
 +
== صفحات AMP الهجينة ==
 +
ألق نظرة على المثال التالي:<syntaxhighlight lang="javascript">
 +
import { useAmp } from 'next/amp'
 +
 +
export const config = { amp: 'hybrid' }
 +
 +
function About(props) {
 +
  const isAmp = useAmp()
 +
 +
  return (
 +
    <div>
 +
      <h3>My AMP About Page!</h3>
 +
      {isAmp ? (
 +
        <amp-img
 +
          width="300"
 +
          height="300"
 +
          src="/my-img.jpg"
 +
          alt="a cool image"
 +
          layout="responsive"
 +
        />
 +
      ) : (
 +
        <img width="300" height="300" src="/my-img.jpg" alt="a cool image" />
 +
      )}
 +
    </div>
 +
  )
 +
}
 +
 +
export default About
 +
</syntaxhighlight>إن الصفحة في المثال السابق هي صفحة AMP هجينة ويعني ذلك:
 +
 +
* تُصيَّر الصفحة كصفحة HTML تقليدية (سلوك افتراضي) وكصفحةAMP HTML (بإضافة اللاحقة <code>amp=1?</code> إلى عنوان URL)
 +
 +
* لصفحة AMP نسخة واحدة محسّنة بواسطة محسّن AMP، لهذا لا يمكن فهرستها في محركات البحث.
 +
 +
تَستخدم الصفحة <code>useAmp</code> للتمييز بين النمطين السابقين، وهو خطاف يعيد القيمة <code>true</code> إن كانت الصفحة AMP و <code>false</code> إن كانت غير ذلك.
 +
 +
== المصادر ==
 +
 +
* الصفحة [https://nextjs.org/docs/api-reference/next/amp Next/amp] من توثيق Next.js الرسمي.

مراجعة 14:44، 9 يوليو 2022

الواجهة البرمجية للمكوّن next/amp في Next.js

يُعد دعم صفحات AMP أحد الميزات المتقدمة في Next.js، ويمكن الاطلاع أكثر عليها في صفحة توثيق AMP

لتمكين دعم صفحات AMP أضف الإعداد التالي إلى صفحتك:

export const config = { amp: true }

يقبل الإعداد amp القيمتين التاليتين:

  • true: ستكون الصفحة عندها AMP فقط.
  • hybrid: سيكون للصفحة نسختان الأولى AMP والثانية HTML.

صفحة AMP الأولى

إلق نظرة على المثال التالي:

export const config = { amp: true }

function About(props) {
  return <h3>My AMP About Page!</h3>
}

export default About

إن الصفحة في المثال السابق هي صفحة AMP فقط ويعني ذلك:

  • لا تمتلك الصفحة شيفرة تشغيل Next.js أو React.
  • الصفحة محسّنة تلقائيًا من خلال محسّن AMP المدمج الذي يطبق نفس التحويلات عندما تُخزّن صفحة AMP مؤقتًا (مما يحسن الأداء بنسبة 42%).
  • للصفحة نسخة يمكن للمستخدم الوصول إليها (محسّنة) ونسخة يمكن فهرستها من قبل محركات البحث (غير محسّنة)

صفحات AMP الهجينة

ألق نظرة على المثال التالي:

import { useAmp } from 'next/amp'

export const config = { amp: 'hybrid' }

function About(props) {
  const isAmp = useAmp()

  return (
    <div>
      <h3>My AMP About Page!</h3>
      {isAmp ? (
        <amp-img
          width="300"
          height="300"
          src="/my-img.jpg"
          alt="a cool image"
          layout="responsive"
        />
      ) : (
        <img width="300" height="300" src="/my-img.jpg" alt="a cool image" />
      )}
    </div>
  )
}

export default About

إن الصفحة في المثال السابق هي صفحة AMP هجينة ويعني ذلك:

  • تُصيَّر الصفحة كصفحة HTML تقليدية (سلوك افتراضي) وكصفحةAMP HTML (بإضافة اللاحقة amp=1? إلى عنوان URL)
  • لصفحة AMP نسخة واحدة محسّنة بواسطة محسّن AMP، لهذا لا يمكن فهرستها في محركات البحث.

تَستخدم الصفحة useAmp للتمييز بين النمطين السابقين، وهو خطاف يعيد القيمة true إن كانت الصفحة AMP و false إن كانت غير ذلك.

المصادر

  • الصفحة Next/amp من توثيق Next.js الرسمي.