patternfly-kotlin

KO | EN

gitlite — search

#javascript #hacktoberfest #typescript #llm #android #machine-learning #linux #docker #java #nodejs #windows #cli #security #ios

patternfly-kotlin

(★ 33)

Pure Kotlin implementation of PatternFly

patternfly-kotlin 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> [!IMPORTANT]  
> 
> PatternFly Kotlin has been archived in favor of [PatternFly Java](https://github.com/patternfly-java).

---

# PatternFly Kotlin

PatternFly Kotlin is a 💯 Kotlin implementation of [PatternFly](https://www.patternfly.org/) based on [fritz2](https://www.fritz2.dev/) targeting [Kotlin/JS](https://kotl.in/js).

The goal of this project is to provide all PatternFly components in pure Kotlin. This is done in a way that matches the reactive nature of fritz2. In particular, the components use [stores](https://api.fritz2.dev/core/core/dev.fritz2.binding/-store/index.html), [handlers](https://api.fritz2.dev/core/core/dev.fritz2.binding/-handler/index.html), and other elements from the [fritz2 API](https://api.fritz2.dev/core/core/index.html).

To get a quick overview what this is all about head over to the PatternFly Kotlin [showcase](https://patternfly-kotlin.github.io/patternfly-kotlin-showcase/). It demonstrates the usage of all supported [components](https://patternfly-kotlin.github.io/patternfly-kotlin-showcase/#component;id=alert) and also includes more complex [demos](https://patternfly-kotlin.github.io/patternfly-kotlin-showcase/#user-demo) of data driven components such as [card view](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-card-view/index.html), [data list](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-data-list/index.html) and [data tables](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-data-table/index.html).

To get all details about how to use PatternFly Kotlin take a look at the [API documentation](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/).

## Get Started

### Dependencies

To use PatternFly Kotlin add its dependency to your `gradle.build.kts` file. PatternFly Kotlin is available on Maven Central. All components are implemented in Kotlin only. You won't need any additional external JS libraries.

```kotlin
repositories {
    mavenCentral()
}

dependencies {
    implementation("org.patternfly:patternfly-kotlin:0.2.0")
}
```

If you want to use the latest snapshot build of PatternFly Kotlin, add the following lines to your `gradle.build.kts` file:

```kotlin
repositories {
    mavenCentral()
    maven("https://s01.oss.sonatype.org/content/repositories/snapshots/")
}

dependencies {
    implementation("org.patternfly:patternfly-kotlin:0.3.0-SNAPSHOT")
}
```

### PatternFly Assets

PatternFly Kotlin does *not* come with stylesheets, fonts or other static PatternFly assets. We don't want to dictate how to embed these assets. One way is to add a `npm` dependency to PatternFly:

```kotlin
dependencies {
    implementation(npm("@patternfly/patternfly", "4"))
}
```

and make a call to `require()`

```kotlin
external fun require(name: String): dynamic

fun main() {
    require("@patternfly/patternfly/patternfly.css")
    require("@patternfly/patternfly/patternfly-addons.css")
}
```

Another option is to download or get PatternFly using a CDN provider like [jsDelivr](https://www.jsdelivr.com/package/npm/@patternfly/patternfly) and include the stylesheets in your HTML page:

```html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>My App</title>
    <link rel="stylesheet" href="patternfly.css">
    <link rel="stylesheet" href="patternfly-addons.css">
</head>
<body>
<script src="your-app.js"></script>
</body>
</html>
```

See also the [getting started](https://www.patternfly.org/v4/get-started/develop#htmlcss) section on the PatternFly website for more details.

### Page

The typical setup in PatternFly starts with adding a [Page](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-page/index.html) component to the document body. The page contains the main components such as the header, an optional sidebar and the main content container.

A typical setup might look something like this:

```kotlin
fun main() {
    val router = router("home")
    render {
        page {
            pageHeader {
                brand {
                    home("#home")
                    img("/assets/logo.svg")
                }
                headerTools {
                    notificationBadge()
                }
            }
            pageSidebar {
                sidebarBody {
                    verticalNavigation(router) {
                        items {
                            item("item1", "Item 1")
                            item("item2", "Item 2")
                        }
                    }
                }
            }
            pageMain {
                pageSection {
                    h1 { +"Welcome" }
                    p { +"Lorem ipsum" }
                }
                pageSection {
                    +"Another section"
                }
            }
        }
    }
}
```

## API

All components in PatternFly Kotlin are completely implemented in Kotlin and are created by factory functions. These functions integrate in the fritz2 DSL and follow a common pattern:

1. Parameter(s) specific to the component
1. `id: String? = null` ID attribute assigned to the component
1. `baseClass: String? = null` CSS class(es) added to the list of classes of the component
1. `content` code block to customize the component

Most of the parameters are optional and have reasonable defaults.

Let's take the [card](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-card/index.html) component as an example. The following code snippet creates a card component with an image and a dropdown in the header, a title, body and footer.

See also the card section in the [showcase](https://patternfly-kotlin.github.io/patternfly-kotlin-showcase/#component;id=card).

```kotlin
fun main() {
    render {
        card {
            cardHeader {
                img { src("./logo.svg") }
                cardAction {
                    dropdown<String>(align = RIGHT) {
                        kebabToggle()
                        items {
                            item("Item 1")
                            item("Disabled Item") { disabled = true }
                            separator()
                            item("Separated Item")
                        }
                    }
                }
            }
            cardTitle { +"Title" }
            cardBody { +"Body" }
            cardFooter { +"Footer" }
        }
    }    
}
```

Whenever possible, the components make use of reactive concepts and classes such as [stores](https://api.fritz2.dev/core/core/dev.fritz2.binding/-store/index.html), [handlers](https://api.fritz2.dev/core/core/dev.fritz2.binding/-handler/index.html) and [flows](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html). The following example creates a [chip group](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-chip-group/index.html) component whose [chips](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-chip/index.html) are backed by a [store](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-chip-group-store/index.html) and rendered by a [display](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-chip-group/display.html) function. The function uses the number of letters to add a [badge](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-badge/index.html) component to the chip. When a chip is removed from the group an info [notification](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-notification/index.html) is [added](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-notification/-companion/add.html) to the [notification store](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-notification-store/index.html) which in turn is fetched by the [toast alert group](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/org.patternfly/-alert-group/-companion/add-toast-alert-group.html).

See also the chip group section in the [showcase](https://patternfly-kotlin.github.io/patternfly-kotlin-showcase/#component;id=chip-group).

```kotlin
fun main() {
    data class Word(val text: String, val letters: Int = text.length)

val store = ChipGroupStore<Word> { Id.build(it.text) }.apply {
        addAll(
            listOf(
                Word("Chip one"),
                Word("Really long chip that goes on and on"),
                Word("Chip three"),
                Word("Chip four"),
                Word("Chip five")
            )
        )
        removes handledBy Notification.add { word ->
            info("You removed ${word.text}.")
        }
    }

AlertGroup.addToastAlertGroup()
    render {
        chipGroup(store) {
            +"Letters"
            display { word ->
                chip {
                    +word.text
                    badge {
                        value(word.letters)
                    }
                }
            }
        }
    }
}
```

To see more components in action, take a look at the [showcase](https://patternfly-kotlin.github.io/patternfly-kotlin-showcase/). To learn how to use the components, read the [API documentation](https://patternfly-kotlin.github.io/patternfly-kotlin/patternfly-kotlin/).

## Get Involved

PatternFly Kotlin is still under development. The API might change and things might not work as expected. Please give it a try and share your feedback. Join the chat at https://slack.patternfly.org/ or use the GitHub [issues](https://github.com/patternfly-kotlin/patternfly-kotlin/issues) to report bugs or request new features.

Of course, you're very welcome to [contribute](CONTRIBUTING.md) to PatternFly Kotlin. If you like what you're seeing, leave us a star!

patternfly-kotlin

patternfly-kotlin 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

patternfly-kotlin

patternfly-kotlin 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README