About

实现类似窗口的效果（Layer），支持设置目标，可以让Layer显示在目标的指定位置。
详细介绍可以看这里

演示效果

Layer容器

AppTheme {
  // 添加layer容器
  LayerContainer {
    Content()
  }
}

普通Layer

/**
 * 创建Layer
 *
 * @param attach 是否添加Layer，true-添加；false-移除
 * @param onDetachRequest [LayerDetach]触发的移除回调
 * @param debug 是否调试模式，tag:FLayer
 * @param detachOnBackPress 按返回键是否请求移除Layer，true-请求移除；false-请求不移除；null-不处理返回键逻辑，默认true
 * @param detachOnTouchBackground 触摸背景区域是否请求移除Layer，true-请求移除；false-不请求移除；null-不处理，事件会透过背景，默认false
 * @param backgroundColor 背景颜色
 * @param alignment 对齐容器位置
 * @param transition 动画（非响应式）
 * @param zIndex [Modifier.zIndex]
 * @param content 内容
 */
@Composable
fun Layer(
  attach: Boolean,
  onDetachRequest: (LayerDetach) -> Unit,
  debug: Boolean = false,
  detachOnBackPress: Boolean? = true,
  detachOnTouchBackground: Boolean? = false,
  backgroundColor: Color = Color.Black.copy(alpha = 0.3f),
  alignment: Alignment = Alignment.Center,
  transition: LayerTransition? = null,
  zIndex: Float = 0f,
  content: @Composable LayerContentScope.() -> Unit,
)

目标Layer

/**
 * 创建TargetLayer
 *
 * @param target 要对齐的目标
 * @param attach 是否添加Layer，true-添加；false-移除
 * @param onDetachRequest [LayerDetach]触发的移除回调
 * @param debug 是否调试模式，tag:FLayer
 * @param detachOnBackPress 按返回键是否请求移除Layer，true-请求移除；false-不请求移除；null-不处理返回键逻辑，默认值true
 * @param detachOnTouchBackground 触摸背景区域是否请求移除Layer，true-请求移除；false-不请求移除；null-不处理，事件会透过背景，默认值false
 * @param backgroundColor 背景颜色
 * @param alignment 对齐目标位置
 * @param alignmentOffsetX 对齐目标X方向偏移量
 * @param alignmentOffsetY 对齐目标Y方向偏移量
 * @param smartAlignments 智能对齐目标位置（非响应式），null-关闭智能对齐；非null-开启智能对齐。
 * 开启之后，如果默认的[alignment]导致内容溢出会使用[smartAlignments]提供的位置按顺序查找溢出最小的位置
 * @param clipBackgroundDirection 裁切背景的方向[Directions]（非响应式）
 * @param transition 动画（非响应式）
 * @param zIndex [Modifier.zIndex]
 * @param content 内容
 */
@Composable
fun TargetLayer(
  target: LayerTarget?,
  attach: Boolean,
  onDetachRequest: (LayerDetach) -> Unit,
  debug: Boolean = false,
  detachOnBackPress: Boolean? = true,
  detachOnTouchBackground: Boolean? = false,
  backgroundColor: Color = Color.Black.copy(alpha = 0.3f),
  alignment: TargetAlignment = TargetAlignment.Center,
  alignmentOffsetX: TargetAlignmentOffset? = null,
  alignmentOffsetY: TargetAlignmentOffset? = null,
  smartAlignments: SmartAliments? = null,
  clipBackgroundDirection: Directions? = null,
  transition: LayerTransition? = null,
  zIndex: Float = 0f,
  content: @Composable LayerContentScope.() -> Unit,
)

要对齐的目标

@Immutable
sealed interface LayerTarget {
  /** 以[tag]为目标 */
  data class Tag(val tag: String?) : LayerTarget

  /** 以[offset]为目标 */
  data class Offset(val offset: IntOffset?) : LayerTarget
}

目标对齐位置

enum class TargetAlignment {
  /** 顶部开始方向对齐 */
  TopStart,
  /** 顶部中间对齐 */
  TopCenter,
  /** 顶部结束方向对齐 */
  TopEnd,
  /** 顶部对齐，不计算x坐标，默认x坐标为0 */
  Top,

  /** 底部开始方向对齐 */
  BottomStart,
  /** 底部中间对齐 */
  BottomCenter,
  /** 底部结束方向对齐 */
  BottomEnd,
  /** 底部对齐，不计算x坐标，默认x坐标为0 */
  Bottom,

  /** 开始方向顶部对齐 */
  StartTop,
  /** 开始方向中间对齐 */
  StartCenter,
  /** 开始方向底部对齐 */
  StartBottom,
  /** 开始方向对齐，不计算y坐标，默认y坐标为0 */
  Start,

  /** 结束方向顶部对齐 */
  EndTop,
  /** 结束方向中间对齐 */
  EndCenter,
  /** 结束方向底部对齐 */
  EndBottom,
  /** 结束方向对齐，不计算y坐标，默认y坐标为0 */
  End,

  /** 中间对齐 */
  Center,
}