قائمة معدِّلات الإنشاء

الإجراءات

النطاق: أي
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    flingBehavior: FlingBehavior?
)

تفعيل إيماءات السحب بين مجموعة من القيم المحدّدة مسبقًا

النطاق: أي
<T : Any?> Modifier. anchoredDraggable(
    state: AnchoredDraggableState<T>,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    startDragImmediately: Boolean,
    flingBehavior: FlingBehavior?
)

تم إيقاف هذه الدالة نهائيًا. تمت إزالة startDragImmediately بدون استبدالها.

النطاق: أي
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    reverseDirection: Boolean,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    flingBehavior: FlingBehavior?
)

تفعيل إيماءات السحب بين مجموعة من القيم المحدّدة مسبقًا

النطاق: أي
<T : Any?> Modifier. anchoredDraggable(
    state: AnchoredDraggableState<T>,
    reverseDirection: Boolean,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    startDragImmediately: Boolean,
    flingBehavior: FlingBehavior?
)

تم إيقاف هذه الدالة نهائيًا. تمت إزالة startDragImmediately بدون استبدالها.

النطاق: أي
Modifier.clickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

اضبط المكوّن لتلقّي النقرات من خلال حدث "النقر" الخاص بالإدخال أو تسهيل الاستخدام.

النطاق: أي
Modifier.clickable(
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onClick: () -> Unit
)

اضبط المكوّن لتلقّي النقرات من خلال حدث "النقر" الخاص بالإدخال أو تسهيل الاستخدام.

النطاق: أي
Modifier.combinedClickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onLongClickLabel: String?,
    onLongClick: (() -> Unit)?,
    onDoubleClick: (() -> Unit)?,
    hapticFeedbackEnabled: Boolean,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

اضبط المكوّن لتلقّي النقرات والنقرات المزدوجة والنقرات المطوّلة من خلال حدث "النقر" للإدخال أو تسهيل الاستخدام.

النطاق: أي
Modifier.combinedClickable(
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onLongClickLabel: String?,
    onLongClick: (() -> Unit)?,
    onDoubleClick: (() -> Unit)?,
    hapticFeedbackEnabled: Boolean,
    onClick: () -> Unit
)

اضبط المكوّن لتلقّي النقرات والنقرات المزدوجة والنقرات المطوّلة من خلال حدث "النقر" للإدخال أو تسهيل الاستخدام.

النطاق: أي
Modifier.draggable2D(
    state: Draggable2DState,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    startDragImmediately: Boolean,
    onDragStarted: (startedPosition: Offset) -> Unit,
    onDragStopped: (velocity: Velocity) -> Unit,
    reverseDirection: Boolean
)

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

النطاق: أي
Modifier.draggable(
    state: DraggableState,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    startDragImmediately: Boolean,
    onDragStarted: suspend CoroutineScope.(startedPosition: Offset) -> Unit,
    onDragStopped: suspend CoroutineScope.(velocity: Float) -> Unit,
    reverseDirection: Boolean
)

اضبط إعدادات السحب باللمس لعنصر واجهة المستخدم في Orientation واحد.

النطاق: أي

استخدِم أداة التعديل هذه لتجميع قائمة بعناصر selectable، مثل علامات التبويب أو أزرار الاختيار، معًا لأغراض تسهيل الاستخدام.

النطاق: أي
Modifier.selectable(
    selected: Boolean,
    enabled: Boolean,
    role: Role?,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

اضبط المكوّن ليكون قابلاً للتحديد، عادةً كجزء من مجموعة غير متداخلة، حيث يمكن تحديد عنصر واحد فقط في أي وقت.

النطاق: أي
Modifier.selectable(
    selected: Boolean,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

اضبط المكوّن ليكون قابلاً للتحديد، عادةً كجزء من مجموعة غير متداخلة، حيث يمكن تحديد عنصر واحد فقط في أي وقت.

النطاق: أي
@ExperimentalMaterialApi
<T : Any?> Modifier. swipeable(
    state: SwipeableState<T>,
    anchors: Map<Float, T>,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    interactionSource: MutableInteractionSource?,
    thresholds: (from, to) -> ThresholdConfig,
    resistance: ResistanceConfig?,
    velocityThreshold: Dp
)

تم إيقاف هذه الوظيفة نهائيًا. تم استبدال واجهات برمجة التطبيقات Swipeable في Material بواجهات AnchoredDraggable في Foundation.

النطاق: أي
@ExperimentalWearMaterialApi
<T : Any?> Modifier.swipeable(
    state: SwipeableState<T>,
    anchors: Map<Float, T>,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    interactionSource: MutableInteractionSource?,
    thresholds: (from, to) -> ThresholdConfig,
    resistance: ResistanceConfig?,
    velocityThreshold: Dp
)

تفعيل إيماءات التمرير السريع بين مجموعة من الحالات المحدَّدة مسبقًا

النطاق: أي
Modifier.toggleable(
    value: Boolean,
    enabled: Boolean,
    role: Role?,
    interactionSource: MutableInteractionSource?,
    onValueChange: (Boolean) -> Unit
)

ضبط المكوّن ليكون قابلاً للتبديل من خلال أحداث الإدخال وإمكانية الوصول

النطاق: أي
Modifier.toggleable(
    value: Boolean,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onValueChange: (Boolean) -> Unit
)

اضبط المكوّن ليكون قابلاً للتبديل من خلال أحداث الإدخال وإمكانية الوصول.

النطاق: أي
Modifier.triStateToggleable(
    state: ToggleableState,
    enabled: Boolean,
    role: Role?,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

اضبط المكوّن ليكون قابلاً للتبديل من خلال أحداث الإدخال وتسهيل الاستخدام بثلاث حالات: "مفعّل" و"غير مفعّل" و"غير محدّد".

النطاق: أي
Modifier.triStateToggleable(
    state: ToggleableState,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

اضبط المكوّن ليكون قابلاً للتبديل من خلال أحداث الإدخال وتسهيل الاستخدام بثلاث حالات: "مفعّل" و"غير مفعّل" و"غير محدّد".

النطاق: PaneScaffoldScope
Modifier.paneExpansionDraggable(
    state: PaneExpansionState,
    minTouchTargetSize: Dp,
    interactionSource: MutableInteractionSource,
    semanticsProperties: (SemanticsPropertyReceiver.() -> Unit)?
)

المعدِّل الذي يجب تطبيقه على عنصر قابل للإنشاء في مقبض السحب حتى يمكن سحب مقبض السحب والتعامل مع PaneExpansionState المقدَّم بشكل صحيح.

المحاذاة

النطاق: RowScope

محاذاة العنصر عموديًا ضمن Row

النطاق: RowScope
Modifier.alignBy(alignmentLineBlock: (Measured) -> Int)

يجب وضع العنصر عموديًا بحيث يتطابق خط المحاذاة للمحتوى الذي تم تحديده بواسطة alignmentLineBlock مع العناصر الشقيقة التي تم ضبطها أيضًا على alignBy.

النطاق: RowScope

ضَع العنصر عموديًا بحيث تتم محاذاة alignmentLine مع العناصر الشقيقة التي تم ضبطها أيضًا على alignBy.

النطاق: RowScope

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

النطاق: ColumnScope

محاذاة العنصر أفقيًا ضمن Column

النطاق: ColumnScope
Modifier.alignBy(alignmentLineBlock: (Measured) -> Int)

ضَع العنصر أفقيًا بحيث يتوافق خط المحاذاة للمحتوى الذي يحدّده alignmentLineBlock مع العناصر الشقيقة التي تم ضبطها أيضًا على alignBy.

النطاق: ColumnScope

ضَع العنصر أفقيًا بحيث يتوافق alignmentLine مع العناصر الشقيقة التي تم ضبطها أيضًا على alignBy.

النطاق: BoxScope
Modifier.align(alignment: Alignment)

اسحب عنصر المحتوى إلى Alignment معيّن ضمن Box.

الصور المتحركة

النطاق: أي
@ExperimentalSharedTransitionApi
Modifier.animateBounds(
    lookaheadScope: LookaheadScope,
    modifier: Modifier,
    boundsTransform: BoundsTransform,
    animateMotionFrameOfReference: Boolean
)

Modifier لتحريك تغييرات التنسيق (الموضع و/أو الحجم) التي تحدث ضِمن LookaheadScope

النطاق: أي
@ExperimentalMaterial3ExpressiveApi
Modifier.animateFloatingActionButton(
    visible: Boolean,
    alignment: Alignment,
    targetScale: Float,
    scaleAnimationSpec: AnimationSpec<Float>?,
    alphaAnimationSpec: AnimationSpec<Float>?
)

طبِّق هذا المعدِّل على FloatingActionButton لعرضه أو إخفائه باستخدام صورة متحركة، استنادًا عادةً إلى التمرير في المحتوى الرئيسي للتطبيق.

open
Modifier.animateEnterExit(
    enter: EnterTransition,
    exit: ExitTransition,
    label: String
)

يمكن استخدام المعدِّل animateEnterExit مع أي عناصر ثانوية مباشرة أو غير مباشرة للعنصر AnimatedVisibility لإنشاء رسم متحرك مختلف للدخول/الخروج عن الرسم المتحرك المحدّد في AnimatedVisibility.

النطاق: LazyItemScope
open
Modifier.animateItem(
    fadeInSpec: FiniteAnimationSpec<Float>?,
    placementSpec: FiniteAnimationSpec<IntOffset>?,
    fadeOutSpec: FiniteAnimationSpec<Float>?
)

يُستخدم هذا المعدِّل لتحريك مظهر العنصر (تلاشي الظهور) والاختفاء (تلاشي الاختفاء) وتغييرات الموضع (مثل إعادة ترتيب العناصر).

النطاق: LazyGridItemScope
Modifier.animateItem(
    fadeInSpec: FiniteAnimationSpec<Float>?,
    placementSpec: FiniteAnimationSpec<IntOffset>?,
    fadeOutSpec: FiniteAnimationSpec<Float>?
)

يُستخدم هذا المعدِّل لتحريك مظهر العنصر (تلاشي الظهور) والاختفاء (تلاشي الاختفاء) وتغييرات الموضع (مثل إعادة ترتيب العناصر).

Modifier.animateItem(
    fadeInSpec: FiniteAnimationSpec<Float>?,
    placementSpec: FiniteAnimationSpec<IntOffset>?,
    fadeOutSpec: FiniteAnimationSpec<Float>?
)

يُستخدم هذا المعدِّل لتحريك مظهر العنصر (تلاشي الظهور) والاختفاء (تلاشي الاختفاء) وتغييرات الموضع (مثل إعادة ترتيب العناصر).

الحدود

النطاق: أي
Modifier.border(border: BorderStroke, shape: Shape)

عدِّل العنصر لإضافة حدّ بالمظهر المحدّد باستخدام border وshape واقتصاصه.

النطاق: أي
Modifier.border(width: Dp, brush: Brush, shape: Shape)

عدِّل العنصر لإضافة حدّ ذي مظهر محدّد باستخدام width وbrush وshape واقتصاصه.

النطاق: أي
Modifier.border(width: Dp, color: Color, shape: Shape)

عدِّل العنصر لإضافة حدّ ذي مظهر محدّد باستخدام width وcolor وshape واقتصاصه.

الرسم

النطاق: أي
Modifier.alpha(alpha: Float)

رسم محتوى باستخدام قيمة ألفا معدَّلة قد تكون أقل من 1

النطاق: أي
Modifier.background(color: Color, shape: Shape)

يرسم shape بلون color ثابت خلف المحتوى.

النطاق: أي
Modifier.background(
    brush: Brush,
    shape: Shape,
    alpha: @FloatRange(from = 0.0, to = 1.0) Float
)

يرسم shape مع brush خلف المحتوى.

النطاق: أي
Modifier.clip(shape: Shape)

قصّ المحتوى إلى shape.

النطاق: أي

يتم قص المحتوى ليناسب حدود طبقة محدّدة في أداة التعديل هذه.

النطاق: أي
Modifier.drawBehind(onDraw: DrawScope.() -> Unit)

ارسم في Canvas خلف المحتوى المعدَّل.

النطاق: أي
Modifier.drawWithCache(onBuildDrawCache: CacheDrawScope.() -> DrawResult)

ارسم في DrawScope باستخدام محتوى يتم الاحتفاظ به في جميع طلبات الرسم طالما أنّ حجم مساحة الرسم هو نفسه أو لم تتغيّر أي كائنات حالة تمت قراءتها.

النطاق: أي

تنشئ هذه السمة DrawModifier تتيح للمطوّر الرسم قبل محتويات التصميم أو بعدها.

النطاق: أي
Modifier.indication(
    interactionSource: InteractionSource,
    indication: Indication?
)

تعرض هذه السمة تأثيرات مرئية لهذا المكوِّن عند حدوث تفاعلات.

النطاق: أي
Modifier.paint(
    painter: Painter,
    sizeToIntrinsics: Boolean,
    alignment: Alignment,
    contentScale: ContentScale,
    alpha: Float,
    colorFilter: ColorFilter?
)

ارسم المحتوى باستخدام painter.

النطاق: أي
Modifier.dropShadow(shape: Shape, block: DropShadowScope.() -> Unit)

يرسم ظلّاً مسقطًا خلف بقية المحتوى باستخدام الشكل الهندسي المحدّد بالشكل المعطى وخصائص الظلّ المحدّدة في DropShadowScope.

النطاق: أي
Modifier.dropShadow(shape: Shape, shadow: Shadow)

ترسم هذه السمة ظلًا مسقطًا خلف بقية المحتوى باستخدام الشكل الهندسي المحدّد بالشكل المعطى وخصائص الظل المحدّدة بواسطة Shadow.

النطاق: أي
Modifier.innerShadow(shape: Shape, block: InnerShadowScope.() -> Unit)

ترسم هذه السمة ظلًا داخليًا خلف بقية المحتوى باستخدام الشكل الهندسي المحدّد بالشكل المعطى وخصائص الظل المحدّدة في InnerShadowScope.

النطاق: أي
Modifier.innerShadow(shape: Shape, shadow: Shadow)

يرسم ظلًا داخليًا فوق بقية المحتوى باستخدام الشكل الهندسي المحدّد بالشكل المعطى وخصائص الظل المحدّدة بواسطة Shadow.

النطاق: أي
Modifier.shadow(
    elevation: Dp,
    shape: Shape,
    clip: Boolean,
    ambientColor: Color,
    spotColor: Color
)

تنشئ هذه السمة graphicsLayer ترسم ظلًا.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج safe drawing.

النطاق: أي
Modifier.zIndex(zIndex: Float)

تنشئ هذه السمة معدِّلاً يتحكّم في ترتيب الرسم للعناصر التابعة لعنصر التنسيق الرئيسي نفسه.

التركيز

النطاق: أي
Modifier.onFocusChanged(onFocusChanged: (FocusState) -> Unit)

أضِف هذا المعدِّل إلى أحد المكوّنات لمراقبة أحداث حالة التركيز.

النطاق: أي
Modifier.onFocusEvent(onFocusEvent: (FocusState) -> Unit)

أضِف هذا المعدِّل إلى أحد المكوّنات لمراقبة أحداث حالة التركيز.

النطاق: أي

تم إيقاف هذه الوظيفة نهائيًا. تم استبداله بـ focusTarget

النطاق: أي

أضِف هذا المعدِّل إلى أحد المكوّنات لجعله قابلاً للتركيز.

النطاق: أي
Modifier. focusOrder(focusOrderReceiver: FocusOrder.() -> Unit)

تم إيقاف هذه الوظيفة نهائيًا. استخدِم focusProperties() بدلاً من ذلك

النطاق: أي
Modifier. focusOrder(focusRequester: FocusRequester)

تم إيقاف هذه الوظيفة نهائيًا. استخدِم focusRequester()‎ بدلاً من ذلك.

النطاق: أي
Modifier. focusOrder(
    focusRequester: FocusRequester,
    focusOrderReceiver: FocusOrder.() -> Unit
)

تم إيقاف هذه الوظيفة نهائيًا. استخدِم focusProperties()‎ وfocusRequester()‎ بدلاً من ذلك.

النطاق: أي

يسمح لك معدِّل العرض هذا بتحديد السمات التي يمكن الوصول إليها من خلال focusTargets في أسفل سلسلة معدِّلات العرض أو في عُقد تخطيط العناصر التابعة.

النطاق: أي

أضِف هذا المعدِّل إلى أحد المكوّنات لطلب إجراء تغييرات على التركيز.

النطاق: أي

يمكن استخدام أداة التعديل هذه لحفظ التركيز واستعادته إلى مجموعة تركيز.

النطاق: أي

تم إيقاف هذه الوظيفة نهائيًا. استخدِم focusRestorer(FocusRequester) بدلاً من ذلك

النطاق: أي

تُنشئ مجموعة تركيز أو تُصنّف هذا المكوّن كمجموعة تركيز.

النطاق: أي
Modifier.focusable(
    enabled: Boolean,
    interactionSource: MutableInteractionSource?
)

اضبط المكوّن ليكون قابلاً للتركيز عليه من خلال نظام التركيز أو حدث "التركيز" الخاص بتسهيل الاستخدام.

النطاق: أي
Modifier.onFocusedBoundsChanged(
    onPositioned: (LayoutCoordinates?) -> Unit
)

يتم استدعاء onPositioned كلما تغيّرت حدود المنطقة التي يتم التركيز عليها حاليًا.

النطاق: أي

يُستخدَم hierarchicalFocusGroup لإضافة تعليقات توضيحية إلى العناصر القابلة للإنشاء في أحد التطبيقات، ما يتيح لنا تتبُّع الجزء النشط من عملية الإنشاء.

النطاق: أي

يتم استخدام هذا المعدِّل بالتزامن مع hierarchicalFocusGroup وسيطلب التركيز على العنصر التالي القابل للتركيز عند الحاجة (أي يجب أن يكون هذا المعدِّل قبل هذا العنصر في سلسلة المعدِّلات).

الرسومات

النطاق: أي

Modifier.Node التي تجعل المحتوى يتم رسمه في طبقة رسم

النطاق: أي
Modifier.graphicsLayer(
    scaleX: Float,
    scaleY: Float,
    alpha: Float,
    translationX: Float,
    translationY: Float,
    shadowElevation: Float,
    rotationX: Float,
    rotationY: Float,
    rotationZ: Float,
    cameraDistance: Float,
    transformOrigin: TransformOrigin,
    shape: Shape,
    clip: Boolean,
    renderEffect: RenderEffect?,
    ambientShadowColor: Color,
    spotShadowColor: Color,
    compositingStrategy: CompositingStrategy,
    blendMode: BlendMode,
    colorFilter: ColorFilter?
)

Modifier.Element التي تجعل المحتوى يتم رسمه في طبقة رسم

النطاق: أي

Modifier.Element يضيف طبقة رسم حتى تتمكّن الأدوات من التعرّف على عنصر في الصورة المرسومة.

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

النطاق: أي
Modifier.onKeyEvent(onKeyEvent: (KeyEvent) -> Boolean)

ستسمح إضافة modifier إلى المَعلمة modifier لأحد المكوّنات باعتراض أحداث مفاتيح الأجهزة عندما يكون المكوّن (أو أحد العناصر التابعة له) في وضع التركيز.

النطاق: أي
Modifier.onPreviewKeyEvent(onPreviewKeyEvent: (KeyEvent) -> Boolean)

ستسمح إضافة modifier إلى المَعلمة modifier لأحد المكوّنات باعتراض أحداث مفاتيح الأجهزة عندما يكون المكوّن (أو أحد العناصر التابعة له) في وضع التركيز.

التصميم

النطاق: أي
Modifier.layoutId(layoutId: String, tag: String?)

بديل androidx.compose.ui.layout.layoutId الذي يتيح استخدام tag

النطاق: أي
Modifier.layoutId(layoutId: Any)

ضع علامة layoutId على العنصر لتحديده ضمن العنصر الرئيسي.

النطاق: أي

تنشئ هذه السمة LayoutModifier تسمح بتغيير طريقة قياس العنصر المغلَّف وتنسيقه.

النطاق: أي
Modifier.onGloballyPositioned(
    onGloballyPositioned: (LayoutCoordinates) -> Unit
)

استدعِ الدالة onGloballyPositioned مع LayoutCoordinates للعنصر عندما يكون الموضع العام للمحتوى قد تغيّر.

الحشو

النطاق: أي
Modifier.paddingFrom(alignmentLine: AlignmentLine, before: Dp, after: Dp)

Modifier يمكنه إضافة مساحة متروكة لتحديد موضع المحتوى وفقًا للمسافات المحدّدة من حدوده إلى alignment line.

النطاق: أي
Modifier.paddingFrom(
    alignmentLine: AlignmentLine,
    before: TextUnit,
    after: TextUnit
)

Modifier يمكنه إضافة مساحة متروكة لتحديد موضع المحتوى وفقًا للمسافات المحدّدة من حدوده إلى alignment line.

النطاق: أي
Modifier.paddingFromBaseline(top: Dp, bottom: Dp)

Modifier الذي يضع المحتوى في تخطيط بحيث تكون المسافة من أعلى التخطيط إلى baseline of the first line of text in the content هي top، والمسافة من baseline of the last line of text in the content إلى أسفل التخطيط هي bottom

النطاق: أي

Modifier الذي يضع المحتوى في تخطيط بحيث تكون المسافة من أعلى التخطيط إلى baseline of the first line of text in the content هي top، والمسافة من baseline of the last line of text in the content إلى أسفل التخطيط هي bottom

النطاق: أي
Modifier.absolutePadding(left: Dp, top: Dp, right: Dp, bottom: Dp)

تطبيق مساحة إضافية على طول كل حافة من حواف المحتوى في Dp: left وtop وright وbottom

النطاق: أي

تطبيق all وحدة بكسل مستقلة من المساحة الإضافية على طول كل حافة من حواف المحتوى، أي من اليسار والأعلى واليمين والأسفل

النطاق: أي
Modifier.padding(paddingValues: PaddingValues)

طبِّق PaddingValues على المكوّن كمساحة إضافية على طول كل حافة من حواف المحتوى الأيمن والأعلى والأيسر والأسفل.

النطاق: أي
Modifier.padding(horizontal: Dp, vertical: Dp)

طبِّق مساحة horizontal وحدة بكسل مستقل الكثافة على طول الحافتَين اليمنى واليسرى للمحتوى، ومساحة vertical وحدة بكسل مستقل الكثافة على طول الحافتَين العلوية والسفلية.

النطاق: أي
Modifier.padding(start: Dp, top: Dp, end: Dp, bottom: Dp)

تطبيق مساحة إضافية على طول كل حافة من حواف المحتوى في Dp: start وtop وend وbottom

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج caption bar.

النطاق: أي

تضيف هذه السمة مساحة متروكة لاستيعاب display cutout.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج ime.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج mandatory system gestures.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج navigation bars.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج safe content.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج safe gestures.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج status bars.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج system bars.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج system gestures.

النطاق: أي

تضيف هذه السمة مساحة فارغة لاستيعاب عمليات الإدراج waterfall.

النطاق: أي

تضيف هذه السمة مساحة فارغة كي لا يدخل المحتوى إلى المساحة insets.

المؤشر

النطاق: أي
Modifier.pointerHoverIcon(
    icon: PointerIcon,
    overrideDescendants: Boolean
)

معدِّل يتيح للمطوّر تحديد رمز مؤشر لعرضه عند تمرير مؤشر الماوس فوق العنصر.

النطاق: أي
Modifier.pointerInteropFilter(
    requestDisallowInterceptTouchEvent: RequestDisallowInterceptTouchEvent?,
    onTouchEvent: (MotionEvent) -> Boolean
)

‫PointerInputModifier خاص يتيح الوصول إلى MotionEvent التي تم إرسالها في الأصل إلى Compose.

النطاق: أي
Modifier. pointerInput(block: suspend PointerInputScope.() -> Unit)

تم إيقاف هذه الوظيفة نهائيًا. يجب أن يوفّر Modifier.pointerInput مَعلمة واحدة أو أكثر من مَعلمات "المفتاح" التي تحدّد هوية المعدِّل وتحدّد متى يجب إلغاء روتين المعالجة المشتركة السابق لإدخال البيانات وإطلاق تأثير جديد للمفتاح الجديد.

النطاق: أي

أنشئ أداة تعديل لمعالجة إدخال المؤشر ضمن منطقة العنصر المعدَّل.

النطاق: أي
Modifier.pointerInput(vararg keys: Any?, block: PointerInputEventHandler)

أنشئ أداة تعديل لمعالجة إدخال المؤشر ضمن منطقة العنصر المعدَّل.

النطاق: أي
Modifier.pointerInput(
    key1: Any?,
    key2: Any?,
    block: PointerInputEventHandler
)

أنشئ أداة تعديل لمعالجة إدخال المؤشر ضمن منطقة العنصر المعدَّل.

الموضع

النطاق: أي

إزاحة المحتوى بمقدار offset بكسل

النطاق: أي

إزاحة المحتوى بمقدار (x وحدة بكسل مستقلة عن الكثافة، y وحدة بكسل مستقلة عن الكثافة).

النطاق: أي
Modifier.offset(offset: Density.() -> IntOffset)

إزاحة المحتوى بمقدار offset بكسل

النطاق: أي
Modifier.offset(x: Dp, y: Dp)

إزاحة المحتوى بمقدار (x وحدة بكسل مستقلة عن الكثافة، y وحدة بكسل مستقلة عن الكثافة).

النطاق: TabRowDefaults
Modifier.tabIndicatorOffset(currentTabPosition: TabPosition)

Modifier الذي يشغل كل العرض المتاح داخل TabRow، ثم يحرك موضع المؤشر الذي يتم تطبيقه عليه، وذلك حسب currentTabPosition.

النطاق: TabRowDefaults
Modifier. tabIndicatorOffset(currentTabPosition: TabPosition)

تم إيقاف هذه الوظيفة نهائيًا. يُستخدَم فقط مع طريقة TabRowDefaults.Indicator المتوقّفة نهائيًا.

الدلالات

النطاق: أي

يحتوي على semantics المطلوبة لمؤشر تقدّم غير محدّد، والذي يمثّل حقيقة العملية الجارية.

النطاق: أي
Modifier.progressSemantics(
    value: Float,
    valueRange: ClosedFloatingPointRange<Float>,
    steps: @IntRange(from = 0) Int
)

يحتوي على semantics المطلوب لمؤشر تقدّم محدّد أو جزء التقدّم في شريط تمرير، والذي يمثّل التقدّم ضمن valueRange.

النطاق: أي
Modifier.rangeSemantics(
    value: Float,
    enabled: Boolean,
    onValueChange: (Float) -> Unit,
    valueRange: ClosedFloatingPointRange<Float>,
    steps: Int
)

معدِّل لإضافة دلالات تشير إلى تقدّم Stepper/Slider.

النطاق: أي

يمحو دلالات جميع العُقد الفرعية ويضبط دلالات جديدة.

النطاق: أي
Modifier.semantics(mergeDescendants: Boolean, properties: SemanticsPropertyReceiver.() -> Unit)

أضِف أزواج المفتاح/القيمة الدلالية إلى عقدة التصميم لاستخدامها في الاختبار وإمكانية الوصول وما إلى ذلك.

التمرير

النطاق: أي

يتم قص حدود الحاوية القابلة للتمرير على المحور الرئيسي مع ترك مساحة لتأثيرات الخلفية (مثل الظلال) على المحور الفرعي.

النطاق: أي
Modifier.nestedScroll(
    connection: NestedScrollConnection,
    dispatcher: NestedScrollDispatcher?
)

عدِّل العنصر لجعله يشارك في التدرّج الهرمي للتمرير المتداخل.

النطاق: أي
Modifier.overscroll(overscrollEffect: OverscrollEffect?)

تعرض هذه السمة التمرير الزائد من overscrollEffect المقدَّمة.

النطاق: أي
Modifier.onPreRotaryScrollEvent(
    onPreRotaryScrollEvent: (RotaryScrollEvent) -> Boolean
)

ستسمح إضافة modifier إلى المَعلمة modifier لأحد المكوّنات باعتراض RotaryScrollEvent إذا كان المكوّن (أو أحد العناصر الثانوية له) في وضع التركيز.

النطاق: أي
Modifier.onRotaryScrollEvent(
    onRotaryScrollEvent: (RotaryScrollEvent) -> Boolean
)

ستسمح إضافة modifier إلى المَعلمة modifier لأحد المكوّنات باعتراض RotaryScrollEvent إذا كان المكوّن (أو أحد العناصر الثانوية له) في وضع التركيز.

النطاق: أي
Modifier.rotaryScrollable(
    behavior: RotaryScrollableBehavior,
    focusRequester: FocusRequester,
    reverseDirection: Boolean,
    overscrollEffect: OverscrollEffect?
)

معدِّل يربط أحداث التدوير بالحاويات القابلة للتمرير، مثل العمود والقائمة الكسولة وغيرها.

النطاق: أي
Modifier.scrollAway(
    scrollInfoProvider: ScrollInfoProvider,
    screenStage: () -> ScreenStage
)

تمرير عنصر عموديًا داخل أو خارج إطار العرض استنادًا إلى حالة التمرير التي توفّرها قائمة قابلة للتمرير

النطاق: أي
Modifier.scrollAway(scrollState: ScrollState, offset: Dp)

تمرير عنصر عموديًا داخل/خارج إطار العرض استنادًا إلى ScrollState

النطاق: أي
Modifier.scrollAway(
    scrollState: LazyListState,
    itemIndex: Int,
    offset: Dp
)

تمرير عنصر عموديًا داخل/خارج إطار العرض استنادًا إلى LazyListState

النطاق: أي
Modifier.scrollAway(
    scrollState: ScalingLazyListState,
    itemIndex: Int,
    offset: Dp
)

تمرير عنصر عموديًا داخل/خارج إطار العرض استنادًا إلى ScalingLazyListState

النطاق: أي
Modifier. scrollAway(
    scrollState: ScalingLazyListState,
    itemIndex: Int,
    offset: Dp
)

تم إيقاف هذه الوظيفة نهائيًا. يتم توفير هذا التحميل الزائد للتوافق مع الإصدارات القديمة من Compose for Wear OS 1.1.يتوفّر تحميل زائد أحدث يستخدم ScalingLazyListState من حزمة wear.compose.foundation.lazy

النطاق: أي
Modifier.horizontalScroll(
    state: ScrollState,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

تعديل العنصر للسماح بالتمرير أفقيًا عندما يكون عرض المحتوى أكبر من الحد الأقصى المسموح به

النطاق: أي
Modifier.horizontalScroll(
    state: ScrollState,
    overscrollEffect: OverscrollEffect?,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

تعديل العنصر للسماح بالتمرير أفقيًا عندما يكون عرض المحتوى أكبر من الحد الأقصى المسموح به

النطاق: أي
Modifier.verticalScroll(
    state: ScrollState,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

تعديل العنصر للسماح بالتمرير عموديًا عندما يكون ارتفاع المحتوى أكبر من الحدّ الأقصى المسموح به

النطاق: أي
Modifier.verticalScroll(
    state: ScrollState,
    overscrollEffect: OverscrollEffect?,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

تعديل العنصر للسماح بالتمرير عموديًا عندما يكون ارتفاع المحتوى أكبر من الحدّ الأقصى المسموح به

النطاق: أي
Modifier.scrollable2D(
    state: Scrollable2DState,
    enabled: Boolean,
    overscrollEffect: OverscrollEffect?,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?
)

ضبط التمرير السريع والتحريك باللمس لعنصر واجهة المستخدم في كلتا الوضعيتين XY

النطاق: أي
Modifier.scrollable(
    state: ScrollableState,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?
)

ضبط التمرير السريع والتحريك باللمس لعنصر واجهة المستخدم في Orientation واحد

النطاق: أي
Modifier.scrollable(
    state: ScrollableState,
    orientation: Orientation,
    overscrollEffect: OverscrollEffect?,
    enabled: Boolean,
    reverseDirection: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?,
    bringIntoViewSpec: BringIntoViewSpec?
)

ضبط التمرير السريع والتحريك باللمس لعنصر واجهة المستخدم في Orientation واحد

النطاق: أي

تتحكّم هذه السياسة في لوحة المفاتيح الافتراضية كعملية تمرير متداخلة على الإصدار R من نظام التشغيل Android والإصدارات الأحدث.

المقاس

النطاق: أي
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

يعمل معدِّل العرض هذا على تحريك حجمه عندما يتغيّر حجم معدِّل العرض التابع (أو العنصر القابل للإنشاء التابع إذا كان في نهاية السلسلة).

النطاق: أي
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    alignment: Alignment,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

يعمل معدِّل العرض هذا على تحريك حجمه عندما يتغيّر حجم معدِّل العرض التابع (أو العنصر القابل للإنشاء التابع إذا كان في نهاية السلسلة).

النطاق: أي
Modifier.aspectRatio(
    ratio: @FloatRange(from = 0.0, fromInclusive = false) Float,
    matchHeightConstraintsFirst: Boolean
)

محاولات تغيير حجم المحتوى ليتطابق مع نسبة عرض إلى ارتفاع محدّدة من خلال محاولة مطابقة أحد القيود الواردة بالترتيب التالي: Constraints.maxWidth أو Constraints.maxHeight أو Constraints.minWidth أو Constraints.minHeight إذا كانت قيمة matchHeightConstraintsFirst هي false (وهي القيمة التلقائية)، أو Constraints.maxHeight أو Constraints.maxWidth أو Constraints.minHeight أو Constraints.minWidth إذا كانت قيمة matchHeightConstraintsFirst هي true.

النطاق: أي

يجب أن يكون حجمها 48 بكسل مستقل الكثافة (dp) على الأقل لتجنُّب الالتباس في تفاعلات اللمس إذا كان حجم العنصر أصغر.

النطاق: أي

يجب أن يكون حجمها 48 بكسل مستقل الكثافة (dp) على الأقل لتجنُّب الالتباس في تفاعلات اللمس إذا كان حجم العنصر أصغر.

النطاق: أي

يجب أن يكون حجمها 48 بكسل مستقل الكثافة (dp) على الأقل لتجنُّب الالتباس في تفاعلات اللمس إذا كان حجم العنصر أصغر.

النطاق: أي

يجب أن يكون حجمها 48 بكسل مستقل الكثافة (dp) على الأقل لتجنُّب الالتباس في تفاعلات اللمس إذا كان حجم العنصر أصغر.

النطاق: أي
Modifier.height(intrinsicSize: IntrinsicSize)

حدِّد الارتفاع المفضّل للمحتوى ليكون هو نفسه الحد الأدنى أو الأقصى للارتفاع الأصلي للمحتوى.

النطاق: أي

يجب تحديد ارتفاع المحتوى ليكون مطابقًا تمامًا للحد الأدنى أو الأقصى للارتفاع الداخلي للمحتوى.

النطاق: أي

تحديد عرض المحتوى ليكون مطابقًا تمامًا للحد الأدنى أو الأقصى للعرض الداخلي للمحتوى

النطاق: أي
Modifier.width(intrinsicSize: IntrinsicSize)

عليك تحديد العرض المفضّل للمحتوى ليكون هو نفسه الحد الأدنى أو الأقصى للعرض الداخلي للمحتوى.

النطاق: أي
Modifier.onSizeChanged(onSizeChanged: (IntSize) -> Unit)

يتم استدعاؤها مع حجم عنصر واجهة مستخدم Compose المعدَّل عند قياس العنصر لأول مرة أو عند تغيُّر حجم العنصر.

النطاق: أي
Modifier.defaultMinSize(minWidth: Dp, minHeight: Dp)

لا يتم فرض قيود على حجم التنسيق المضمّن إلا عندما لا يكون هناك قيود أخرى: لا يتم تطبيق القيدَين minWidth وminHeight إلا عندما يكون القيد الوارد المقابل هو 0.

النطاق: أي
Modifier.fillMaxHeight(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

اجعل المحتوى يملأ (ربما جزئيًا فقط) Constraints.maxHeight من قيود القياس الواردة، وذلك من خلال ضبط minimum height وmaximum height على أن يكونا مساويَين maximum height مضروبًا في fraction.

النطاق: أي
Modifier.fillMaxSize(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

اجعل المحتوى يملأ (جزئيًا على الأرجح) Constraints.maxWidth وConstraints.maxHeight من قيود القياس الواردة، وذلك عن طريق ضبط minimum width وmaximum width ليكون مساويًا maximum width مضروبًا في fraction، بالإضافة إلى ضبط minimum height وmaximum height ليكون مساويًا maximum height مضروبًا في fraction.

النطاق: أي
Modifier.fillMaxWidth(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

اجعل المحتوى يملأ (ربما جزئيًا فقط) Constraints.maxWidth من قيود القياس الواردة، وذلك من خلال ضبط minimum width وmaximum width على أن يكونا مساويَين maximum width مضروبًا في fraction.

النطاق: أي
Modifier.height(height: Dp)

عليك تحديد الارتفاع المفضّل للمحتوى ليكون heightdp بالضبط.

النطاق: أي
Modifier.heightIn(min: Dp, max: Dp)

يجب أن يكون ارتفاع المحتوى بين mindp وmaxdp على النحو المسموح به في القياس الوارد Constraints.

النطاق: أي

حدِّد ارتفاع المحتوى على أنّه heightdp بالضبط.

النطاق: أي
Modifier.requiredHeightIn(min: Dp, max: Dp)

قصر ارتفاع المحتوى على أن يكون بين mindp وmaxdp.

النطاق: أي

حدِّد حجم المحتوى ليكون sizedp عرضًا وارتفاعًا بالضبط.

النطاق: أي

يجب أن يكون حجم المحتوى size بالضبط.

النطاق: أي
Modifier.requiredSize(width: Dp, height: Dp)

يجب أن يكون حجم المحتوى widthdp وheightdp بالضبط.

النطاق: أي
Modifier.requiredSizeIn(
    minWidth: Dp,
    minHeight: Dp,
    maxWidth: Dp,
    maxHeight: Dp
)

يجب أن يتراوح عرض المحتوى بين minWidthdp وmaxWidthdp، وأن يتراوح ارتفاع المحتوى بين minHeightdp وmaxHeightdp.

النطاق: أي

حدِّد عرض المحتوى على أنّه widthdp بالضبط.

النطاق: أي
Modifier.requiredWidthIn(min: Dp, max: Dp)

يجب أن يكون عرض المحتوى بين mindp وmaxdp.

النطاق: أي
Modifier.size(size: Dp)

حدِّد الحجم المفضّل للمحتوى ليكون size وحدة بكسل مستقلة مربّعة بالضبط.

النطاق: أي
Modifier.size(size: DpSize)

يجب تحديد الحجم المفضّل للمحتوى على أن يكون size بالضبط.

النطاق: أي
Modifier.size(width: Dp, height: Dp)

حدِّد الحجم المفضّل للمحتوى ليكون width بكسل مستقل الكثافة (dp) في height بكسل مستقل الكثافة (dp).

النطاق: أي
Modifier.sizeIn(minWidth: Dp, minHeight: Dp, maxWidth: Dp, maxHeight: Dp)

يجب أن يكون عرض المحتوى بين minWidthdp وmaxWidthdp وأن يكون ارتفاع المحتوى بين minHeightdp وmaxHeightdp على النحو المسموح به في القياس الوارد Constraints.

النطاق: أي
Modifier.width(width: Dp)

حدِّد العرض المفضّل للمحتوى ليكون widthdp بالضبط.

النطاق: أي
Modifier.widthIn(min: Dp, max: Dp)

يجب أن يكون عرض المحتوى بين mindp وmaxdp على النحو المسموح به في القياس الوارد Constraints.

النطاق: أي
Modifier.wrapContentHeight(
    align: Alignment.Vertical,
    unbounded: Boolean
)

السماح للمحتوى بالقياس على الارتفاع المطلوب بدون مراعاة القياس الوارد minimum height constraint، وإذا كانت قيمة unbounded صحيحة، بدون مراعاة القياس الوارد maximum height constraint أيضًا

النطاق: أي
Modifier.wrapContentSize(align: Alignment, unbounded: Boolean)

يسمح هذا الخيار للمحتوى بالقياس بالحجم المطلوب بدون مراعاة قيود القياس الواردة minimum width أو minimum height، وإذا كانت قيمة unbounded صحيحة، بدون مراعاة القيود القصوى الواردة أيضًا.

النطاق: أي
Modifier.wrapContentWidth(
    align: Alignment.Horizontal,
    unbounded: Boolean
)

يسمح هذا الخيار بقياس المحتوى بالعرض المطلوب بدون مراعاة القياس الوارد minimum width constraint، وإذا كانت القيمة unbounded صحيحة، بدون مراعاة القياس الوارد maximum width constraint أيضًا.

النطاق: أي

معدِّل لضبط كلّ من الحجم وناحية اللمس المستهدفة المقترَحة لكلّ من IconButton وTextButton

النطاق: أي
Modifier.transformedHeight(
    scope: TransformingLazyColumnItemScope,
    transformationSpec: TransformationSpec
)

عنصر تعديل مناسب لاحتساب الارتفاع المحوّل باستخدام TransformationSpec.

النطاق: أي

يتم ضبط الارتفاع على ارتفاع insets في bottom من الشاشة.

النطاق: أي

يضبط هذا العنصر العرض على عرض insets في end الشاشة، باستخدام left أو right، حسب LayoutDirection.

النطاق: أي

يضبط هذا العنصر العرض على عرض insets في start الشاشة، باستخدام left أو right، حسب LayoutDirection.

النطاق: أي

يتم ضبط الارتفاع على ارتفاع insets في top من الشاشة.

النطاق: أي
@UnstableApi
@Composable
Modifier.resizeWithContentScale(
    contentScale: ContentScale,
    sourceSizeDp: Size?,
    density: Density
)

محاولات لتحديد حجم مستطيل المحتوى الأصلي ليتم إدراجه في وجهة من خلال تطبيق نوع ContentScale محدّد

النطاق: RowScope
Modifier.weight(
    weight: @FloatRange(from = 0.0, fromInclusive = false) Float,
    fill: Boolean
)

اضبط عرض العنصر بما يتناسب مع weight مقارنةً بالعناصر الشقيقة الأخرى ذات الأوزان في Row.

النطاق: ColumnScope
Modifier.weight(
    weight: @FloatRange(from = 0.0, fromInclusive = false) Float,
    fill: Boolean
)

اضبط ارتفاع العنصر بما يتناسب مع weight مقارنةً بالعناصر الشقيقة الأخرى ذات الأوزان في Column.

النطاق: FlowRowScope
@ExperimentalLayoutApi
Modifier.fillMaxRowHeight(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

يجب أن يملأ العنصر (ربما جزئيًا فقط) الحد الأقصى لارتفاع أطول عنصر في الصف الذي تم وضعه فيه، وذلك ضمن FlowRow.

النطاق: FlowColumnScope
@ExperimentalLayoutApi
Modifier.fillMaxColumnWidth(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

يجب أن يملأ العنصر (ربما جزئيًا فقط) الحد الأقصى لعرض العنصر الأوسع في العمود الذي تم وضعه فيه، وذلك ضمن FlowColumn.

النطاق: BoxScope

اضبط حجم العنصر ليتطابق مع حجم Box بعد قياس جميع عناصر المحتوى الأخرى.

النطاق: LazyItemScope
Modifier.fillParentMaxHeight(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

اجعل المحتوى يملأ Constraints.maxHeight قيود القياس الواردة من خلال ضبط minimum height ليكون مساويًا maximum height مضروبًا في fraction.

النطاق: LazyItemScope
Modifier.fillParentMaxSize(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

اجعل المحتوى يملأ Constraints.maxWidth وConstraints.maxHeight من قيود القياس الرئيسية عن طريق ضبط minimum width ليكون مساويًا لـ maximum width مضروبًا في fraction، وضبط minimum height ليكون مساويًا لـ maximum height مضروبًا في fraction.

النطاق: LazyItemScope
Modifier.fillParentMaxWidth(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

اجعل المحتوى يملأ Constraints.maxWidth قيود القياس الرئيسية من خلال ضبط minimum width ليكون مساويًا maximum width مضروبًا في fraction.

abstract
Modifier.exposedDropdownSize(matchTextFieldWidth: Boolean)

المعدِّل الذي يجب تطبيقه على ExposedDropdownMenu موضوع داخل النطاق.

abstract
Modifier.exposedDropdownSize(matchAnchorWidth: Boolean)

المعدِّل الذي يجب تطبيقه على قائمة موضوعة داخل ExposedDropdownMenuBoxScope.

النطاق: PaneScaffoldScope
open

Modifier يتيح السحب لتغيير حجم لوحة.

النطاق: PaneScaffoldScope

يحدّد معدِّل العرض هذا الارتفاع المفضّل للوحة، وسيحاول تنفيذ هيكل اللوحة بأفضل شكل مراعاةً لهذا الارتفاع عند عرض اللوحة المرتبطة كلوحة معاد تدفقها أو لوحة مرتفعة.

النطاق: PaneScaffoldScope

يحدّد هذا المعدِّل العرض المفضّل للوحة، وسيحاول تنفيذ هيكل اللوحة بأفضل ما لديه مراعاةً لهذا العرض عند عرض اللوحة المرتبطة كلوحة ثابتة، أي لوحة لا يتم توسيعها لملء المساحات المتبقية.

الاختبار

النطاق: أي

تُطبِّق هذه السمة علامة للسماح بالعثور على العنصر المعدَّل في الاختبارات.

عمليات التحويل

النطاق: أي
Modifier.rotate(degrees: Float)

تضبط هذه السمة عدد الدرجات التي يتم تدوير العرض بها حول مركز العنصر القابل للإنشاء.

النطاق: أي
Modifier.scale(scale: Float)

يمكنك تغيير حجم محتوى المحورين الأفقي والرأسي بشكل موحّد باستخدام عامل تغيير الحجم نفسه.

النطاق: أي
Modifier.scale(scaleX: Float, scaleY: Float)

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

النطاق: أي
Modifier.transformable(
    state: TransformableState,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

تفعيل إيماءات التحويل لعنصر واجهة المستخدم المعدَّل

النطاق: أي
Modifier.transformable(
    state: TransformableState,
    canPan: (Offset) -> Boolean,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

تفعيل إيماءات التحويل لعنصر واجهة المستخدم المعدَّل

غير ذلك

النطاق: أي

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

النطاق: أي

اضبط تلميح الملء التلقائي باستخدام contentType.

النطاق: أي
Modifier.basicMarquee(
    iterations: Int,
    animationMode: MarqueeAnimationMode,
    repeatDelayMillis: Int,
    initialDelayMillis: Int,
    spacing: MarqueeSpacing,
    velocity: Dp
)

تطبيق تأثير شريط تمرير متحرك على المحتوى المعدَّل إذا كان عرضه أكبر من المساحة المتاحة

النطاق: أي
Modifier.edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

يمكن التمرير سريعًا على المقابض لإغلاقها من حافة إطار العرض.

النطاق: أي
Modifier.blur(radius: Dp, edgeTreatment: BlurredEdgeTreatment)

رسم محتوى مموّه بنصف القطر المحدّد

النطاق: أي
Modifier.blur(
    radiusX: Dp,
    radiusY: Dp,
    edgeTreatment: BlurredEdgeTreatment
)

رسم محتوى مموّه بنصف القطر المحدّد

النطاق: أي
Modifier.bringIntoViewRequester(
    bringIntoViewRequester: BringIntoViewRequester
)

معدِّل يمكن استخدامه لإرسال طلبات bringIntoView.

النطاق: أي

تم إيقاف هذه الوظيفة نهائيًا. استخدِم BringIntoViewModifierNode بدلاً من ذلك

النطاق: أي
Modifier.composed(
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

عليك تعريف تركيبة في الوقت المناسب من Modifier سيتم إنشاؤها لكل عنصر يتم تعديله.

النطاق: أي
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

عليك تعريف تركيبة في الوقت المناسب من Modifier سيتم إنشاؤها لكل عنصر يتم تعديله.

النطاق: أي
Modifier.composed(
    fullyQualifiedName: String,
    vararg keys: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

عليك تعريف تركيبة في الوقت المناسب من Modifier سيتم إنشاؤها لكل عنصر يتم تعديله.

النطاق: أي
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    key2: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

عليك تعريف تركيبة في الوقت المناسب من Modifier سيتم إنشاؤها لكل عنصر يتم تعديله.

النطاق: أي
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    key2: Any?,
    key3: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

عليك تعريف تركيبة في الوقت المناسب من Modifier سيتم إنشاؤها لكل عنصر يتم تعديله.

النطاق: أي
Modifier.dragAndDropSource(
    transferData: (Offset) -> DragAndDropTransferData?
)

تمثّل Modifier عنصرًا يمكن تطبيقه على عنصر آخر ليتم التعامل معه كمصدر لعمليات السحب والإفلات.

النطاق: أي
@ExperimentalFoundationApi
Modifier. dragAndDropSource(
    drawDragDecoration: DrawScope.() -> Unit,
    block: suspend DragAndDropSourceScope.() -> Unit
)

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

النطاق: أي
Modifier.dragAndDropSource(
    drawDragDecoration: DrawScope.() -> Unit,
    transferData: (Offset) -> DragAndDropTransferData?
)

تمثّل Modifier عنصرًا يمكن تطبيقه على عنصر آخر ليتم التعامل معه كمصدر لعمليات السحب والإفلات.

النطاق: أي
Modifier.dragAndDropTarget(
    shouldStartDragAndDrop: (startEvent: DragAndDropEvent) -> Boolean,
    target: DragAndDropTarget
)

معدِّل يسمح بالتلقّي من إيماءة السحب والإفلات.

النطاق: أي

تم إيقاف هذه الوظيفة نهائيًا. Use systemGestureExclusion

النطاق: أي

تم إيقاف هذه الوظيفة نهائيًا. Use systemGestureExclusion

النطاق: أي

ضبط معدّل لقطات مطلوب على Composable

النطاق: أي
Modifier.preferredFrameRate(
    frameRate: @FloatRange(from = 0.0, to = 360.0) Float
)

ضبط معدّل لقطات مطلوب على Composable

النطاق: أي
Modifier.handwritingDetector(callback: () -> Unit)

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

النطاق: أي

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

النطاق: أي
Modifier.hoverable(
    interactionSource: MutableInteractionSource,
    enabled: Boolean
)

ضبط المكوّن ليكون قابلاً للتمرير فوقه باستخدام أحداث دخول/خروج المؤشر

النطاق: أي

ستؤدي إضافة modifier إلى المَعلمة modifier لأحد المكوّنات إلى السماح له بالتعامل مع IndirectTouchEvent، إذا كان هذا المكوّن (أو أحد العناصر الثانوية له) في وضع التركيز.

النطاق: أي

ستسمح إضافة modifier هذا إلى المَعلمة modifier لأحد المكوّنات باعتراض IndirectTouchEvent قبل أن يتلقّاها عنصر ثانوي مركّز في onIndirectTouchEvent، إذا كان هذا المكوّن (أو أحد عناصره الثانوية) مركّزًا.

النطاق: أي
inline
Modifier. inspectable(
    noinline inspectorInfo: InspectorInfo.() -> Unit,
    factory: Modifier.() -> Modifier
)

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

النطاق: أي

أداة تعديل تحافظ على إضاءة شاشة الجهاز طالما أنّها جزء من التركيب على الأنظمة الأساسية المتوافقة.

النطاق: أي

سيؤدي ذلك إلى ربط RelativeLayoutBounds المعدِّل بـ LayoutBoundsHolder المقدَّم.

النطاق: أي
Modifier.approachLayout(
    isMeasurementApproachInProgress: (lookaheadSize: IntSize) -> Boolean,
    isPlacementApproachInProgress: Placeable.PlacementScope.(lookaheadCoordinates: LayoutCoordinates) -> Boolean,
    approachMeasure: ApproachMeasureScope.(measurable: Measurable, constraints: Constraints) -> MeasureResult
)

تنشئ هذه السمة تخطيطًا تقريبيًا يهدف إلى المساعدة في الاقتراب تدريجيًا من التخطيط الوجهة الذي تم احتسابه في عملية التمرير المسبق.

النطاق: أي
Modifier.magnifier(
    sourceCenter: Density.() -> Offset,
    magnifierCenter: (Density.() -> Offset)?,
    onSizeChanged: ((DpSize) -> Unit)?,
    zoom: Float,
    size: DpSize,
    cornerRadius: Dp,
    elevation: Dp,
    clip: Boolean
)

تعرض هذه السمة Magnifier أداة تعرض نسخة مكبّرة من المحتوى في sourceCenter بالنسبة إلى عقدة التصميم الحالية.

النطاق: أي

أداة تعديل يمكن استخدامها لاستهلاك ModifierLocals التي قدّمتها أدوات تعديل أخرى على يسار أداة التعديل هذه، أو أعلى أداة التعديل هذه في شجرة التصميم.

النطاق: أي
<T : Any?> Modifier.modifierLocalProvider(
    key: ProvidableModifierLocal<T>,
    value: () -> T
)

أداة تعديل يمكن استخدامها لتوفير ModifierLocal يمكن قراءتها بواسطة أدوات تعديل أخرى على يسار أداة التعديل هذه، أو أدوات تعديل فرعية لعنصر التنسيق الذي تم ربط أداة التعديل هذه به.

النطاق: أي
Modifier.onFirstVisible(
    minDurationMs: @IntRange(from = 0) Long,
    minFractionVisible: @FloatRange(from = 0.0, to = 1.0) Float,
    viewportBounds: LayoutBoundsHolder?,
    callback: () -> Unit
)

تسجّل هذه السمة دالة ردّ لتتبُّع ما إذا كانت العقدة داخل إطار عرض النافذة أو خارجه.

النطاق: أي
Modifier.onLayoutRectChanged(
    throttleMillis: Long,
    debounceMillis: Long,
    callback: (RelativeLayoutBounds) -> Unit
)

يستدعي callback مع موضع عقدة التصميم هذه بالنسبة إلى نظام الإحداثيات لجذر التركيب، بالإضافة إلى إحداثيات الشاشة وإحداثيات النافذة.

النطاق: أي

استخدِم onPlaced بعد وضع العنصر الأصل LayoutModifier وتنسيقه وقبل وضع العنصر الفرعي LayoutModifier.

النطاق: أي
Modifier.onVisibilityChanged(
    minDurationMs: @IntRange(from = 0) Long,
    minFractionVisible: @FloatRange(from = 0.0, to = 1.0) Float,
    viewportBounds: LayoutBoundsHolder?,
    callback: (Boolean) -> Unit
)

تسجّل هذه السمة دالة ردّ لتتبُّع ما إذا كانت العقدة داخل إطار عرض النافذة أم لا.

النطاق: أي
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholder(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

يرسم شكلاً للناقل فوق عنصر قابل للإنشاء ويحرّك تأثير المسح لإزالة الناقل.

النطاق: أي
@Composable
Modifier.placeholder(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

ترسم Modifier.placeholder شكلاً هيكليًا فوق أحد المكوّنات، وذلك في الحالات التي لا يتوفّر فيها أي محتوى مؤقت (مثل البيانات المخزّنة مؤقتًا).

النطاق: أي
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholderShimmer(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

أداة تعديل لرسم تأثير تموّج على عنصر نائب لأحد المكوّنات

النطاق: أي
@Composable
Modifier.placeholderShimmer(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

تعرض السمة Modifier.placeholderShimmer تأثيرًا متوهجًا دوريًا على المحتوى، ما يشير إلى أنّ المحتوى قيد التحميل أو قد يكون قديمًا.

النطاق: أي
Modifier.stylusHoverIcon(
    icon: PointerIcon,
    overrideDescendants: Boolean,
    touchBoundsExpansion: DpTouchBoundsExpansion?
)

أداة تعديل تتيح للمطوّر تحديد رمز مؤشر لعرضه عند تمرير قلم الشاشة فوق العنصر.

النطاق: أي
Modifier.motionEventSpy(watcher: (motionEvent: MotionEvent) -> Unit)

يتم استدعاء watcher مع كل MotionEvent تتلقّاها مساحة التنسيق أو أي عنصر فرعي pointerInput.

النطاق: أي

ضَع علامة على مستطيل التصميم للإشارة إلى أنّه يفضّل البقاء بعيدًا عن النوافذ العائمة.

النطاق: أي

ضَع علامة على مستطيل ضمن إحداثيات التنسيق المحلي، مع الحرص على عدم التداخل مع النوافذ العائمة.

النطاق: أي

معدِّل لترجمة موضع مؤشر السحب لإعادة التحميل وتغيير حجمه استنادًا إلى PullRefreshState المحدّد.

النطاق: أي

أداة تعديل التمرير المتداخل التي توفّر أحداث التمرير إلى state.

النطاق: أي
@ExperimentalMaterialApi
Modifier.pullRefresh(
    onPull: (pullDelta: Float) -> Float,
    onRelease: suspend (flingVelocity: Float) -> Float,
    enabled: Boolean
)

أداة تعديل التمرير المتداخل التي توفّر عمليات ردّ الاتصال onPull وonRelease للمساعدة في إنشاء مكوّنات مخصّصة لإعادة التحميل عند السحب.

النطاق: أي
@ExperimentalMaterial3Api
Modifier.pullToRefresh(
    isRefreshing: Boolean,
    state: PullToRefreshState,
    enabled: Boolean,
    threshold: Dp,
    onRefresh: () -> Unit
)

معدِّل يضيف التمرير المتداخل إلى حاوية لتوفير إيماءة السحب لإعادة التحميل.

النطاق: أي

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

النطاق: أي

يتم احتواء المحتوى ضمن rulers.

النطاق: أي

إذا كانت إحدى قيم Ruler في rulers تقع ضمن حدود "التصميم"، سيتم ضبط حجم المحتوى على قيمة Ruler هذه والحافة.

النطاق: أي
Modifier.sensitiveContent(isContentSensitive: Boolean)

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

النطاق: أي
Modifier.onInterceptKeyBeforeSoftKeyboard(
    onInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

ستسمح إضافة modifier إلى المَعلمة modifier لأحد المكوّنات باعتراض أحداث مفاتيح الأجهزة قبل إرسالها إلى لوحة المفاتيح البرمجية.

النطاق: أي
Modifier.onPreInterceptKeyBeforeSoftKeyboard(
    onPreInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

ستسمح إضافة modifier إلى المَعلمة modifier لأحد المكوّنات باعتراض أحداث مفاتيح الأجهزة قبل إرسالها إلى لوحة المفاتيح البرمجية.

النطاق: أي
Modifier. edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

تم إيقاف هذه الوظيفة نهائيًا. تم نقل SwipeToDismiss إلى androidx.wear.compose.foundation.

النطاق: أي

يستبعد مستطيل التنسيق من إيماءة النظام.

النطاق: أي

يستبعد مستطيلاً ضمن إحداثيات التنسيق المحلي من إيماءة النظام.

النطاق: أي

تضيف هذه السمة builder ليتم تشغيلها عند عرض قائمة السياق الخاصة بالنص ضمن هذه التسلسل الهرمي.

النطاق: أي

تضيف هذه السمة filter ليتم تشغيلها عند عرض قائمة السياق الخاصة بالنص ضمن هذه التسلسل الهرمي.

النطاق: أي

استهلاك الحواف الداخلية التي لم تستهلكها بعد أدوات التعديل الأخرى للحواف الداخلية المشابهة لـ windowInsetsPadding بدون إضافة أي مساحة متروكة

النطاق: أي

استخدام paddingValues كإزاحات كما لو تمت إضافة المساحة المتروكة بغض النظر عن الإزاحات

النطاق: أي
Modifier.onConsumedWindowInsetsChanged(
    block: (consumedWindowInsets: WindowInsets) -> Unit
)

استدعاءات block مع WindowInsets التي تم استخدامها، إما بواسطة consumeWindowInsets أو أحد معدِّلات المساحة المتروكة، مثل imePadding

النطاق: أي

يؤدي ذلك إلى إعادة احتساب WindowInsets استنادًا إلى الحجم والموضع.

تم إيقاف هذه الوظيفة نهائيًا. استخدِم التحميل الزائد الذي يتضمّن المَعلمتَين ExposedDropdownMenuAnchorType وenabled

abstract
Modifier.menuAnchor(
    type: ExposedDropdownMenuAnchorType,
    enabled: Boolean
)

المعدِّل الذي يجب تطبيقه على عنصر داخل ExposedDropdownMenuBoxScope، ويكون عادةً حقل نص أو رمزًا داخل حقل النص