محتوى الإدراج / الإدراج في Intlayer

كيف يعمل الإدراج

في Intlayer، يتم تحقيق محتوى الإدراج من خلال دالة insertion، التي تحدد حقول العناصر النائبة في النص (مثل {{name}} أو {{age}}) والتي يمكن استبدالها ديناميكيًا أثناء وقت التشغيل. تتيح لك هذه الطريقة إنشاء سلاسل نصية مرنة تشبه القوالب حيث يتم تحديد أجزاء معينة من المحتوى بواسطة البيانات التي يتم تمريرها من تطبيقك.

عند التكامل مع React Intlayer أو Next Intlayer، يمكنك ببساطة توفير كائن البيانات الذي يحتوي على القيم لكل عنصر نائب، وسيقوم Intlayer تلقائيًا بعرض المحتوى مع استبدال العناصر النائبة.

إعداد محتوى الإدراج

لإعداد محتوى الإدراج في مشروع Intlayer الخاص بك، أنشئ وحدة محتوى تتضمن تعريفات الإدراج الخاصة بك. فيما يلي أمثلة بصيغ مختلفة.

import { insert, type Dictionary } from "intlayer";const myInsertionContent = {  key: "my_key",  content: {    myInsertion: insert("مرحبًا، اسمي {{name}} وعمري {{age}} سنة!"),  },} satisfies Dictionary;export default myInsertionContent;

استخدام محتوى الإدراج مع React Intlayer

لاستخدام محتوى الإدراج داخل مكون React، قم باستيراد واستخدام الخطاف useIntlayer من حزمة react-intlayer. يقوم هذا الخطاف باسترجاع المحتوى للمفتاح المحدد ويسمح لك بتمرير كائن يربط كل عنصر نائب في المحتوى بالقيمة التي ترغب في عرضها.

import type { FC } from "react";import { useIntlayer } from "react-intlayer";const InsertionComponent: FC = () => {  const { myInsertion } = useIntlayer("my_key");  return (    <div>      <p>        {          /* الإخراج: "مرحبًا، اسمي جون وعمري 30 سنة!" */          myInsertion({ name: "John", age: "30" })        }      </p>      <p>        {          /* يمكنك إعادة استخدام نفس الإدراج بقيم مختلفة */          myInsertion({ name: "Alice", age: "25" })        }      </p>    </div>  );};export default InsertionComponent;

الموارد الإضافية

لمزيد من المعلومات التفصيلية حول التكوين والاستخدام، يرجى الرجوع إلى الموارد التالية:

• توثيق Intlayer CLI
• توثيق React Intlayer
• توثيق Next Intlayer

تقدم هذه الموارد رؤى إضافية حول إعداد واستخدام Intlayer عبر بيئات وأُطُر عمل مختلفة.

تاريخ الوثيقة

• 5.5.10 - 2025-06-29: بداية التاريخ