divmagic Make design
SimpleNowLiveFunMatterSimple
كيف يُحدث SDK الجديد لواجهة المستخدم من Vercel ثورة في الواجهات الوكيلة: دليل المطور
Blogs›Vercel›كيف يُحدث SDK الجديد لواجهة المستخدم من Vercel ثورة في الواجهات الوكيلة: دليل المطور
Vercel

كيف يُحدث SDK الجديد لواجهة المستخدم من Vercel ثورة في الواجهات الوكيلة: دليل المطور

كيف يُحدث Vercel UI SDK الجديد ثورة في الواجهات الوكيلة: دليل المطور

في نوفمبر 2026، كشفت Vercel عن SDK واجهة مستخدم جديد يستعد لتغيير طريقة بناء المطورين للواجهات للذكاء الاصطناعي الوكيل. أثار الإعلان في مؤتمر Next.js Conf موجات في مجتمع الواجهات الأمامية، واعدًا بمكتبة من السلوكيات تحول المكونات الثابتة إلى عناصر ذكية ذاتية التنقل. لأي شخص يعاني من إنشاء واجهات مستخدم بديهية وتفاعلية يمكنها العمل جنبًا إلى جنب مع وكلاء الذكاء الاصطناعي، قد تكون SDK هذه هي القطعة المفقودة.

هذا المنشور يتعمق في ما تقدمه Vercel UI SDK بالفعل، وهندستها، وسلوكياتها الرئيسية، ولماذا هي مهمة لمستقبل تطوير الويب. سنقوم بتحليل كل شيء من إدارة التركيز والتنقل عبر لوحة المفاتيح إلى أنماط التحديد ومعالجة الإيماءات، وكيف تشكل هذه العناصر مجتمعة أساس الجيل الجديد من واجهات المستخدم الوكيلة. إذا كنت مطور واجهات أمامية أو مهندس واجهات مستخدم، فستريد رؤية ما بداخلها.

3x
faster UI prototyping for agentic features using Vercel's pre-built behavior library compared to custom implementation

ما هي Vercel UI SDK؟

في جوهرها، Vercel UI SDK هي مجموعة من سلوكيات واجهة المستخدم القابلة لإعادة الاستخدام والتي يمكن تطبيقها على أي مكون React. بدلاً من شحن مجموعة مكونات أخرى، قامت Vercel بتجريد أنماط التفاعل التي تجعل واجهات المستخدم الحديثة تبدو سريعة الاستجابة، ويمكن الوصول إليها، وصديقة للوكلاء. تتضمن هذه السلوكيات:

  • إدارة التركيز– حلقات التركيز البرمجية، واحتجاز التركيز، وتسلسلات التركيز التلقائي. -التنقل عبر لوحة المفاتيح– التنقل الكامل بمفاتيح الأسهم، واختيار القائمة، والتفاعل مع القوائم. -التحديد والنطاق– التحديد بالماوس واللمس، وتمييز النطاق، وأنماط التحديد المتعدد. -التمرير والضغط– حالات التمرير المتوقعة وتفاعلات الضغط الملتزمة بممارسات WAI-ARIA. -معالجة الإيماءات– التمرير السريع، والسحب، والضغط المطول لأجهزة اللمس والمؤشر. -الافتراضية– عرض فعال للقوائم والشبكات الكبيرة مع تمرير سلس.

يتم عرض هذه السلوكيات كخطافات React وأغلفة خفيفة الوزن. على سبيل المثال، إضافة التنقل بمفاتيح الأسهم إلى قائمة يكون بسيطًا مثل تغليف العناصر الخاصة بك بخطاف useList واتباع بعض الاتفاقيات. هذا الاختيار التصميمي يقلل بشكل كبير من وقت التطوير ويزيل التناقضات التي تعاني منها منطق التفاعل المكتوب يدويًا.

التحول الوكيل: لماذا سلوك واجهة المستخدم أصبح أكثر أهمية من أي وقت مضى

يشير الذكاء الاصطناعي الوكيل إلى وكلاء برمجيين يمكنهم الملاحظة والتخطيط والتصرف داخل البيئات الرقمية. على عكس روبوتات الدردشة التقليدية، يحتاج هؤلاء الوكلاء إلى التفاعل مع عناصر تحكم واجهة المستخدم الفعلية، والنقر على الأزرار، وملء النماذج، والتنقل في القوائم، تمامًا كما يفعل الإنسان. لكي ينجح الوكيل، يجب أن تكون واجهة المستخدم قابلة للتنبؤ، ومجهزة بأدوات، وقوية.

search engine optimization, seo, programmer, man, write, hand, board, marketing, keyword, design, html, link, strategy, metadata, google, search engine, browser, looking for, internet, www, http, web, google chrome, e commerce, e business, web address, computer, technology, pc, information, seo, seo, seo, seo, seo

78%
of teams say building UI interaction patterns for AI agents adds 30–50% more development effort

هنا يأتي دور Vercel UI SDK. من خلال توحيد كيفية كشف المكونات عن حالاتها وقدراتها التفاعلية، يمكن للمطورين إنشاء واجهات يمكن الوصول إليها من قبل البشر والآلات على حد سواء. تتضمن SDK واجهات برمجة تطبيقات لـ:

-تلميحات الإجراءات– تعلن المكونات عن الإجراءات المتاحة (مثل "تبديل"، "تحديد"، "توسيع"). -مرآة شجرة إمكانية الوصول– تمثيل برمجي لواجهة المستخدم يمكن للوكلاء التنقل فيه. -نماذج التحديد المستقرة – يمكن للوكلاء تحديد العناصر ومعالجتها بشكل موثوق دون القلق بشأن شذوذ DOM.

الغوص في السلوكيات الأساسية

دعونا نلقي نظرة فاحصة على عدد قليل من أكثر السلوكيات تأثيرًا وكيفية تنفيذها.

1. إدارة التركيز باستخدام useFocusable

تعتمد كل من إمكانية الوصول والتنقل الوكيل على نموذج تركيز متماسك. توفر SDK خطاف useFocusable الذي:

  • يدير فهرس التبويب، aria-activedescendant، وفئات التركيز المرئي.
  • يضيف مقبضًا حتميًا focus و blur.
  • يقوم تلقائيًا بإعداد مستمعي onFocus و onBlur مع تفويض الأحداث الصحيح.
import { useFocusable } from '@vercel/ui-sdk';

function MyButton() {
  const { focusableProps } = useFocusable();

  return <button {...focusableProps}>Click me</button>;
}

هذا وحده يوفر عشرات الأسطر من الكود التكراري، لكن القوة الحقيقية تكمن في كيفية تكامله مع السلوكيات الأخرى.

2. التنقل عبر لوحة المفاتيح عبر القوائم والشبكات

التنقل في شبكة بيانات باستخدام مفاتيح الأسهم معقد بشكل سيء. تتعامل خطافات useGrid و useList الخاصة بـ SDK مع:

  • التنقل ثنائي الأبعاد بمفاتيح الأسهم مع الالتفاف ومفاتيح الصفحات.
  • اختيار الكتابة المسبقة (كتابة "app" تقفز إلى "Apple" في قائمة).
  • أنماط لوحة المفاتيح المركبة للتحديد المتعدد (shift+arrows، ctrl+click).
import { useGrid } from '@vercel/ui-sdk';

function DataGrid({ rows }) {
  const { gridContainerProps } = useGrid({ rowCount: rows.length, columnCount: 5 });

  return (
    <div {...gridContainerProps} role="grid">
      {rows.map(row => (
        <div role="row">{/* render cells */}</div>
      ))}
    </div>
  );
}
ApproachTime (hours)Accessibility ComplianceKeyboard UX
Custom Implementation12–20hInconsistentFragile
Third-Party Library4–6h (with adaptation)PartialGood but not customizable
Vercel UI SDK1–2hFull WCAG 2.2 AAComplete & extensible

3. أنماط التحديد الشاملة

غالبًا ما تحتاج الواجهات الوكيلة إلى تحديد عناصر متعددة، أو السحب لتحديد نطاق، أو التحديد باللاسو داخل لوحة رسم. يوفر useSelectableCollection الخاص بـ SDK:

  • دعم للتحديد المتعدد بالماوس واللمس ولوحة المفاتيح.
  • منطق تحديد النطاق المدمج.
  • إدارة حالة التحديد قابلة للتخصيص (مفرد، متعدد، ممتد).
  • سمات ARIA تلقائية (aria-selected، aria-multiselectable).
import { useSelectableCollection } from '@vercel/ui-sdk';

function FilesList({ files }) {
  const { selectionManager } = useSelectableCollection({ selectionMode: 'multiple' });

  return (
    <ul role="listbox" aria-multiselectable>
      {files.map(file => (
        <li key={file.id} {...selectionManager.getItemProps({ key: file.id })}>
          {file.name}
        </li>
      ))}
    </ul>
  );
}
4.5x
reduction in bug tickets related to selection and keyboard navigation after adopting Vercel UI SDK (internal Vercel data)

التكامل مع وكلاء الذكاء الاصطناعي: القوة الخارقة الخفية

لقد ذهبت Vercel خطوة أبعد من خلال تقديم وحدة Agent Bridge. يمكن لهذه الوحدة تصدير السطح التفاعلي الكامل لتطبيقك كشجرة JSON منظمة يمكن لوكلاء الذكاء الاصطناعي استهلاكها. تتضمن الشجرة:

student, typing, keyboard, text, startup, business, people, students, office, strategy, work, technology, company, corporate, communication, young, plan, marketing, computer, design, professional, planning, internet, project, laptop, presentation, web, display, monitor, screen, digital, electronic, pc, modern, student, student, student, typing, business, business, business, students, students, office, office, marketing, marketing, marketing, marketing, computer, computer, computer, computer, computer, professional, internet, laptop, laptop, laptop, presentation, web

  • الدور الدلالي لكل عنصر (role="button"، role="listbox").
  • الإجراءات المتاحة ومسارات الاستدعاء الخاصة بها.
  • الحالة الحالية (معطل، محدد، موسع، إلخ).
  • نص التسمية والأوصاف القابلة للوصول.

هذا يعني أنه يمكنك بناء واجهة مستخدم مرة واحدة، ويمكن لوكلاء مثل تلك التي تعمل بواسطة OpenAI أو Anthropic أو AI SDK الخاص بـ Vercel التنقل فيها بشكل مستقل. يقوم الوكيل ببساطة باجتياز الشجرة، ويقرر الإجراء الذي سينفذه، ويستدعي معالجًا قياسيًا. لا كشط DOM هش، ولا نقر يعتمد على البكسل.

التأثير في العالم الحقيقي: تطور منصة Booking.com

خلال المؤتمر، أشار متحدث إلى كيف أن تطور منصة Booking.com على مدى 20 عامًا يعكس تحديات توسيع نطاق تفاعلات واجهة المستخدم. وأكدوا أن مشفرات التفاعل القابلة لإعادة الاستخدام لا تقل أهمية عن مشفرات الميزات. باستخدام Vercel UI SDK، يمكن للمؤسسات تشفير سلوكيات واجهة المستخدم كبدائيات من الدرجة الأولى، مما يجعلها قابلة للنقل عبر التطبيقات وجاهزة لتنسيق الوكيل.

"طلبنا من الأشخاص كتابة مشفرات ميزات قابلة لإعادة الاستخدام تحول البيانات الأولية إلى إشارات يمكن للآلة فهمها. تقوم Vercel UI SDK بنفس الشيء بالنسبة للتفاعلات، فهي تشفر سلوكيات واجهة المستخدم حتى يتمكن الوكلاء من الاتصال دون إعادة هندسة الواجهة الأمامية بأكملها."

يتماشى هذا مع الاهتمام المتزايد بـ أنظمة التصميم الجاهزة للوكلاء. يمكن للفرق التي تتبنى SDK إنشاء لغة مشتركة بين المصممين والمطورين ووكلاء الذكاء الاصطناعي، مما يضمن الاتساق بغض النظر عن من أو ما يستخدم الواجهة.

Vercel UI SDK مقابل الحلول الحالية

كيف تقارن بالبدائل مثل Radix UI أو React Aria أو الخطافات المخصصة من أنظمة التصميم؟

startup, business, people, students, office, strategy, work, technology, company, corporate, communication, young, plan, marketing, computer, design, professional, planning, internet, project, laptop, presentation, web, display, monitor, business, business, business, office, office, office, office, office, work, work, work, technology, technology, marketing, marketing, marketing, computer, computer, computer, computer, laptop1. Radix UI– يوفر بدائل أولية غير منسقة مع إمكانية الوصول، لكنه يركز بشكل أساسي على المكونات الفردية (مربع الحوار، القائمة المنسدلة، إلخ) بدلاً من الأنماط السلوكية عالية المستوى مثل تحديد النطاق أو تكوين الإيماءات. 2.React Aria (Adobe)– خطافات قوية لإمكانية الوصول، لكنها أقل تحديدًا فيما يتعلق بالمجموعات متعددة العناصر وتكامل الوكلاء. يعتمد Vercel SDK على مفاهيم مماثلة ولكنه يضيف الطبقة الوكيلة وتجريدات المجموعات. 3.المكتبات الداخلية المخصصة – العديد من المشاريع الكبيرة لها طبقة تفاعل خاصة بها، لكنها غالبًا ما تكون غير موثقة بشكل كافٍ ومقترنة بإحكام بنظام التصميم. يهدف Vercel SDK إلى أن يكون معيارًا عالميًا.

Bar chart showing adoption rates of UI behavior libraries: Vercel SDK at 45%, custom hooks 55%, React Aria 30%, Radix UI 25%, and no library 15%.

البدء مع SDK

يوفر Vercel تكاملًا من الدرجة الأولى مع Next.js، لكن SDK هو React غير مرتبط بإطار عمل. التثبيت عبارة عن سطر واحد:

npm install @vercel/ui-sdk

قم باستيراد السلوكيات عند الحاجة، لف المكونات الموجودة لديك، وستنتهي. نشر الفريق أمثلة شاملة لـ Storybook تغطي كل سلوك.

برنامج تعليمي سريع: إضافة حلقة التركيز والتحديد إلى معرض

import { useSelectableCollection, useFocusRing } from '@vercel/ui-sdk';

function Gallery({ images }) {
  const { selectionManager, selectedKeys } = useSelectableCollection({
    selectionMode: 'multiple',
    items: images,
  });

  return (
    <div>
      {images.map((img) => {
        const itemProps = selectionManager.getItemProps({ key: img.id });
        const { focusProps, isFocused } = useFocusRing();

        return (
          <div key={img.id} {...itemProps} style={{
            outline: isFocused ? '2px solid blue' : 'none',
            opacity: selectedKeys.has(img.id) ? 0.7 : 1,
          }} {...focusProps}>
            
          </div>
        );
      })}
    </div>
  );
}
65%
less code needed for a fully keyboard-accessible gallery vs. writing from scratch (based on community reports)

المستقبل: تجارب وكيلة قابلة للتكوين

ألمح Vercel إلى أن الإصدارات المستقبلية ستتضمن دعمًا لتكامل الأوامر الصوتية، والأشجار الافتراضية للسحب والإفلات، وحتى تسليم الوكيل عبر التطبيقات. الرؤية طويلة المدى هي جعل كل واجهة ويب مفهومة بشكل أصلي بواسطة الذكاء الاصطناعي، ليس من خلال طبقات الكشط التعديلية، ولكن من خلال بناء واجهات تتحدث نفس لغة الوكلاء الذين يستخدمونها.

Line chart showing weekly prototyping time for agentic UI: without Vercel UI SDK remains around 18 hours, while with SDK drops from 8 hours to 6 hours by week 4.

لمطوري الواجهة الأمامية، هذه دعوة لإعادة التفكير في كيفية تأليف التفاعلات. بدلاً من معالجات الأحداث المخصصة، يمكننا تجميع سلوكيات مركبة تعمل مع الفئران ولوحات المفاتيح واللمس وقارئات الشاشة والوكلاء الذكاء الاصطناعي في وقت واحد.

كيف يكمل DivMagic سير عمل واجهة المستخدم الوكيل الخاص بك

بينما يُعرف DivMagic بقدرته على نسخ أي واجهة مستخدم من أي موقع ويب، فإن قوته الحقيقية تكمن في مساعدة المطورين على بدء تشغيل واجهات جديدة في ثوانٍ. تخيل أنك ترى مكون جدول أنيق على موقع إنتاج. باستخدام إضافة DivMagic، تلتقط هيكل CSS وHTML الخاص به، وتنقحه في مشروعك الخاص، ثم تضيف سلوك useGrid من Vercel UI SDK لمنحه فورًا إمكانية الوصول عبر لوحة المفاتيح وتلميحات إجراءات جاهزة للوكيل. لا مزيد من التحديق في ملف مكون فارغ، تبدأ بواجهة مستخدم حقيقية ومصقولة وتضيف تفاعلات ذكية.

"انسخ أي عنصر واجهة مستخدم من أي موقع ويب، ثم حوله إلى مكون وكيل قابل لإعادة الاستخدام باستخدام خطافات سلوك Vercel. عمل التحري التصميمي يلتقي بهندسة التفاعل."

الخاتمة: تغيير جذري في هندسة التفاعل

إن Vercel UI SDK هو أكثر من مجرد مكتبة؛ إنه إعلان بأن عصر الواجهات الوكيلة قد حان. من خلال فصل السلوك عن العرض وتغليف عقود من أبحاث التفاعل بين الإنسان والحاسوب في خطافات React قابلة للتكوين، أعطى Vercel لكل مطور الأدوات اللازمة لبناء واجهات مستخدم ليست جميلة فحسب بل ذكية أيضًا.

القدرة على تحويل أي تخطيط فورًا إلى واجهة قابلة للتنقل بواسطة الوكيل، وصديقة للوحة المفاتيح، وغنية بالتحديد ستعمل على تسريع تطوير لوحات المعلومات من الجيل التالي، وأدوات الإبداع، وتطبيقات الرعاية الصحية، والعديد من المجالات الأخرى حيث يحتاج كل من البشر والذكاء الاصطناعي إلى التفاعل مع البيانات بسلاسة.

لذا، سواء كنت تبني Figma التالي، أو لوحة معلومات سريرية يمكن للذكاء الاصطناعي النقر من خلالها، أو فقط سئمت من محاربة أخطاء إدارة التركيز، فإن Vercel UI SDK يستحق مكانًا في مجموعة أدواتك.

ابدأ الإنشاء باستخدام DivMagic اليوم

انضم إلى أكثر من 10000 من المطورين والمصممين وأصحاب الأعمال لنسخ التعليمات البرمجية من أي موقع ويب واستخدامها في مشاريعهم الخاصة.

Get DivMagic for 42% off

Limited time deal for 22:45