التخطّي إلى المحتوى
menu palettetanreidark_modetranslate

وضع الألوان

التباين

نظام التصميم

أنظمة المعرض تحاكي أنظمة تصميم أخرى لتُظهر إلى أي مدى يمكن أن يصل Tanrei. إنها أمثلة، وليست تصاميم يدعمها Tanrei.

نسخ الرابطتعديل السمة
palettetanrei

وضع الألوان

التباين

نظام التصميم

أنظمة المعرض تحاكي أنظمة تصميم أخرى لتُظهر إلى أي مدى يمكن أن يصل Tanrei. إنها أمثلة، وليست تصاميم يدعمها Tanrei.

نسخ الرابطتعديل السمة
البدءWebReactSwiftUIJetpack ComposeFlutterReact Nativeالإعدادات الجاهزةنظام التصميم الخاص بكاستخدام Tanrei مع وكلاء الذكاء الاصطناعيالعلامة التجاريةرموز التصميمأنظمة التصميم والتخصيصTheme Studioاللونالطباعةالأيقوناتالشكلالارتفاعالحركةحالات التفاعلالسلوكالتخطيطالحجم والكثافةإمكانية الوصولالكلماترموز الألوانرموز السلّم الطباعيرموز الشكلرموز الارتفاعرموز الحركةرموز الحالةرموز التباعد والقياسالمكوّناتالزرزر الإجراء الرئيسيالزر المقسَّممتوفر في cupertino, m3-likeمجموعة الأزرارزر مع قائمةشريط الأدواتزر النسخخانة الاختيارزر الاختيارمفتاح التبديلالرقاقةقائمة الخياراتشريط التمريرحقل شريط التمريرالتقويمDateTimePickerمجموعة الحقولمجموعة أزرار الاختيارمجموعة خانات الاختيارعنصر الاختيارحقل الاختيارشريط القوائمرفع الملفاتمنتقي الملفات متقدّمساحة الإفلاتRatingحقل إدخال النص متقدّمحقل النصحقل الرقاقاتالحقلمربع التحرير والسرد متقدّمحقل التحرير والسردحقل إدخال العدد متقدّمحقل العددحقل إدخال اللون متقدّمحقل اللونحقل إدخال الرمز لمرة واحدة متقدّمحقل الرمز لمرة واحدةحقل إدخال النص المدمج متقدّممربع كتابة الرسائلالبطاقةالفاصلالطبقة النمطية متقدّممربع الحوارالقائمة (list)صف القائمةاللوحة السفليةاللوحة الجانبيةالعرض الدوّاركتلة الشيفرةالجدولاللوحة المنبثقةالخطواتالأكورديونقائمة الوصفالشكل التوضيحيهيكل التطبيقرأس الصفحةالعرض الشجريالخط الزمنيمعاينة الصورمقبض تغيير الحجمالإطار القابل لتغيير الحجمSplit viewمنطقة التمريرانتقال الحجمالشارةمؤشر التقدمالعدّادعارض الأرقام المتحرّكمؤشر التحميلشريط الإشعار (Snackbar)التلميحاختصار لوحة المفاتيحالوسمالشيفرة المضمَّنةالتنويهالصورة الرمزيةالحالة الفارغةمجموعة الوسومهيكل التحميلعنصر الملفمربع اللونالنص المتحركعلامات التبويبعرض التبويباتشريط التطبيقشريط التنقلدرج التنقلالبحثالرابطالتنقل بين الصفحاتروابط السابق والتاليمؤشر الخطواتمسار التنقلجدول المحتوياتبطاقة الرابطقائمة FABمتوفر في m3-likeالحالةكيف يُبنى Tanreiالمساهمةالترخيص والإسناد
الرئيسيةالمكوّناتانتقال الحجم

انتقال الحجم

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

content_copyعرض بتنسيق Markdown
الفئة
الاحتواء
الرموز
comp.size-transition
المستوى
أساسي

نظرة عامة

Web
tanrei-size-transition
clock_loader_40
SwiftUI
TanreiSizeTransition
radio_button_unchecked
Jetpack Compose
TanreiSizeTransition
radio_button_unchecked
Flutter
TanreiSizeTransition
radio_button_unchecked
React Native
SizeTransition
radio_button_unchecked

مولَّد من docs/status/status.json, specs/size-transition.spec.json

كتلة تتبع فقرتها، وصندوق ضمن السطر يتبع كلمته

التقرير الفصلي جاهز. أُضيفت منذ النسخة السابقة ثلاثة أقسام: التكاليف، والموظفون، وخطة الفصل القادم.

تم الحفظ

انتقال الحجم (size transition) صندوقٌ يتبع حجم ما بداخله: حين يتغيّر حجم المحتوى، ينتقل الصندوق من الحجم الذي يعرضه إلى الحجم الجديد في حركة واحدة، ويتحرك معه ما يليه في التخطيط بدل أن يقفز في إطار واحد. ولا يرسم شيئًا من عنده: لا خلفية، ولا حدودًا، ولا زوايا مستديرة، ولا حشوًا.

الاستخدام

عيّنتا Web و React تعرضان المواصفة الحالية. أما SwiftUI و Compose و Flutter و React Native فمخطَّط لها: لا تقدّم انتقال الحجم بعد.

<tanrei-size-transition>
  <div id="details"></div>
</tanrei-size-transition>
<p>حين تتغيّر التفاصيل يتحرك كل ما تحتها بسلاسة.</p>

<!-- مثبَّت في الأسفل: يكبر نحو الأعلى، ويبقى سطره الأخير في مكانه. -->
<tanrei-size-transition anchor="end">
  <div id="draft"></div>
</tanrei-size-transition>

<script type="module">
  import '@tanrei/web/components/size-transition';
  const box = document.querySelector('tanrei-size-transition');
  box.addEventListener('settle', (event) => console.log(event.detail.height));
  document.querySelector('#details').textContent = longerText; // يتحرك ولا يقفز
</script>
import { SizeTransition } from '@tanrei/react';

<SizeTransition onSettle={(event) => setHeight(event.detail.height)}>
  {expanded ? <FullDetails /> : <Summary />}
</SizeTransition>

<SizeTransition axis="inline">
  <span>{saving ? 'جارٍ الحفظ…' : 'تم الحفظ'}</span>
</SizeTransition>

المواصفات

الحدّ الثابت: start (الافتراضي) و end و center

start: يبقى السطر الأول في مكانه، وتظهر الأسطر الجديدة تحته.

end: يبقى السطر الأخير ملاصقًا لنهاية الصندوق، وتظهر الأسطر الجديدة فوقه.

center: يتحرك كل حدّ بنصف التغيّر.

البنية

البنية

مرسوم فوق نموذج الاختبار block كما ترسمه حزمة الويب.
الجزء الوصف
1 box The size transition itself: a box with no look of its own, laid out where it stands, whose size along its axis is the one that moves. It clips what lies beyond it while it moves.
2 content Whatever the product puts in it, laid out at its own natural size and fixed to the box's anchor edge. It is measured, never scaled or stretched.

الخصائص

الخاصية النوع القيمة الافتراضية الوصف
axis block | inline | both "block" Which of its sizes follows the content. block: its height in a horizontal writing mode (the size across lines); its width is the layout's. inline: its width (the size along a line); its height is the layout's. both: both sizes.
anchor start | end | center "start" Which edge stays still while the box grows or shrinks. start: the block-start edge (the top) for block, the inline-start edge for inline, so that a growing box uncovers what is new below or after and never moves the first line. end: the opposite edges, for a box docked at its container's end that grows upward (a composer above the keyboard). center: both edges move by half.
duration number null How long one change takes, in milliseconds, used as given for every distance. Null, the default, takes the system's answer, which grows with the distance moved (SZT-3). Set it only where one place needs another tempo than every other size transition of the product.
disabled boolean false Makes the box follow its content's size at once, without a motion: for a change the person should not watch (a list replaced by a search's results) or a stretch of time in which the content changes at every frame.

المنافذ

المنفذ الوصف
default The content whose size the box follows. Any content: text, a list, another component.

الأحداث

الحدث الوصف
settle The box's size has come to rest after a change, by a motion or at once: emitted once per change, after the last frame, with the box's new width and height in the platform's layout units. A motion that is turned round or retargeted (SZT-2) emits once, at its final rest.

الحالات

السلوك

متطلبات بصيغة EARS. يُختبر تنفيذ كل منصة مقابل هذه المعرّفات. يُعرض نص المتطلبات كما ورد في ملف المواصفة، بالإنجليزية.

المعرّف المتطلب
SZT-1 WHEN the size transition is first drawn THE size transition SHALL take its content's size along its axis in its first frame, without a motion, as every component draws its first frame at rest (MOT-3); content that arrives or changes before that frame is drawn is part of the first frame.
SZT-2 WHEN its content's size along its axis changes after the first frame THE size transition SHALL move its own size in the layout, at every frame, from the size it shows to the new one, over the duration SZT-3 gives with comp.size-transition.motion.easing, so that what stands after it moves with it; WHEN the content changes again during the motion THE size transition SHALL go on from the size then shown towards the newest size as one motion, never jumping to the old target or restarting from the old size (MOT-2).
SZT-3 WHILE duration is null THE size transition SHALL take the duration of a change from the distance its size moves: comp.size-transition.motion.duration for a distance of up to comp.size-transition.motion.distance-step, plus comp.size-transition.motion.duration-step for each further distance-step begun, and never more than comp.size-transition.motion.duration-max; WHILE duration is a number THE size transition SHALL take that many milliseconds for every distance, 0 meaning at once. The duration of a retargeted motion SHALL be computed from the distance between the size shown and the newest size.
SZT-4 WHILE its size differs from its content's THE size transition SHALL clip what lies beyond its box and keep the content fixed to the edge anchor names, mirrored for inline in a right-to-left layout: WHILE anchor is start a growing box SHALL uncover what is new at its block-end (or inline-end) edge and never move its first line, WHILE anchor is end it SHALL uncover what is new at its start edge, the content moving with its end edge, and WHILE anchor is center both edges SHALL move by half the change.
SZT-5 WHILE it moves THE size transition SHALL scroll nothing — neither itself nor its content nor an ancestor — to bring a part of the content into view, also WHILE an element inside it has focus, and SHALL leave focus, the caret and a selection where they are (MOT-5).
SZT-6 WHEN its content's size changes because the room the layout gives it changed — the window or a pane was resized or turned, the text size changed, the layout direction changed — THE size transition SHALL take the new size at once, so that it never lags behind a person resizing the window; and WHILE a size transition inside its content is moving THE size transition SHALL follow its content at every frame, so that two nested motions move as one and do not compound.
SZT-7 WHERE motion is reduced THE size transition SHALL take every new size at once, as size changes are made where motion is reduced (MOT-6), and SHALL still emit settle once per change.
SZT-8 WHILE disabled is true THE size transition SHALL follow its content's size at once; WHEN disabled becomes true during a motion THE size transition SHALL take the newest size at once and emit settle.
SZT-9 WHILE the size transition is not drawn — hidden, outside a view that is shown, or in an app in the background — THE size transition SHALL take every new size at once, and WHEN it is drawn again it SHALL show its content's size without a motion.
SZT-10 THE size transition SHALL expose nothing of its own to assistive technology — no role, no name, no state — and SHALL NOT be a focus stop: its content is read and reached as if the box were not there, including content that the box clips during a motion.
SZT-11 WHEN its size has come to rest after a change, by a motion or at once, THE size transition SHALL emit settle exactly once, after the last frame, with its new width and height; it SHALL emit nothing WHEN its content changes without changing its size along its axis.
SZT-12 THE size transition SHALL draw nothing of its own — no color, edge, shadow, corner or padding — and SHALL take, on the axes it does not follow, the size its layout gives it; WHILE axis is both it SHALL follow the content's width and height together in one motion of one duration, computed from the larger of the two distances (SZT-3).
SZT-13 THE size transition SHALL take its layout direction from where it is used and SHALL have no direction setting of its own; WHEN axis or anchor names a value it does not define THE size transition SHALL use the default value and in debug builds report the unknown value; WHILE duration is a negative number or not a finite number THE size transition SHALL treat it as null and in debug builds report it.

مطابقة الأسماء بين المنصات

التكافؤ لا يعني واجهات برمجية متطابقة. تعبّر كل منصة عن العقد نفسه بأسلوبها.

المواصفة Web SwiftUI Jetpack Compose Flutter React Native
المكوّن tanrei-size-transition TanreiSizeTransition TanreiSizeTransition TanreiSizeTransition SizeTransition
axis · الخاصية axis axis axis axis axis
anchor · الخاصية anchor anchor anchor anchor anchor
duration · الخاصية duration duration durationMillis duration duration
disabled · الخاصية disabled isDisabled enabled disabled disabled
settle · الحدث settle onSettle onSettle onSettle onSettle
ملاحظات <tanrei-size-transition axis="block" anchor="start">…</tanrei-size-transition>, built on the package's size-motion primitive (AnimatedSize). The shadow root holds a box and, in it, a wrapper around the slot at its natural size. A resize observer of the wrapper sees a change of the content's size after layout and before the frame is painted; the box then moves from the size the last frame drew to the new one in pixels, with a CSS transition, clipped with overflow: clip (never hidden, which lets a focused descendant scroll the box). The box is a flex container that justifies the wrapper to the anchor's edge (flex-start, flex-end, center), so that the content is laid out at its own size and overflows the edge that moves; justification follows the direction, so the inline axis mirrors in right-to-left. interpolate-size: allow-keywords is not used: it is experimental and not Baseline. SZT-6: a change of the window's size, of the box's own inline size (the room it is given, for axis block), of its font size or of its direction is applied at once, as is any change while a size transition in its content carries data-resizing (the host carries it while it moves). settle is a CustomEvent that does not bubble, whose detail is { width, height } in CSS pixels; a run that is retargeted ends with the run that replaced it. duration is a number property, the duration attribute parsed as the tooltip's delays are (an empty attribute is not a number). The host is display: block (axis inline or both: display: inline-block), as large as the box. A container view that measures its content with a geometry reader and animates its frame with withAnimation on the measured size, .clipped(), aligned by anchor; reduced motion from accessibilityReduceMotion. A Box with Modifier.animateContentSize(animationSpec, alignment) and clipToBounds(); enabled is the inverse of disabled. The spec of SZT-3 is computed from the measured distance before each animation. Built on AnimatedSize with alignment from anchor and clipBehavior: Clip.hardEdge; the duration of SZT-3 is set from the size the child reports before the animation starts. A View that measures its child with onLayout and animates its own height or width with Reanimated, overflow: 'hidden' (React Native has no clip distinction).

الرموز

الرمز يشير إلى القيمة المحلولة (فاتح)
--tanrei-comp-size-transition-motion-distance-step sys.space.space800 64px
--tanrei-comp-size-transition-motion-duration sys.motion.role.resize.default 300ms
--tanrei-comp-size-transition-motion-duration-max sys.motion.role.resize.large 400ms
--tanrei-comp-size-transition-motion-duration-step sys.motion.duration.short1 50ms
--tanrei-comp-size-transition-motion-easing sys.motion.easing.spatial cubic-bezier(0.2, 0, 0, 1)

نماذج الاختبار

عروض مرجعية. تلتقط كل المنصات لقطة لكل نموذج بالمعرّف نفسه حتى يمكن مقارنة النتائج.

مولَّد من specs/size-transition.spec.json, tokens/comp/size-transition.tokens.json, design/tokens/

الإرشادات

متى يُستخدم

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

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

ولإظهار قسم كامل أو إخفائه بطلب من الشخص، استخدم الأكورديون: الفتح والإغلاق عمله هو. أما انتقال الحجم فلا يفتح شيئًا ولا يغلقه؛ إنه يتبع ما بداخله فحسب.

كم يستغرق التغيّر

يطول الوقت مع المسافة. في النظام الافتراضي يستغرق التغيّر حتى 64 بكسلًا ‏300 ms، وكل 64 بكسلًا إضافية، أو جزء منها، تضيف 50 ms، بحدّ أقصى 400 ms. فلا يبدو التغيّر الكبير متعجّلًا بجانب الصغير، ولا يُبقي التغيّر البعيد الناس منتظرين. اضبط duration فقط حيث يحتاج موضع واحد إلى إيقاع غير إيقاع سائر انتقالات الحجم في منتجك. ومع 0 يحدث التغيّر فورًا.

اختيار المحور والحدّ الثابت

المحور يُستخدم لـ
Block (الافتراضي) محتوى يتغيّر ارتفاعه: فقرات، وقوائم، وقسم يزيد صفًّا. عرضه هو عرض التخطيط.
Inline تسمية يتغيّر عرضها: كلمة حالة، أو عدد، أو نص زر. عرضه بعرض محتواه.
Both صندوق صغير يتغيّر عرضه وارتفاعه معًا، كشارة تنتقل إلى سطر ثانٍ. يتحرك الاثنان في حركة واحدة.
الحدّ الثابت يُستخدم لـ
Start (الافتراضي) معظم المحتوى. لا يتحرك السطر الأول أبدًا، ويظهر الجديد بعده.
End محتوى مثبَّت في نهاية حاويته، كحقل كتابة الرسالة فوق لوحة المفاتيح. يبقى سطره الأخير حيث هو، ويكبر الصندوق نحو البداية.
Center شيء في وسط مساحته، كتنبيه في منتصف لوحة فارغة.

افعل

  • أحِط بالمحتوى الذي يتغيّر، وبه وحده. انتقال حجم حول صفحة كاملة يحرّك كل شيء دفعة واحدة.
  • استخدم disabled ما دام المحتوى يتغيّر في كل إطار — بينما يسحب الشخص شيئًا داخله مثلًا — ولتغيّر لا حاجة إلى أن يراه الناس، كقائمة تُستبدل بها نتائج بحث.
  • انتظر settle حين تحتاج إلى القياس أو التمرير بعد التغيّر: يصل مرة واحدة، بعد الإطار الأخير.

لا تفعل

  • لا تستخدمه لإظهار الأشياء أو إخفائها بالتلاشي. إنه يحرّك الحجم فقط؛ والتلاشي شأن المحتوى.
  • لا تُحِط بانتقال الحجم مكوّنًا من Tanrei يحرّك حجمه بنفسه.
  • لا تعتمد عليه لإزالة إزاحة التخطيط (layout shift) من مقاييسك. فالمتصفحات ما زالت تحتسب العنصر الذي يتحرك بتغيّر التخطيط. ما يزيله هو القفزة التي يراها الشخص.

إمكانية الوصول

الدور
none (a generic container that exposes nothing of its own)
التسمية
The size transition names nothing and is not named; its content keeps its own names, roles and order.
الحد الأدنى للهدف
تستوفي مساحة اللمس الحد الأدنى لحجم الهدف حتى لو كان الحجم المرئي أصغر. minimum 36px · pointer 36px · spacing 8px · touch 36px

لوحة المفاتيح

المفاتيح الإجراء

ملاحظات

  • It takes no input, so it has no target of its own; its content keeps its own hit areas.
  • A size change is a motion in the sense of WCAG 2.3.3 (animation from interactions): where motion is reduced it happens at once (SZT-7). The opacity of the content is never changed by this component.
  • Content that the box clips while it moves stays in the reading and focus order: a person who tabs into it during the motion reaches it, and nothing scrolls to show it (SZT-5) — the motion ends within comp.size-transition.motion.duration-max.
  • Browsers count an element moved by a layout change as a layout shift unless a person's input preceded it within a short window. Moving what follows over a motion does not remove it from that count; it removes the jump a person sees. Measure layout shift in a product's own pages.

مولَّد من specs/size-transition.spec.json, tokens/sys/measure.tokens.json

ما يتكفل به المكوّن

  • لا يعرض للتقنيات المساعدة شيئًا من عنده: لا دور، ولا اسم، ولا حالة. ولا يكون أبدًا محطة للتركيز. يُقرأ محتواه ويُبلَغ كأن الصندوق غير موجود.
  • المحتوى الذي يقصّه الصندوق أثناء الحركة يبقى في ترتيب القراءة وترتيب التركيز. من يدخل إليه بمفتاح Tab أثناء الحركة يبلغه، وتنتهي الحركة في النظام الافتراضي خلال 400 ms.
  • لا يُمرَّر شيء أثناء الحركة: لا الصندوق، ولا محتواه، ولا الصفحة. ويبقى التركيز ومؤشر الكتابة والتحديد حيث هي.
  • حين يُطلب تقليل الحركة، يحدث كل تغيّر في الحجم فورًا. ويظل settle يصل مرة واحدة لكل تغيّر.
  • تغيّر المساحة التي يعطيه إياها التخطيط — تغيير حجم النافذة، أو حجم النص، أو الاتجاه — يحدث فورًا، فلا يتأخر الصندوق عن شخص يغيّر حجم النافذة.
  • قيم axis أو anchor غير المعروفة، وduration السالبة أو التي ليست عددًا، يُبلَّغ عنها في بنيات التنقيح (debug).

ما عليك فعله

  • أعلِن بنفسك التغيّر المهم، في منطقة حيّة (live region) أو في إشعار سيراه الشخص. انتقال الحجم يحرّك حجمه فقط، ولا يقول شيئًا.
  • حافظ على صحة أسماء المحتوى نفسه وأدواره وترتيبه. انتقال الحجم لا يضيف شيئًا منها.