WrappingHStack

KO | EN

gitlite — search

#python #ai #llm #go #deep-learning #docker #macos #awesome #vue #pytorch #security #mcp #ios #open-source

(★ 563)

A SwiftUI HStack with the ability to wrap contained elements

File Explorer

Download Latest Version (.zip)

- - bug_report.md
  - feature_request.md
- - main.yml
- FUNDING.yml
- - ContentManager.swift
  - InternalWrappingHStack.swift
  - NewLine.swift
  - ViewType.swift
  - WrappingHStack.swift
- - ExampleView.swift
  - Info.plist
  - WrappingHStackExampleApp.swift
- - project.pbxproj
- - WrappingHStackExampleUITests.swift
- - ExampleView.swift
  - WrappingHStackExample.entitlements
  - WrappingHStackExampleApp.swift
- - project.pbxproj
.gitignore
example.png
LICENSE
Package.swift
README.md
WrappingHStack.podspec

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WrappingHStack

WrappingHStack is a UI Element that works in a very similar way to HStack, but automatically positions overflowing elements on next lines.

## Example

![Example](https://raw.githubusercontent.com/dkk/WrappingHStack/main/example.png)
```swift
WrappingHStack {
    Text("WrappingHStack")
        .padding()
        .font(.title)
        .border(Color.black)
    
    Text("can handle different element types")
    
    Image(systemName: "scribble")
        .font(.title)
        .frame(width: 200, height: 20)
        .background(Color.purple)
    
    Text("and loop")
        .bold()
    
    WrappingHStack(1...20, id:\.self) {
        Text("Item: \($0)")
            .padding(3)
            .background(Rectangle().stroke())
    }.frame(minWidth: 250)
}
.padding()
.border(Color.black)
```

## Installation
Requirements iOS 13+

### Swift Package Manager 
1. In Xcode, open your project and navigate to File → Swift Packages → Add Package Dependency.
2. Paste the repository URL (https://github.com/dkk/WrappingHStack) and click Next.
3. For Rules, select version.
4. Click Finish.

### Swift Package
```swift
.package(url: "https://github.com/dkk/WrappingHStack", .upToNextMajor(from: "2.0.0"))
```

### Cocoapods
Simply add the following line to your `Podfile`:
```ruby
pod 'WrappingHStack'
```

## Usage

Import the WrappingHStack package to your view:
```swift
import WrappingHStack
```

use it like you would use HStack for single elements:
```swift
WrappingHStack {
    /* some views */
    NewLine() // Optional: Use NewLine to force the next element to be placed in a next line
    /* some more views */
}
```

or like a ForEach to loop over items:
```swift
WrappingHStack(1...30, id:\.self) {
    Text("Item: \($0)")
}
```

### Item positioning

You control the position of the items by using the parameter `alignment`, which sets the `HorizontalAlignment` of the items. I.e. leading, trailing or centered.

For even more convenience and flexibility, `WrappingHSTack` offers the parameter `spacing`, that defines how the spacing will be calculated. It can be one of the following types:
* `.constant`: for fixed spacing, each line starts with an item and the horizontal separation between any 2 items is the given value.
* `.dynamic`: to have the items fill the width of the WrappingHSTack. You can pass a minimal spacing.
* `.dynamicIncludingBorders` to fill the full width with equal spacing between items and from the items to the border. You can pass a minimal spacing.

## Known Issues

* [Issue #15](https://github.com/dkk/WrappingHStack/issues/15): Item sizes are calculated incorrectly when WrappingHStack has modifiers that change the size of its elements.
* [Issue #16](https://github.com/dkk/WrappingHStack/issues/26): Workaround needed when using `WrappingHStack` in a `NavigationLink` (iOS16 only).
* [Issue #10](https://github.com/dkk/WrappingHStack/issues/10): SPM cannot resolve the dependency (Xcode 11.3.1 only).

## Contribute
You can contribute to this project by helping me solve any [reported issues or feature requests](https://github.com/dkk/WrappingHStack/issues) and creating a pull request.

## Support
[Sponsor this project](https://github.com/sponsors/dkk) to get a reward and give me a moral boost. 
## License
WrappingHStack was originally developed by Daniel Klöck and is released under the [MIT License](LICENSE).

WrappingHStack

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

WrappingHStack

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README