インスタンスメソッド


containerRelativeFrame(_:alignment:)


このビューを、最も近いコンテナを基準としたサイズで非表示のフレーム内に配置します。


iOS 17.0+ iPadOS 17.0+ macOS 14.0+ Mac Catalyst 17.0+

tvOS 17.0+ watchOS 10.0+ visionOS 1.0+   Beta  

func containerRelativeFrame(
_ axes: Axis.Set,
alignment: Alignment = .center
) -> some View





議論


この修飾子を使用して、最も近いコンテナのサイズに応じてビューの幅、高さ、またはその両方のサイズを指定します。以下のようなさまざまなものが "コンテナ" を表すことができます。


  • iPadOS または macOS ではビューを表示するウィンドウ、または iOS ではデバイスのスクリーン。

  • NavigationSplitView の列

  • NavigationStack

  • TabView のタブ

  • ScrollViewList などのスクロール可能なビュー

    1. ScrollView(.horizontal) {
    2. LazyHStack(spacing: 0.0) {
    3. ForEach(items) { item in
    4. Rectangle()
    5. .fill(.purple)
    6. .containerRelativeFrame([.horizontal, .vertical])
    7. }
    8. }
    9. }


    複数のビューがコンテナ内に表示されるように、containerRelativeFrame(_:count:span:spacing:alignment:) 修飾子を使用してビューのサイズを変更します。この修飾子を使用する場合は、count は、特定の軸内のコンテナサイズの長さを分割すべき行または列の合計数を指します。span は、変更されたビューが実際に占有する行または列の数を指します。したがって、要素のサイズは以下のように記述できます。


    1. let availableWidth = (containerWidth - (spacing * (count - 1)))
    2. let columnWidth = (availableWidth / count)
    3. let itemWidth = (columnWidth * span) + ((span - 1) * spacing)


    以下の例では、横軸に最も近いコンテナサイズのみを使用し、aspectRatio(_:contentMode:) 修飾子を使用して縦軸を決定できるようにしています。


    1. ScrollView(.horizontal) {
    2. LazyHStack(spacing: 10.0) {
    3. ForEach(items) { item in
    4. Rectangle()
    5. .fill(.purple)
    6. .aspectRatio(3.0 / 2.0, contentMode: .fit)
    7. .containerRelativeFrame(
    8. .horizontal, count: 4, span: 3, spacing: 10.0)
    9. }
    10. }
    11. }
    12. .safeAreaPadding(.horizontal, 20.0)


    ContainerRelativeFrame(_:alignment:_:) 修飾子を使用して独自のカスタムロジックを適用し、あなたのビューに最も近いコンテナのサイズを調整します。以下の例では、コンテナのフレームの幅が 3 で除算され、その値が紫色の長方形の幅として使用されます。


    1. Rectangle()
    2. .fill(.purple)
    3. .aspectRatio(1.0, contentMode: .fill)
    4. .containerRelativeFrame(
    5. .horizontal, alignment: .topLeading
    6. ) { length, axis in
    7. if axis == .vertical {
    8. return length / 3.0
    9. } else {
    10. return length / 5.0
    11. }
    12. }





    以下も見よ


    ビューのサイズに影響を与える


    func frame(width: CGFloat?, height: CGFloat?, alignment: Alignment) -> some View

    このビューを指定されたサイズで非表示のフレーム内に配置します。


    func frame(depth: CGFloat?, alignment: DepthAlignment) -> some View

    このビューを、指定された深さの非表示のフレーム内に配置します。

      Beta  


    func frame(minWidth: CGFloat?, idealWidth: CGFloat?, maxWidth: CGFloat?, minHeight: CGFloat?, idealHeight: CGFloat?, maxHeight: CGFloat?, alignment: Alignment) -> some View

    指定されたサイズ制約を持つ非表示のフレーム内にこのビューを配置します。


    func frame(minDepth: CGFloat?, idealDepth: CGFloat?, maxDepth: CGFloat?, alignment: DepthAlignment) -> some View

    指定された深度の制約を持つ非表示のフレーム内にこのビューを配置します。

      Beta  


    func containerRelativeFrame(Axis.Set, alignment: Alignment, (CGFloat, Axis) -> CGFloat) -> some View

    このビューを、最も近いコンテナを基準としたサイズで非表示のフレーム内に配置します。


    func containerRelativeFrame(Axis.Set, count: Int, span: Int, spacing: CGFloat, alignment: Alignment) -> some View

    このビューを、最も近いコンテナを基準としたサイズで非表示のフレーム内に配置します。


    func fixedSize() -> some View

    このビューを理想的なサイズに固定します。


    func fixedSize(horizontal: Bool, vertical: Bool) -> some View

    このビューを指定された大きさの理想的なサイズに固定します。


    func layoutPriority(Double) -> some View

    親レイアウトがその子にスペースを割り当てるべき優先順位を設定します。



    ベータ版ソフトウェア


    このドキュメントには、開発中の API または技術に関する予備情報が含まれています。この情報は変更される可能性があり、このドキュメントに従って実装されたソフトウェアは、最終的なオペレーティングシステムソフトウェアでテストする必要があります。


    Apple のベータ版ソフトウェアの使用について詳しく知る >














    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ