רשימת המשתנים של Compose

פעולות

היקף: כל
<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
)

הפונקציה הזו הוצאה משימוש. ה-API של Material's Swipeable הוחלף ב-API של Foundation's AnchoredDraggable.

היקף: כל
@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
)

הגדרת רכיב כך שניתן להפעיל או להשבית אותו באמצעות אירועי קלט ואירועי נגישות עם שלושה מצבים: On (מופעל), Off (מושבת) ו-Indeterminate (לא ברור).

היקף: כל
Modifier.triStateToggleable(
    state: ToggleableState,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

הגדרת רכיב כך שניתן להפעיל או להשבית אותו באמצעות אירועי קלט ואירועי נגישות עם שלושה מצבים: מופעל, מושבת ולא מוגדר.

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.

היקף: כל
@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>?
)

המשנה הזה יוצר אנימציה של הופעת הפריט (fade in), היעלמות הפריט (fade out) ושינויים במיקום (כמו סידור מחדש של פריטים).

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

המשנה הזה יוצר אנימציה של הופעת הפריט (fade in), היעלמות הפריט (fade out) ושינויים במיקום (כמו סידור מחדש של פריטים).

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

המשנה הזה יוצר אנימציה של הופעת הפריט (fade in), היעלמות הפריט (fade out) ושינויים במיקום (כמו סידור מחדש של פריטים).

גבול

היקף: כל
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 הזה לרכיב כדי להגדיר אותו כרכיב שאפשר להתמקד בו.

היקף: כל
Modifier. focusOrder(focusOrderReceiver: FocusOrder.() -> Unit)

הפונקציה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-focusProperties()‎

היקף: כל
Modifier. focusOrder(focusRequester: FocusRequester)

הפונקציה הזו הוצאה משימוש. במקומה צריך להשתמש ב-focusRequester()‎

היקף: כל
Modifier. focusOrder(
    focusRequester: FocusRequester,
    focusOrderReceiver: FocusOrder.() -> Unit
)

הפונקציה הזו הוצאה משימוש. במקום זאת, צריך להשתמש בפונקציות focusProperties()‎ ו-focusRequester()‎.

היקף: כל

המשנה הזה מאפשר לכם לציין מאפיינים שנגישים ל-focusTargets בהמשך שרשרת המשנים או בצמתים של פריסות צאצא.

היקף: כל

מוסיפים את ה-modifier הזה לרכיב כדי לבקש שינויים במיקוד.

היקף: כל

אפשר להשתמש במעבד הזה כדי לשמור את המיקוד ולהחזיר אותו לקבוצת מיקוד.

היקף: כל

הפונקציה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-focusRestorer(FocusRequester)‎

היקף: כל

יוצר קבוצת מיקוד או מסמן את הרכיב הזה כקבוצת מיקוד.

היקף: כל
Modifier.focusable(
    enabled: Boolean,
    interactionSource: MutableInteractionSource?
)

הגדרת הרכיב כך שניתן יהיה להתמקד בו באמצעות מערכת המיקוד או אירוע הנגישות 'מיקוד'.

היקף: כל
Modifier.onFocusedBoundsChanged(
    onPositioned: (LayoutCoordinates?) -> Unit
)

הפונקציה onPositioned מופעלת בכל פעם שהגבולות של האזור שמוצג כרגע משתנים.

היקף: כל

hierarchicalFocusGroup משמשת להוספת הערות לרכיבים קומפוזביליים באפליקציה, כדי שנוכל לעקוב אחרי החלק הפעיל של הקומפוזיציה.

היקף: כל

ה-Modifier הזה משמש בשילוב עם hierarchicalFocusGroup ויבקש מיקוד ברכיב הבא שאפשר להתמקד בו כשצריך (כלומר, הוא צריך להיות לפני הרכיב הזה בשרשרת ה-Modifier).

גרפיקה

היקף: כל

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 של הרכיב כשהמיקום הגלובלי של התוכן עשוי להשתנות.

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 dp של מרווח נוסף לאורך כל קצה של התוכן, בצד שמאל, בצד ימין, למעלה ולמטה.

היקף: כל
Modifier.padding(paddingValues: PaddingValues)

הערך PaddingValues יוחל על הרכיב כרווח נוסף לאורך כל קצה של התוכן: בצד שמאל, בצד ימין, בחלק העליון ובחלק התחתון.

היקף: כל
Modifier.padding(horizontal: Dp, vertical: Dp)

החלת מרווח של horizontal dp לאורך הקצוות הימני והשמאלי של התוכן, ומרווח של vertical dp לאורך הקצוות העליון והתחתון.

היקף: כל
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.

Pointer

היקף: כל
Modifier.onIndirectPointerGesture(
    enabled: Boolean,
    onClick: () -> Unit,
    onSwipeForward: () -> Unit,
    onSwipeBackward: () -> Unit
)

Modifier שמאזין למקור IndirectPointerEvent ומזהה תנועות ברמה גבוהה.

היקף: כל
Modifier.pointerHoverIcon(
    icon: PointerIcon,
    overrideDescendants: Boolean
)

משנה שמאפשר למפתח להגדיר סמל של מצביע שיוצג כשהסמן מוצב מעל הרכיב.

היקף: כל
Modifier.pointerInteropFilter(
    requestDisallowInterceptTouchEvent: RequestDisallowInterceptTouchEvent?,
    onTouchEvent: (MotionEvent) -> Boolean
)

‫PointerInputModifier מיוחד שנותן גישה ל-MotionEvent הבסיסיים שנשלחו במקור ל-Compose.

היקף: כל
Modifier. pointerInput(block: suspend PointerInputScope.() -> Unit)

הפונקציה הזו הוצאה משימוש. הפרמטר Modifier.pointerInput צריך לספק פרמטר 'key' אחד או יותר שמגדירים את הזהות של ה-modifier וקובעים מתי צריך לבטל את שגרת ההמשך (coroutine) הקודמת של עיבוד הקלט ולהפעיל אפקט חדש עבור המפתח החדש.

היקף: כל

יוצרים משנה לעיבוד קלט של מצביע בתוך האזור של הרכיב ששונה.

היקף: כל
Modifier.pointerInput(vararg keys: Any?, block: PointerInputEventHandler)

יוצרים משנה לעיבוד קלט של מצביע בתוך האזור של הרכיב ששונה.

היקף: כל
Modifier.pointerInput(
    key1: Any?,
    key2: Any?,
    block: PointerInputEventHandler
)

יוצרים משנה לעיבוד קלט של מצביע בתוך האזור של הרכיב ששונה.

מיקום

היקף: כל

הזחת התוכן ב-offset פיקסלים.

היקף: כל

הזחת התוכן ב-(x dp, y dp).

היקף: כל
Modifier.offset(offset: Density.() -> IntOffset)

הזחת התוכן ב-offset פיקסלים.

היקף: כל
Modifier.offset(x: Dp, y: Dp)

הזחת התוכן ב-(x dp, y dp).

היקף: 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?
)

משנה שמשייך אירועים של סיבוב למאגרי תוכן שאפשר לגלול בהם, כמו Column,‏ 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. 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.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 יחיד.

היקף: כל

ההגדרה קובעת את השימוש במקלדת הווירטואלית כגלילה מוטמעת ב-Android R ואילך.

גודל

היקף: כל
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

המשנה הזה מנפיש את הגודל שלו כשהגודל של המשנה הצאצא שלו (או של ה-composable הצאצא אם הוא כבר בסוף השרשרת) משתנה.

היקף: כל
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    alignment: Alignment,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

המשנה הזה מנפיש את הגודל שלו כשהגודל של המשנה הצאצא שלו (או של ה-composable הצאצא אם הוא כבר בסוף השרשרת) משתנה.

היקף: כל
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.

היקף: כל

אם האלמנט קטן יותר, המערכת שומרת לפחות 48dp כדי להבחין בין אינטראקציות של מגע.

היקף: כל

אם האלמנט קטן יותר, המערכת שומרת לפחות 48dp כדי להבחין בין אינטראקציות של מגע.

היקף: כל

אם האלמנט קטן יותר, המערכת שומרת לפחות 48dp כדי להבחין בין אינטראקציות של מגע.

היקף: כל
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)

מצהירים על הגודל המועדף של התוכן כ-sizedp בריבוע בדיוק.

היקף: כל
Modifier.size(size: DpSize)

מצהירים שהגודל המועדף של התוכן הוא בדיוק size.

היקף: כל
Modifier.size(width: Dp, height: Dp)

מציינים את הגודל המועדף של התוכן בדיוק widthdp על heightdp.

היקף: כל
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 הוא true, גם בלי להתחשב במדידה הנכנסת maximum height constraint.

היקף: כל
Modifier.wrapContentSize(align: Alignment, unbounded: Boolean)

התוכן יוצג בגודל הרצוי בלי להתחשב במגבלות של המדידה הנכנסת minimum width או minimum height, ואם unbounded הוא true, גם בלי להתחשב במגבלות המקסימליות הנכנסות.

היקף: כל
Modifier.wrapContentWidth(
    align: Alignment.Horizontal,
    unbounded: Boolean
)

התוכן יוצג ברוחב הרצוי בלי להתחשב בערך המדידה הנכנס minimum width constraint, ואם unbounded הוא true, גם בלי להתחשב בערך המדידה הנכנס 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 שצוין.

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
Modifier.exposedDropdownSize(matchAnchorWidth: Boolean)

משנה שצריך להחיל על תפריט שמוצב בתוך ExposedDropdownMenuBoxScope.

העיבוד הזה מציין את הגובה המועדף של חלונית ב-Dps, וההטמעה של ה-scaffold של החלונית תנסה להתאים את הגובה הזה כשהחלונית המשויכת מוצגת כחלונית עם סידור מחדש או כחלונית צפה.

Modifier.preferredHeight(
    proportion: @FloatRange(from = 0.0, to = 1.0) Float
)

המשנה הזה מציין את הגובה המועדף של החלונית כחלק יחסי מהגובה הכולל של ה-Scaffold.

Modifier.preferredWidth(proportion: @FloatRange(from = 0.0, to = 1.0) Float)

המגדיר הזה מציין את הרוחב המועדף של חלונית כחלק יחסי מרוחב הפיגום הכולל.

המשנה הזה מציין את הרוחב המועדף של חלונית ב-Dp, וההטמעה של תבנית החלונית תנסה כמיטב יכולתה להתאים לרוחב הזה כשהחלונית המשויכת מוצגת כחלונית קבועה, כלומר חלונית שלא מתרחבת כדי למלא את הרווחים שנותרו.

בדיקות

היקף: כל

הוספת תג כדי לאפשר למצוא את הרכיב ששונה בבדיקות.

טרנספורמציות

היקף: כל
Modifier.rotate(degrees: Float)

ההגדרה הזו קובעת את מידת הסיבוב של התצוגה סביב מרכז הרכיב הקומפוזבילי.

היקף: כל
Modifier.scale(scale: Float)

משנים את קנה המידה של התוכן בציר האופקי ובציר האנכי באופן אחיד באותו גורם קנה מידה.

היקף: כל
Modifier.scale(scaleX: Float, scaleY: Float)

קנה המידה של התוכן של רכיב ה-Composable לפי גורמי קנה המידה הבאים לאורך הציר האופקי והציר האנכי בהתאמה.

היקף: כל
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 שתורכב לכל רכיב שהיא משנה.

היקף: כל

מספק contentColor לטקסט ולסמלים לצריכה.

היקף: כל
Modifier.depth(depth: Depth?, shape: Shape)

הפונקציה יוצרת צללים עבור depth שצוין.

היקף: כל
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
)

משנה שמאפשר קבלה ממחוות גרירה ושחרור.

היקף: כל

הפונקציה הזו הוצאה משימוש. שימוש ב-systemGestureExclusion

היקף: כל

הפונקציה הזו הוצאה משימוש. שימוש ב-systemGestureExclusion

היקף: כל

הגדרת קצב פריימים מבוקש ב-Composable

היקף: כל
Modifier.preferredFrameRate(
    frameRate: @FloatRange(from = 0.0, to = 360.0) Float
)

הגדרת קצב פריימים מבוקש ב-Composable

היקף: כל
Modifier.handwritingDetector(callback: () -> Unit)

מגדיר רכיב שיפעל כמזהה כתב יד, שיזהה כתב יד באמצעות סטיילוס ויעביר את הטיפול בטקסט המזוהה לרכיב אחר.

היקף: כל

הגדרת רכיב שיפעל כמטפל בכתב יד באמצעות עט סטיילוס, שיכול לטפל בקלט טקסט מסשן של כתב יד שהופעל על ידי כתב יד באמצעות עט סטיילוס בגלאי כתב יד.

היקף: כל
Modifier.hoverable(
    interactionSource: MutableInteractionSource,
    enabled: Boolean
)

הגדרת רכיב כך שאפשר יהיה להעביר מעליו את העכבר באמצעות אירועי כניסה/יציאה של מצביע.

היקף: כל
inline
Modifier. inspectable(
    noinline inspectorInfo: InspectorInfo.() -> Unit,
    factory: Modifier.() -> Modifier
)

הפונקציה הזו הוצאה משימוש. ה-API הזה יוצר יותר ביטולים של שינויים ממה שנדרש, ולכן לא מומלץ להשתמש בו.

היקף: כל

שינוי שגורם למסך המכשיר להישאר דולק כל עוד הוא חלק מהקומפוזיציה בפלטפורמות נתמכות.

היקף: כל

הפעולה הזו תמפה את 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 ביחס לצומת הפריסה הנוכחי.

היקף: כל

‫Modifier שאפשר להשתמש בו כדי לצרוך ModifierLocals שסופקו על ידי modifiers אחרים משמאל ל-modifier הזה, או מעל ה-modifier הזה בעץ הפריסה.

היקף: כל
<T : Any?> Modifier.modifierLocalProvider(
    key: ProvidableModifierLocal<T>,
    value: () -> T
)

‫Modifier שאפשר להשתמש בו כדי לספק ModifierLocal שאפשר לקרוא על ידי modifiers אחרים מימין ל-modifier הזה, או modifiers שהם צאצאים של צומת הפריסה שאליו ה-modifier הזה מצורף.

היקף: כל
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
)

פונקציה שרושמת קריאה חוזרת (callback) כדי לעקוב אחרי הצומת ולבדוק אם הוא נמצא באזור התצוגה של החלון או לא.

היקף: כל
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholder(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

מצייר צורת placeholder מעל רכיב שאפשר להרכיב ומפעיל אנימציה של אפקט מחיקה כדי להסיר את ה-placeholder.

היקף: כל
@Composable
Modifier.placeholder(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

המשנה placeholder של Modifier מצייר צורה של שלד מעל רכיב, במצבים שבהם אין תוכן זמני (כמו נתונים במטמון).

היקף: כל
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholderShimmer(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

משנה לציור אפקט נצנוץ של placeholder מעל רכיב.

היקף: כל
@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)

‫Calls watcher עם כל MotionEvent שהאזור של פריסת המסך או כל צאצא pointerInput מקבל.

היקף: כל

מסמנים את מלבן הפריסה כהעדפה להישאר מחוץ לחלונות צפים.

היקף: כל

מסמנים מלבן בקואורדינטות של הפריסה המקומית, ומשתדלים לא לכלול חלונות צפים.

היקף: כל

משנה את המיקום ומשנה את הגודל של אינדיקטור של משיכה לרענון על סמך PullRefreshState.

היקף: כל

משנה גלילה מקונן שמספק אירועי גלילה ל-state.

היקף: כל
@ExperimentalMaterialApi
Modifier.pullRefresh(
    onPull: (pullDelta: Float) -> Float,
    onRelease: suspend (flingVelocity: Float) -> Float,
    enabled: Boolean
)

משנה גלילה מקונן שמספק קריאות חוזרות (callback) של onPull ו-onRelease כדי לסייע בבניית רכיבי רענון מותאמים אישית.

היקף: כל
Modifier.pullToRefresh(
    isRefreshing: Boolean,
    state: PullToRefreshState,
    enabled: Boolean,
    threshold: Dp,
    onRefresh: () -> Unit
)

‫Modifier שמוסיף גלילה מקוננת לקונטיינר כדי לתמוך במחוות של משיכה לרענון.

היקף: כל

הגדרת הצומת הנוכחי וכל צומתי הצאצא כרכיב לקבלת תוכן.

היקף: כל

התוכן מתאים ל-rulers.

היקף: כל

אם לאחד מהערכים Ruler ב-rulers יש ערך בתוך הגבולות של הפריסה, התוכן יותאם לערך Ruler ולשוליים.

היקף: כל
Modifier.sensitiveContent(isContentSensitive: Boolean)

המשנה הזה מציין שהקומפוזיציה מעבדת תוכן רגיש (כלומר, שם משתמש, סיסמה, כרטיס אשראי וכו') במסך, ושהתוכן צריך להיות מוגן במהלך שיתוף המסך בסביבות נתמכות.

היקף: כל
Modifier.onInterceptKeyBeforeSoftKeyboard(
    onInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

הוספת modifier לפרמטר modifier של רכיב תאפשר לו ליירט אירועים של מקשי חומרה לפני שהם נשלחים למקלדת וירטואלית.

היקף: כל
Modifier.onPreInterceptKeyBeforeSoftKeyboard(
    onPreInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

הוספת modifier לפרמטר modifier של רכיב תאפשר לו ליירט אירועים של מקשי חומרה לפני שהם נשלחים למקלדת וירטואלית.

היקף: כל

הפונקציה הזו הוצאה משימוש. המשנה styleable() חייב לספק ערך אחד או יותר של הפרמטר style.

היקף: כל

‫Modifier שיוצר אזור עם סגנון שמוגדר על ידי האובייקט Style שצירפתם לרכיב הזה.

היקף: כל

‫Modifier שיוצר אזור עם סגנון שמוגדר על ידי האובייקט Style שצירפתם לרכיב הזה.

היקף: כל
@Composable
Modifier.surface(
    focusable: Boolean,
    shape: Shape,
    color: Color,
    contentColor: Color,
    depth: SurfaceDepth?,
    border: BorderStroke?,
    interactionSource: MutableInteractionSource?
)

משטח הוא אבן בניין בסיסית ב-Glimmer.

היקף: כל
@Composable
Modifier.surface(
    enabled: Boolean,
    shape: Shape,
    color: Color,
    contentColor: Color,
    depth: SurfaceDepth?,
    border: BorderStroke?,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

משטח הוא אבן בניין בסיסית ב-Glimmer.

היקף: כל
Modifier. edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

הפונקציה הזו הוצאה משימוש. הפונקציה SwipeToDismiss הועברה אל androidx.wear.compose.foundation.

היקף: כל

התכונה הזו מחריגה את המלבן של הפריסה מתנועה מובנית במערכת.

היקף: כל

החרגה של מלבן בקואורדינטות של פריסה מקומית מתנועה מובנית במערכת.

היקף: כל

מוסיף builder להפעלה כשמוצג תפריט ההקשר של הטקסט בהיררכיה הזו.

היקף: כל

מוסיף filter להפעלה כשמוצג תפריט ההקשר של הטקסט בהיררכיה הזו.

היקף: כל
Modifier.visible(visible: Boolean)

Modifier ששולט על החשיפה של הפריסה שהוא מוחל עליה.

היקף: כל

הוספת שוליים פנימיים שלא נוספו עדיין על ידי שוליים פנימיים אחרים, בדומה ל-windowInsetsPadding, בלי להוסיף ריווח.

היקף: כל

השימוש ב-paddingValues כהזחות כאילו הריווח נוסף ללא קשר להזחות.

היקף: כל
Modifier.onConsumedWindowInsetsChanged(
    block: (consumedWindowInsets: WindowInsets) -> Unit
)

הקריאות block עם WindowInsets שנצרכו, על ידי consumeWindowInsets או אחד מהמשנים של הריווח הפנימי, כמו imePadding.

היקף: כל

המערכת תחשב מחדש את WindowInsets על סמך הגודל והמיקום.

Modifier.renderInSharedTransitionScopeOverlay(
    zIndexInOverlay: Float,
    renderInOverlay: () -> Boolean
)

התוכן מוצג בשכבת העל של 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, כך שהזנת גבולות משותפים של אותו מקש ויציאה מהם משתפים את הגבולות המונפשים שמשתנים באופן רציף במהלך שינוי הפריסה.

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

sharedElement הוא משנה שתיוג פריסה עם SharedContentState.key, כך שהזנה ויציאה של רכיבים משותפים של אותו מפתח חולקים את הגבולות המונפשים והמשתנים ללא הפסקה במהלך שינוי הפריסה.

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

sharedElementWithCallerManagedVisibility הוא משנה שתיוג הפריסה שלו הוא SharedContentState.key, כך שכשנכנסים לרכיבים משותפים של אותו מקש ויוצאים מהם, הגבולות המונפשים והמשתנים ללא הפסקה משותפים במהלך שינוי הפריסה.

open

משנה (modifier) שמעגן פריסה במיקום היעד שהתקבל מהמעבר הצפוי במהלך מעברים של רכיבים משותפים.

הפונקציה הזו הוצאה משימוש. שימוש בעומס יתר שמקבל פרמטרים של ExposedDropdownMenuAnchorType ו-enabled

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

משנה שצריך להחיל על אלמנט בתוך ExposedDropdownMenuBoxScope, בדרך כלל שדה טקסט או סמל בתוך שדה הטקסט.

המשנה הזה מציין את השוליים של החלונית המשויכת בהתאם לערך RectRulers שסופק כהזחות.

@ExperimentalMaterial3AdaptiveApi
@Composable
Modifier.paneMargins(
    fixedMargins: PaddingValues,
    vararg insets: RectRulers
)

המשנה הזה מציין את השוליים של החלונית המשויכת לפי שוליים קבועים שצוינו ואת RectRulers שסופק כשוליים פנימיים, אם יש כאלה.