Forms9Patch 1.1.0

Xamarin Forms is great for developing apps on Android, iOS, and Universal Windows Platform (UWP) but it is missing some important features:
•Scalable images
•PCL and Shared Library, multi-screen / multi-resolution image management
•HTML formatted text for labels and buttons
•PCL and Shared Library custom font management

Android developers can use NinePatch bitmaps, the drawable directory naming convention, Html.FromHtml, and a bunch of complex file manipulations to address the image issue.  Likewise, iOS developers can use ResizeableImageWithCapInsets, the @2x, @3x, @4x file naming convention, and some 3rd party libraries for this purpose.  Forms9Patch enhances Xamarin Forms to make multi-resolution / multi-screen image management, custom fonts, and HTML text formatting easy for PCL apps for iOS and Android.

There is a newer version of this package available.
See the version list below for details.
Install-Package Forms9Patch -Version 1.1.0
dotnet add package Forms9Patch --version 1.1.0
<PackageReference Include="Forms9Patch" Version="1.1.0">
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Forms9Patch --version 1.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes New: SVGs are now valid image sources!  Fixed: Shape outlines are not always full thickness; Button.Clicked event requires double click to fire on Andriod. Fix: Android renderers use Android SDK calls not supported by Gingerbread; PCL.Utils.ApplicationStorageExtensions not using correct directory; Fix: Instantiation of popup, before App.MainPage set to Forms9Patch.RootPage, causes crash; iOS button text not always appearing; Fixed: Default padding not zero for Forms9Patch layouts (other than Frame); Changed: Forms9Patch.Frame is not longer obsolete; IPopup is public; Fix: Crash on older versions of Windows; Change: IPopup is public; Full UWP Support; UWP Release; Fixed: Android implementation of FormsGestures failing in Xamarin.Forms 2.4; Android implementation of popups not re-rendering correctly upon 3rd or 4th display;  Added: pre-alpha of the UWP implmentation of the following Forms9Patch elements: Image, ImageSource, AbsoluteLayout, ContentView, Frame, Grid, ManualLayout, RelativeLayout, StackLayout, ImageButton, MaterialButton, MaterialSegmentedControl, Segment, RootPage, ActivityIndicatorPopup, ModalPopup, PermissionPopup, Toast; Fixed: Size of last segment of MaterialSegmentedController does not always match other segments; iOS intermittantcrash when Image is disposed; Fixed: IconImage dissappears after pressing Android rendering of ImageButton; Some MultiResourceImages are not fitted properly on Android; Fixed: ImageButton does not return to default state after selected; ImageButton triggers Tapped event twice; Fixed: ImageButton crashes when ImageButtonState properties (DefaultState, PressedState, etc) are not set. ImageButton, MaterialButton and MaterialSegmentedControl has been enhanced with HorizontalTextAlignment and VerticalTextAlignment properties.  MaterialSegmentedControl also has IntraSegmentSpacing and IntraSegmentOrientation properties; Obsolete: ImageButton, MaterialButton and MaterialSegmentedControl Alignment property; Fix: Potential crash when deconstructing Image elements. Fixed: iOS rendering of images and fonts in XAML Previewers; Presentation of popups with modal pages. Fixed multiple edge case rendering issues with Label. Changed: PCL Profile from 259 to 111.  Fixed: ImageSource does not open Embedded Resource image when used in a library. Fixed: (Android) Back button causes app to exit. Fixed: Android Label not rendering in Xamarin.Studio's XAML Previewer; Fixed: Fit=LabelFit.Lines not working when truncating on iOS; Modified: Buttons now default to Fit=LabelFit.Width and Padding=4; Added the SelectedBackgroundColor and SelectedFontColor properties to MaterialButton and MaterialSegmentedControl Fixed: Failure to dynamically resize Label when text changes. Fixed: ImageButton not returned to full opacity when IsEnabled is programically set to true; Fixed: bound values of ImageButtonState properties are not used on initialization. Added: TintImage property to MaterialButton and MaterialSegmentedController to control if ImageSource image is tinted with FontColor; Fixed: Unable to select portion of Xamarin.Forms.ListView cell that is covered by Forms9Patch.Label; Android Forms9Patch.Label not always updating correctly when BindingContext has changed; Added: ApplicationInfoService to get application's Name, Bundle/Package Identifier, Build number, and Version name; Fix: ability to listen to gestures on Forms9Patch elements; Fix: RootPage responds correctly to changes in iOS status bar; Added: ColorGradientBox element; Fix: Intermittant crash on Android when releasing layouts. Now fully supports Shared Library apps.  Apparently, it did all along *except* for Embedded Resource fonts.  Now that has been fixed. Added support for <a> tag to HtmlText property of Label; Added HapticsMode and HapticsEffect properties to buttons; Fix: failure to use some Forms9Patch properties in XAML ResourceDictionary Optimized for rendering speed; fix: Bubble popup not appearing with MasterDetailPage; fix: BubblePopup not responding to Margin property; Added Toast, BubbleToast; Fix: Crash from Label object being instantiated and held a period without being rendered. Fix: iOS FormsGestures library Panning event proides erratic results. Fix: Android Label's Lines property does not truncate when LineBreakMode is not Start, Mid, or Center; Added: ActualFontSize readonly property to Label to give access to fit adjusted font size. New: Added IsElliptical property to MaterialButton and the layout elements; Enabled the Opacity property of Image element. New: Added CancelOnBackgroundTouch Property (default: true) to ModalPopup and BubblePopup New: CustomFontEffect platform effect can be applied to Xamarin.Forms Label, Button, Entry, and Editor elements to allow the EmbeddedResourceID of PCL Embedded Resource fonts as value for FontFamily property. Fixed: ImageButton in ContentView fails to correctly render state changes in BackgroundImage (Android). Fixed: resizing of button labels when text is changed.
Enhanced: Forms9Patch.ImageSource.FromMultiResource uses first portion of path of Embedded Resource to determine which assembly to search.
Changed: Lines property of Label sets the max number of lines when Fit=LabelFit.None. Fixed: (1) crash when render Label in Horizontal Orientation in StackLayout; (2) Failure to render Label in some layouts; (3) Failure to autofit some one-character labels correctly; (4) Failure to resize label when bounds changes; Enhanced: Can refer to iOS system fonts by using their name as value for FontFamily property. Fixed: (1) crash when instantiating buttons on iOS release builds; (2) iOS HtmlText <tt> tag combined with <b>, <u>, or <i> fails to render font correctly; (3) Image button touch intermittantly fails.
Enhanced: Width and Height values of LabelFit are now supported for labels with unimposed Height. Fixed: (1) failure to get bold and/or italic version of some iOS system fonts; (2) Multi-line labels not appearing so on iOS; (3) 9Patch images market to edge failing to render on iOS; New: Width and Lines Autofit for Labels.  TrailingImage property for ImageButton, MaterialButton and MaterialSegmentedController. Forms9Patch.FontExtensions.LoadedFontFamilies() lists all currently loaded fonts.
Fixed: iOS HtmlMarkup underlines don't match font color, Default Android image button label missing for some states.  Unable to bind to Segment.  Able to unselect Segment when in Radio mode. Fixed: in iOS, Images will have height or width of 1 (instead defaulting to source image height or width) when HeightRequest or WidthRequest is not set. Fixed: Issue where Forms9Patch.iOS.Settings.LicenseKey throws System.NullRefernceException. Added HTML markup to Label, MaterialButton, Segment, and ImageButtonState elements. Built for Xamain Forms 2.2 Fixed crash when no Target is given for BubblePopup.  Fixed failure to present popups when used w/ PushModalAsync(). Added Cancel method to Popups; Auto-cancel Popups when Android [back] button is pressed. Improved reliabilty of rendering of 9patch backgrounds when used in ListView in Android. Fixed AOT issue that caused BubblePopup not to work on iOS devices. Fixed layout of NinePatch backgrounds when used in a ListView on Android. Added ModalPopup and BubblePopup elements.  See demo app for example. 25x Improved tap response on all buttons; Fixed ImageButton.Background rendering issue. 3x Improved iOS image loading time.  Known issue: ImageButton Fails to present anything but DefaultState.BackgroundImage - will be fixed very soon. Fixed issue with comping for iOS devices. Added:
(1) PressingState to ImageButton to enable customization of the button for when it is in the pressed state.
(2) LongPressing and LongPressed events have been added to the ImageButton, MaterialButton, and Segment element.
(3) SegmentLongPressing and SegmentLongPressed events have been added to the MaterialSegmentedControl element.
(4) Renamed ImageButton's Clicked event to Tapped. Fixed not all XAML attributes working for ImageButtonState. Fixed:  XAML Segments Attribute for MaterialSegmentButton; Added FontColor and FontAttributes properties to Segment Added MaterialSegmentControl, Added Orientation property to MaterialButton Fixed: MaterialButton render when image but no text present. Added ImageButton and MaterialButton elements, Added HasShadow property to Android and iOS AbsoluteLayout, Frame, Grid, RelativeLayout, and StackLayout layouts. Fixed intermittant iOS UIImage.ImageWithData double free, Added RelativeLayout, Grid, and AbsoluteLayout Elements Fixed ContentView background scalable image rendered as non-scalable image if CapsInset has a one or two -1 values Fixed scaling of ContentView BackgroundImage
0.9.5 1) Added Fill (AspectFill, AspectFit, Fill and Tile) property to Image; 2) Added ContentView and Frame elements with BackgroundView and (for Frame) OutlineWidth and OutlineRadius properties
0.9.4 Bug fix Correct resizing when iOS screen orientation changes
0.9.3 fix race condition during debug where iOS Renderer releases Element before releasing renderer.
0.9.2 Bug fix for not properly scaling when parent space is smaller than base image but larger than base image less complaint portion.
0.9.1 beta release
0.9.1 fix: scaling of scalable images larger than parent space

GitHub repositories (0)

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
2.3.0 193 6/29/2020
2.2.6 6,004 3/15/2020
2.2.5 308 3/14/2020
2.2.5-beta1 213 3/14/2020
2.2.4 2,240 1/28/2020
2.2.4-beta1 94 1/23/2020
2.2.3 1,671 1/4/2020
2.2.3-pre1 151 1/4/2020
2.2.2 485 12/31/2019
2.2.1 199 12/30/2019
2.2.0 219 12/26/2019
2.1.3 1,306 12/10/2019
2.1.2 2,566 11/27/2019
2.1.1 182 11/26/2019
2.1.0 156 11/26/2019
2.1.0-beta1 106 11/22/2019
2.0.2 830 11/13/2019
2.0.1 145 11/12/2019
2.0.0 233 11/11/2019
2.0.0-rc1 92 11/11/2019
1.8.1 1,671 9/17/2019 1,263 8/15/2019 1,295 7/26/2019 1,381 7/9/2019 882 7/5/2019
1.8.0 1,390 6/26/2019
1.7.0 10,427 4/22/2019 1,575 4/12/2019 943 4/11/2019
1.6.7 868 4/11/2019 1,183 4/7/2019 1,609 3/22/2019
1.6.6 6,824 3/2/2019 1,209 2/6/2019 867 2/1/2019 868 1/30/2019
1.6.5 1,273 1/28/2019
1.6.4 12,300 12/5/2018
1.6.3 6,904 11/25/2018 2,649 11/16/2018
1.6.2 1,112 11/15/2018
1.6.1 1,185 11/2/2018 937 10/30/2018
1.6.0-rc5 883 10/30/2018
1.6.0-rc4 874 10/30/2018
1.6.0-rc3 879 10/29/2018
1.6.0-rc2 919 10/27/2018
1.6.0-rc1 873 10/27/2018 6,307 10/23/2018 906 10/22/2018 1,003 10/22/2018 926 10/20/2018 1,094 10/12/2018 963 10/12/2018
1.5.0-rc1 930 10/9/2018 1,569 9/7/2018 923 9/7/2018 926 9/7/2018
1.4.0 1,015 9/5/2018
1.3.3 2,332 6/28/2018
1.3.2 3,167 6/19/2018
1.3.1 1,385 5/15/2018
1.3.0 1,176 5/11/2018 1,170 4/19/2018
1.2.0 1,120 4/17/2018
1.1.1 1,457 2/19/2018
1.1.0 1,530 1/6/2018 1,131 1/5/2018 1,323 1/4/2018 1,103 1/2/2018
1.0.0 1,120 12/28/2017 9,474 10/26/2017 2,453 10/7/2017 5,120 8/14/2017 1,266 8/2/2017 1,281 7/10/2017
0.10.3 1,196 6/27/2017 1,191 6/21/2017 1,310 5/30/2017 1,139 5/23/2017 1,256 5/10/2017 1,175 5/3/2017 1,112 5/3/2017 1,101 5/3/2017 1,137 5/1/2017 1,398 4/16/2017 1,092 4/16/2017 1,174 4/10/2017 1,195 3/28/2017 1,830 3/2/2017 1,712 2/22/2017
0.10.1 1,305 2/16/2017 1,149 2/13/2017
0.10.0 1,132 2/11/2017 3,364 10/13/2016 1,205 9/26/2016 1,189 9/21/2016 1,144 9/15/2016 1,175 9/1/2016
0.9.13 1,225 8/22/2016 1,169 8/17/2016 1,340 8/6/2016 1,259 7/19/2016 1,332 7/16/2016 1,286 7/13/2016
0.9.12 1,262 7/11/2016 1,238 6/27/2016 1,367 5/10/2016
0.9.11 1,272 5/5/2016 1,134 4/29/2016 1,152 4/12/2016 1,152 4/5/2016 1,125 3/31/2016 1,133 3/23/2016 1,141 3/21/2016 1,118 3/21/2016
0.9.10 1,289 3/11/2016 1,343 3/1/2016 1,127 3/1/2016 1,129 2/28/2016
0.9.9 1,127 2/25/2016 1,135 2/19/2016 1,145 2/5/2016
0.9.8 1,125 2/4/2016 1,153 1/29/2016
0.9.7 1,120 1/28/2016
0.9.6 1,149 1/24/2016 1,119 1/21/2016 1,119 1/20/2016
0.9.5 1,124 1/20/2016 1,184 1/14/2016
0.9.3 1,130 1/13/2016 1,141 1/9/2016
0.9.1 1,152 1/4/2016
Show less