Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SkyeHoefling/TabStrip
Tab Strip control for Xamarin.Forms
https://github.com/SkyeHoefling/TabStrip
tabstrip xamarin xamarin-forms xamarin-library xamarin-plugin
Last synced: about 1 month ago
JSON representation
Tab Strip control for Xamarin.Forms
- Host: GitHub
- URL: https://github.com/SkyeHoefling/TabStrip
- Owner: SkyeHoefling
- License: mit
- Created: 2017-10-23T01:22:20.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2020-08-24T17:21:35.000Z (almost 4 years ago)
- Last Synced: 2024-05-01T18:11:20.479Z (about 2 months ago)
- Topics: tabstrip, xamarin, xamarin-forms, xamarin-library, xamarin-plugin
- Language: C#
- Size: 5.53 MB
- Stars: 27
- Watchers: 3
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Lists
- awesome-xamarin-forms - TabStrip ★25
README
# TabStrip for Xamarin.Forms
Tab Strip control for Xamarin.Forms
## Screenshots
| iOS | Android | UWP |
|---------------------------|-----------------------------|---------------------------|
| |  | |
## Setup
* Available on NuGet: [](https://www.nuget.org/packages/TabStrip)
* Install into your PCL/.NET Standard and Client Projects
## Build
* [](https://ci.appveyor.com/project/ahoefling/tabstrip)
* CI NuGet Feed: [https://ci.appveyor.com/nuget/tabstrip](https://ci.appveyor.com/nuget/tabstrip)
### Platform Support
TabStrip is available for use in *Xamarin.Forms* only targetting the following supported platforms.
| Platform | Supported | Version |
|------------------|-----------|-------------|
| Xamarin.Android | Yes | API 15 + |
| Xamarin.iOS | Yes | iOS 10 + |
| Xamarin 10 UWP | Yes | 16299 + |
| macOS | No | |
| linux | No | |
| tvOS | No | |
| watchOS | No | |
## Usage ##
#### UWP (Known Issue) ####
Add CarouselView.FormsPlugin as a nuget reference otherwise it will not work
#### iOS, Droid and UWP ####
Initialize the renderers in your iOS and Android projects
```c#
Xamarin.Forms.Init();
TabStripRenderer.Init();
```
### XAML: ####
Add the namespace in the xmlns:
```xml
xmlns:plugin="clr-namespace:TabStrip.FormsPlugin.Abstractions;assembly=TabStrip.FormsPlugin.Abstractions"
```
Add the control:
```xml
```
Add the following code to your BindingContext. The `ItemsSource` property needs to be mapped to an `IEnumerable` where `TabModel` is provided in the `TabStrip.FormsPlugin.Abstractions` namespace.
```c#
BindingContext = new
{
Views = new ObservableCollection(new []
{
new TabModel
{
Header = new Tuple(new HeaderView(), new { Title = "Tab 1" }),
View = new Tuple(new HelloView(), new HelloPageModel())
},
new TabModel
{
Header = new Tuple(new HeaderView(), new { Title = "Tab 2" }),
View = new Tuple(new HelloView(), new HelloPageModel())
}
});
};
```
## Bindable Properties
| Property | Description | Default Value |
|-------------|-------------------------------------------------------------------------------------------------------------------------------------|----------------------------|
| Position | Gets or Sets current tab position of the tab strip. | `0` |
| ItemsSource | Gets or Sets the `IEnumerable` where the `TabModel` defines the Tab Name and the View/ViewModel relationship for each Tab | `null` |
| ShowArrows | Gets or Sets the `bool` value that determines if navigation arrows will appear on top of the content area | `fakse` |
| LeftArrow | Gets or Sets the `ImageSource` for the `LeftArrow` which is displayed when the tab can navigate left | Embedded Left Arrow Image |
| RightArrow | Gets or Sets the `ImageSource` for the `RightArrow` which is displayed when the tab can navigate right | Embedded Right Arrow Image |
## Roadmap
* [Minimal Viable Product (MVP)](https://github.com/ahoefling/TabStrip/wiki/Minimal-Viable-Product)
* Windows Support
* macOS Support
* linux Support
* Native Support
### Minimal Viable Product
* Implement basic cross-platform Tabstrip that supports Android and iOS via Xamarin.Forms
### Windows Support
* Implement Windows UWP support via Xamarin.Forms
### macOS Support
* Implement macOS support via Xamarin.Forms
### linux Support
* Implement linux support via Xamarin.Forms
### Native Support
* Implement Xamarin Navite support so it can be consumed in a Xamarin Native project instead of Xamarin.Forms. This will require a larger code re-write since it will be using Xamarin.Forms wrappers prior to this release
## Created By: [@Andrew_Hoefling](https://twitter.com/andrew_hoefling)
* Twitter: [@Andrew_Hoefling](https://twitter.com/andrew_hoefling)
* Blog: [andrewhoefling.com](http://www.andrewhoefling.com)
## History
* project started from this conversation: [https://github.com/alexrainman/CarouselView/issues/232#issuecomment-338496021](https://github.com/alexrainman/CarouselView/issues/232#issuecomment-338496021)
### Xamarin Dependencies
Thanks to other plugin creators to make this plugin possible
* [Carousel View](https://github.com/alexrainman/CarouselView)
### License
The MIT License (MIT) see License File