--- title: "Current Value Gauge | Explore SwiftUI" description: "Creates a gauge showing a value within a range and that describes the gauge’s purpose and current value" canonical_url: "https://exploreswiftui.com/library/gauge/current-value-gauge" meta: author: "Explore SwiftUI" "og:description": "Creates a gauge showing a value within a range and that describes the gauge’s purpose and current value" "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Current%2BValue%2BGauge%2B%2Cdescription_~Q3JlYXRlcyBhIGdhdWdlIHNob3dpbmcgYSB2YWx1ZSB3aXRoaW4gYSByYW5nZSBhbmQgdGhhdCBkZXNjcmliZXMgdGhlIGdhdWdl4oCZcyBwdXJwb3NlIGFuZCBjdXJyZW50IHZhbHVl%2Ccategory_Gauge%2Cimage_~L2FwaS9pbWFnZXMvMzkvdmFyaWFudHMvMjI3P3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidmlzaW9uT1MiXX0%2Cp_Ii9saWJyYXJ5L2dhdWdlL2N1cnJlbnQtdmFsdWUtZ2F1Z2Ui%2Cs_fVePjx23iQo1cgKc.png" "og:image:height": "630" "og:image:type": image/png "og:image:width": "1200" "og:title": "Current Value Gauge | Explore SwiftUI" "twitter:description": "Creates a gauge showing a value within a range and that describes the gauge’s purpose and current value" "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Current%2BValue%2BGauge%2B%2Cdescription_~Q3JlYXRlcyBhIGdhdWdlIHNob3dpbmcgYSB2YWx1ZSB3aXRoaW4gYSByYW5nZSBhbmQgdGhhdCBkZXNjcmliZXMgdGhlIGdhdWdl4oCZcyBwdXJwb3NlIGFuZCBjdXJyZW50IHZhbHVl%2Ccategory_Gauge%2Cimage_~L2FwaS9pbWFnZXMvMzkvdmFyaWFudHMvMjI3P3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidmlzaW9uT1MiXX0%2Cp_Ii9saWJyYXJ5L2dhdWdlL2N1cnJlbnQtdmFsdWUtZ2F1Z2Ui%2Cs_fVePjx23iQo1cgKc.png" "twitter:title": "Current Value Gauge | Explore SwiftUI" --- > Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt) **Interactive previews**[ iPhone](https://exploreswiftui.com/iphone?element=39) # **Current Value Gauge ** Creates a gauge showing a value within a range and that describes the gauge’s purpose and current value ![Current Value Gauge - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/39/variants/227?v=1790073478842&r=2&w=800&q=80&f=webp) ### **Platform Compatibility** iOS 16.0+ iPadOS 16.0+ macOS 13.0+ watchOS 7.0+ visionOS 1.0+ ### **Tags** ### **SwiftUI Code** [ Docs]() ``` Gauge(value: 0.42) { Text("Foo") } currentValueLabel: { Text("\(currentValue)") } ``` ### **Found an issue or have a suggestion?** Created: June 3, 2025Updated: December 27, 2025 ### **More Gauge Components ** [**View all **](https://exploreswiftui.com/library/gauge) ![Gauge Colors - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/48/variants/261?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Gauge Colors** Customizing the colors of different styles with minimal effort ![CircularGaugeStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/47/variants/263?v=1790073478842&r=2&w=412&q=75&f=webp) ### **CircularGaugeStyle** A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value ![ LinearGaugeStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/46/variants/264?v=1790073478842&r=2&w=412&q=75&f=webp) ### **LinearGaugeStyle** A gauge style that displays a bar with a marker that appears at a point along the bar to indicate the gauge’s current value ![AccessoryLinearCapacityGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/45/variants/257?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryLinearCapacityGaugeStyle** A gauge style that displays bar that fills from leading to trailing edges as the gauge’s current value increases ![AccessoryLinearGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/44/variants/253?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryLinearGaugeStyle** A gauge style that displays bar with a marker that appears at a point along the bar to indicate the gauge’s current value ![LinearCapacityGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/43/variants/267?v=1790073478842&r=2&w=412&q=75&f=webp) ### **LinearCapacityGaugeStyle** A gauge style that displays a bar that fills from leading to trailing edges as the gauge’s current value increases ![AccessoryCircularCapacityGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/42/variants/412?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryCircularCapacityGaugeStyle** A gauge style that displays a closed ring that’s partially filled in to indicate the gauge’s current value ![AccessoryCircularGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/41/variants/219?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryCircularGaugeStyle** A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value ### **Explore Other Components ** [**Browse all **](https://exploreswiftui.com/) ![Hour Minute Seconds DatePicker - watchOS - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/61/variants/181?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Hour Minute Seconds DatePicker** A DatePicker for just hour, minute, and second. ![VerticalPageTabViewStyle - watchOS - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/162/variants/463?v=1790073478842&r=2&w=412&q=75&f=webp) ### **VerticalPageTabViewStyle** A TabViewStyle that displays a vertical TabView interaction and appearance. ![Subscription Store View - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/225/variants/531?v=1792441754239&r=2&w=412&q=75&f=webp) ### **Subscription Store View** Creates a view that loads subscriptions based on a collection of product identifiers, and merchandises them with automatic marketing content. ![RegularProductViewStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/206/variants/520?v=1790073478842&r=2&w=412&q=75&f=webp) ### **RegularProductViewStyle** A style for a product view that uses a standard, platform-appropriate layout. ![Hide Tab Bar On Scroll Down - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/88/variants/383?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Hide Tab Bar On Scroll Down** Minimize the tab bar when downwards scrolling starts. Minimizing is supported for tab bars on only iPhone ![Overlay Arrangement Style - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/250/variants/1777?v=1790584733410&r=2&w=412&q=75&f=webp) ### **Overlay Arrangement Style** An arrangement view style that layers the primary view over the secondary view in z-order. ![UIKit Label Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/10/variants/45?v=1790073478842&r=2&w=412&q=75&f=webp) ### **UIKit Label Colors** ![CompactMenuControlGroupStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/54/variants/400?v=1790073478842&r=2&w=412&q=75&f=webp) ### **CompactMenuControlGroupStyle** A control group style that presents its content as a compact menu when the user presses the control, or as a submenu when nested within a larger menu ```json {"@context":"https://schema.org","@graph":[{"@id":"https://exploreswiftui.com/#website","@type":"WebSite","description":"A visual library for SwiftUI APIs, components, and modifiers","inLanguage":"en-US","name":"Explore SwiftUI","url":"https://exploreswiftui.com/","publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#webpage","@type":"WebPage","dateModified":"2025-12-27T19:07:37.291Z","datePublished":"2025-06-03T16:04:40.847Z","description":"Creates a gauge showing a value within a range and that describes the gauge’s purpose and current value","name":"Current Value Gauge","url":"https://exploreswiftui.com/library/gauge/current-value-gauge","breadcrumb":{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"mainEntity":{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#article"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/gauge/current-value-gauge"]}],"primaryImageOfPage":{"@id":"https://exploreswiftui.com/#logo"}},{"@id":"https://exploreswiftui.com/#identity","@type":"Organization","description":"A visual library for SwiftUI APIs, components, and modifiers","name":"Explore SwiftUI","url":"https://exploreswiftui.com","logo":{"@id":"https://exploreswiftui.com/#logo"},"sameAs":["https://x.com/Typ0genius","https://mastodon.social/@Typ0genius"]},{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#article","citation":"https://developer.apple.com/documentation/swiftui/gauge/init(value:in:label:currentvaluelabel:)","dateModified":"2025-12-27T19:07:37.291Z","datePublished":"2025-06-03T16:04:40.847Z","description":"Creates a gauge showing a value within a range and that describes the gauge’s purpose and current value","headline":"Current Value Gauge","inLanguage":"en-US","name":"Current Value Gauge","thumbnailUrl":"https://exploreswiftui.com/api/images/39/variants/227?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/gauge/current-value-gauge","@type":["Article","TechArticle"],"about":{"@type":"Thing","name":"SwiftUI"},"author":{"@id":"https://exploreswiftui.com/#identity"},"hasPart":{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#source-code"},"image":{"@id":"https://exploreswiftui.com/#/schema/image/1"},"isPartOf":{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#webpage"},"mainEntityOfPage":{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#source-code","@type":"SoftwareSourceCode","codeSampleType":"full example","description":"Creates a gauge showing a value within a range and that describes the gauge’s purpose and current value","name":"Current Value Gauge SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"Gauge(value: 0.42) {\n Text(\"Foo\")\n} currentValueLabel: {\n Text(\"\\(currentValue)\")\n}","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"Gauge"},{"@type":"Thing","name":"Current Value Gauge "}]},{"@id":"https://exploreswiftui.com/library/gauge/current-value-gauge#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"Gauge","item":"https://exploreswiftui.com/library/gauge","position":2},{"@type":"ListItem","name":"Current Value Gauge ","item":"https://exploreswiftui.com/library/gauge/current-value-gauge","position":3}]},{"@id":"https://exploreswiftui.com/#logo","@type":"ImageObject","caption":"Explore SwiftUI","contentUrl":"https://exploreswiftui.com/apple-touch-icon.png","inLanguage":"en","url":"https://exploreswiftui.com/apple-touch-icon.png"},{"@id":"https://exploreswiftui.com/#/schema/image/1","@type":"ImageObject","contentUrl":"https://exploreswiftui.com/api/images/39/variants/227?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/39/variants/227?v=1790073478842&r=2"}]} ```