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

الإجراءات

النطاق: أي
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    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?,
    flingBehavior: FlingBehavior?
)

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

النطاق: أي
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
)

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

النطاق: أي
@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.

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

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

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

النطاق: أي
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 واقتصصه.

الرسم

النطاق: أي

رسم محتوى باستخدام قيمة ألفا معدَّلة قد تكون أقل من 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 خلف المحتوى.

النطاق: أي

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

النطاق: أي

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

النطاق: أي

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

النطاق: أي

ارسم في 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.

النطاق: أي

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

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

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

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

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

النطاق: أي

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

النطاق: أي

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

التركيز

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

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

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

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

النطاق: أي

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

النطاق: أي

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

النطاق: أي

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

النطاق: أي

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

النطاق: أي

تُنشئ مجموعة بحث أو تُصنّف هذا المكوّن كمجموعة بحث.

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

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

النطاق: أي

يتم استخدام 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?,
    outsets: LayerOutsets
)

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 للعنصر عندما يكون الموضع العام للمحتوى قد تغيّر.

غير ذلك

النطاق: أي

اضبط تلميح الملء التلقائي باستخدام 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.

النطاق: أي
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 سيتم إنشاؤه لكل عنصر يتم تعديله.

النطاق: أي

توفّر contentColor لاستهلاك النصوص والرموز.

النطاق: أي
Modifier.depthEffect(depthEffect: DepthEffect?, shape: Shape)

تعرض هذه السمة الظلال الخاصة بعنصر depthEffect المقدَّم.

النطاق: أي

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

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

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

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

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

النطاق: أي

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

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

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

النطاق: أي

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

النطاق: أي

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

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

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

النطاق: أي

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

النطاق: أي

سيؤدي ذلك إلى ربط 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 مقارنةً بعقدة التنسيق الحالية.

النطاق: أي

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

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

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

النطاق: أي
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
)

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

النطاق: أي
@Composable
Modifier.oneHandedGesture(
    action: GestureAction,
    priority: GesturePriority,
    enabledInAmbient: Boolean,
    interactionSource: MutableInteractionSource?,
    onGesture: suspend () -> Unit
)

تسجيل معالج إيماءات

النطاق: أي
Modifier.oneHandedGesture(
    action: GestureAction,
    key: String,
    priority: GesturePriority,
    enabledInAmbient: Boolean,
    interactionSource: MutableInteractionSource?,
    onGesture: suspend () -> 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 للمساعدة في إنشاء مكوّنات مخصّصة لإعادة التحميل بالسحب.

النطاق: أي
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 لأحد المكوّنات باعتراض أحداث مفاتيح الأجهزة قبل إرسالها إلى لوحة المفاتيح البرمجية.

النطاق: أي

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

النطاق: أي

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

النطاق: أي
@Composable
Modifier.surface(
    enabled: Boolean,
    shape: Shape,
    color: Color,
    contentColor: Color,
    depthEffect: SurfaceDepthEffect?,
    border: BorderStroke?,
    interactionSource: InteractionSource?
)

السطح هو وحدة أساسية في Glimmer.

النطاق: أي

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

النطاق: أي

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

النطاق: أي

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

النطاق: أي

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

النطاق: أي

Modifier يتحكّم في إمكانية رؤية "التصميم" الذي يتم تطبيقه عليه.

النطاق: أي

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

النطاق: أي

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

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

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

النطاق: أي

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

النطاق: SharedTransitionScope
Modifier.renderInSharedTransitionScopeOverlay(
    zIndexInOverlay: Float,
    renderInOverlay: () -> Boolean
)

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

النطاق: SharedTransitionScope
Modifier.sharedBounds(
    sharedContentState: SharedTransitionScope.SharedContentState,
    animatedVisibilityScope: AnimatedVisibilityScope,
    enter: EnterTransition,
    exit: ExitTransition,
    boundsTransform: BoundsTransform,
    resizeMode: SharedTransitionScope.ResizeMode,
    placeholderSize: SharedTransitionScope.PlaceholderSize,
    renderInOverlayDuringTransition: Boolean,
    zIndexInOverlay: Float,
    clipInOverlayDuringTransition: SharedTransitionScope.OverlayClip
)

sharedBounds هو معدِّل يضع علامة على التنسيق باستخدام SharedContentState.key، بحيث يؤدي إدخال الحدود المشتركة للمفتاح نفسه والخروج منها إلى مشاركة الحدود المتحركة والمتغيرة باستمرار أثناء تغيير التنسيق.

النطاق: SharedTransitionScope
Modifier.sharedElement(
    sharedContentState: SharedTransitionScope.SharedContentState,
    animatedVisibilityScope: AnimatedVisibilityScope,
    boundsTransform: BoundsTransform,
    placeholderSize: SharedTransitionScope.PlaceholderSize,
    renderInOverlayDuringTransition: Boolean,
    zIndexInOverlay: Float,
    clipInOverlayDuringTransition: SharedTransitionScope.OverlayClip
)

sharedElement هو معدِّل يضع علامة على تنسيق باستخدام SharedContentState.key، بحيث يؤدي إدخال العناصر المشترَكة التي لها المفتاح نفسه والخروج منها إلى مشاركة الحدود المتحركة والمتغيرة باستمرار أثناء تغيير التنسيق.

النطاق: SharedTransitionScope
Modifier.sharedElementWithCallerManagedVisibility(
    sharedContentState: SharedTransitionScope.SharedContentState,
    visible: Boolean,
    boundsTransform: BoundsTransform,
    placeholderSize: SharedTransitionScope.PlaceholderSize,
    renderInOverlayDuringTransition: Boolean,
    zIndexInOverlay: Float,
    clipInOverlayDuringTransition: SharedTransitionScope.OverlayClip
)

sharedElementWithCallerManagedVisibility هو معدِّل يضع علامة على تنسيق باستخدام SharedContentState.key، بحيث يؤدي إدخال العناصر المشترَكة التي لها المفتاح نفسه والخروج منها إلى مشاركة الحدود المتحركة والمتغيرة باستمرار أثناء تغيير التنسيق.

النطاق: SharedTransitionScope
open

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

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

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

النطاق: PaneScaffoldScope

يحدّد معدِّل العرض هذا هوامش اللوحة المرتبطة وفقًا لـ RectRulers المقدَّمة كإزاحات داخلية.

النطاق: PaneScaffoldScope

تحدّد أداة التعديل هذه هوامش اللوحة المرتبطة وفقًا للهوامش الثابتة المحدّدة وRectRulers المقدَّمة كإضافات، إن وُجدت.

Padding

النطاق: أي
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.onIndirectPointerGesture(
    enabled: Boolean,
    onSwipeForward: (() -> Unit)?,
    onSwipeBackward: (() -> Unit)?,
    onClick: (() -> Unit)?
)

Modifier يرصد إيماءات النقر والسحب الأفقي العالية المستوى من مصدر IndirectPointerEvent.

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

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

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

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

النطاق: أي

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

النطاق: أي

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

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

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

الموضع

النطاق: أي

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

النطاق: أي

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

النطاق: أي

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

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

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

النطاق: TabRowDefaults

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

التمرير

النطاق: أي

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

النطاق: أي
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?
)

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

النطاق: أي
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.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.scrollableArea(
    state: ScrollableState,
    orientation: Orientation,
    enabled: Boolean,
    reverseScrolling: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?,
    bringIntoViewSpec: BringIntoViewSpec?
)

ضبط أحد المكوّنات ليعمل كمساحة قابلة للتمرير

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

ضبط أحد المكوّنات ليعمل كمساحة قابلة للتمرير

النطاق: أي
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 واحد.

النطاق: أي
@Composable
Modifier.scrollbar(
    state: ScrollIndicatorState?,
    orientation: Orientation,
    thumbColor: Color,
    trackColor: Color,
    thickness: Dp,
    thumbMinLength: Dp,
    thumbMaxLengthFraction: @FloatRange(from = 0.0, to = 1.0) Float,
    isFadeEnabled: Boolean,
    fadeDurationMillis: Int,
    fadeDelayMillis: Int,
    mainAxisTrackInset: Dp,
    crossAxisTrackInset: Dp
)

شريط تمرير يمثّل موضع التمرير الحالي لأحد المكوّنات القابلة للتمرير

النطاق: أي

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

معاني

النطاق: أي

يحتوي على 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.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 بكسل مستقل الكثافة على الأقل لتجنُّب الالتباس في التفاعلات باللمس إذا كان قياس العنصر أصغر.

النطاق: أي

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

النطاق: أي

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

النطاق: أي
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 بالضبط.

النطاق: أي

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

النطاق: أي

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

النطاق: أي

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

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

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

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

يجب أن يتراوح عرض المحتوى بين minWidth وmaxWidth وحدة بكسل مستقلة عن الكثافة، وأن يتراوح ارتفاع المحتوى بين minHeight وmaxHeight وحدة بكسل مستقلة عن الكثافة.

النطاق: أي

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

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

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

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

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

النطاق: أي

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

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

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

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

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

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

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

النطاق: أي
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

النطاق: أي

عنصر تعديل مناسب لاحتساب الارتفاع المحوَّل باستخدام 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 محدّد

النطاق: SharedTransitionScope

تتيح السمة skipToLookaheadSize للّوحة قياس العنصر التابع باستخدام قيود البحث المسبق، وبالتالي يتم عرض العنصر التابع كما لو كانت عملية الانتقال قد انتهت.

النطاق: 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

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

النطاق: PaneScaffoldScope

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

النطاق: PaneScaffoldScope
Modifier.preferredHeight(
    proportion: @FloatRange(from = 0.0, to = 1.0) Float
)

يحدّد هذا المعدِّل الارتفاع المفضّل للوحة كنسبة من الارتفاع الإجمالي للوحة العرض.

النطاق: PaneScaffoldScope
Modifier.preferredWidth(proportion: @FloatRange(from = 0.0, to = 1.0) Float)

يحدّد هذا المعدِّل العرض المفضّل للوحة كنسبة من العرض الإجمالي للوحة العرض.

النطاق: PaneScaffoldScope

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

الاختبار

النطاق: أي

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

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

النطاق: أي
Modifier.rotate(degrees: 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
)

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