# primefaces

**Repository Path**: mirrors/primefaces

## Basic Information

- **Project Name**: primefaces
- **Description**: PrimeFaces是一个用于提高JSF Web应用程序开发效率的开源类库
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/primefaces
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2020-06-24
- **Last Updated**: 2026-01-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Maven](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg)](https://repo.maven.apache.org/maven2/org/primefaces/primefaces/)
[![Actions Status CI](https://github.com/primefaces/primefaces/workflows/CI/badge.svg)](https://github.com/primefaces/primefaces/actions/workflows/build.yml)
[![Actions Status Integration Tests](https://github.com/primefaces/primefaces/workflows/IT/badge.svg)](https://github.com/primefaces/primefaces/actions/workflows/nightly.yml)
[![Sonar](https://sonarcloud.io/api/project_badges/measure?project=org.primefaces%3Aprimefaces&metric=alert_status)](https://sonarcloud.io/dashboard?id=org.primefaces%3Aprimefaces)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Discord Chat](https://img.shields.io/discord/557940238991753223.svg?color=7289da&label=chat&logo=discord)](https://discord.gg/gzKFYnpmCY)
[![Stackoverflow](https://img.shields.io/badge/StackOverflow-primefaces-chocolate.svg)](https://stackoverflow.com/questions/tagged/primefaces+jsf)
[![Prime Discussions](https://img.shields.io/github/discussions-search?query=org%3Aprimefaces&logo=github&label=Prime%20Discussions&link=https%3A%2F%2Fgithub.com%2Forgs%2Fprimefaces%2Fdiscussions)](https://github.com/orgs/primefaces/discussions)
[![Gurubase](https://img.shields.io/badge/Gurubase-Ask%20PrimeFaces%20Guru-006BFF)](https://gurubase.io/g/primefaces)

[![PrimeFaces Hero](https://www.primefaces.org/wp-content/uploads/2021/10/PrimeFaces-GitHub-2021Q4.jpg "PrimeFaces Hero")](https://www.primefaces.org/showcase)

# PrimeFaces

This is an overview page, please visit [PrimeFaces.org](https://www.primefaces.org) for more information.

[![PrimeFaces Logo](https://www.primefaces.org/wp-content/uploads/2016/10/prime_logo_new.png)](https://www.primefaces.org/showcase)

### Overview
***

[PrimeFaces](https://www.primefaces.org/) is one of the most popular UI libraries in Java EE Ecosystem and widely used by software companies, world renowned brands, banks, financial institutions, insurance companies, universities and more. Here are [some of the users](https://www.primefaces.org/whouses) who notified us or subscribed to a [PrimeFaces Support Service](https://www.primefaces.org/support).

### Community <> LTS <> Pro
***

This is the open source code and issue tracker of the PrimeFaces master (a.k.a. community version).  
Please check the following link for informations about [Long Term Support (LTS)](https://www.primefaces.org/showcase/lts.xhtml) and [PRO](https://www.primefaces.org/support/)  

What does that mean?
- PrimeFaces is developed by PrimeTek and the open source community.
- The most contributors here on GitHub are working on PrimeFaces in their spare time.
- PrimeTek pushes fixes and new features from their closed source LTS and Pro repositories to the community edition.
- We, the community on GitHub, only provide support for issues, which are reproducible with the current major release or SNAPSHOT.
- We are NOT able to port bugfixes to LTS releases. This is up to PrimeTek and can e.g. be triggered with [PrimeFaces PRO](https://www.primefaces.org/support/). You can also ask questions in the [LTS Discussions](https://github.com/orgs/primefaces/discussions/categories/primefaces-lts).

### Versions
***

Version | Status | JSF version | Java version | Documentation | Showcase
------------ | ------------- | ------------- | -------------  | ------------- | ------------- |
unreleased | unreleased | ![JSF40](https://img.shields.io/badge/JSF-4.0-green.svg) - ![JSF40](https://img.shields.io/badge/JSF-4.1-green.svg) | ![Java](https://img.shields.io/badge/Java%2011+-blue.svg) | [HTML](https://primefaces.github.io/primefaces/16_0_0/#/) | [HTTPS](https://primefaces-showcase-zvbjj.ondigitalocean.app/)
![15.0.x](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=15&color=cyan) | STS | ![JSF23](https://img.shields.io/badge/JSF-2.3-yellow.svg) - ![JSF40](https://img.shields.io/badge/JSF-4.1-green.svg) | ![Java](https://img.shields.io/badge/Java%2011+-blue.svg) | [HTML](https://primefaces.github.io/primefaces/15_0_0/#/) | [HTTPS](https://primefaces15-showcase-f233g.ondigitalocean.app/)
![14.0.x](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=14&color=cyan) | LTS | ![JSF23](https://img.shields.io/badge/JSF-2.3-yellow.svg) - ![JSF40](https://img.shields.io/badge/JSF-4.0-green.svg) | ![Java](https://img.shields.io/badge/Java%2011+-blue.svg) | [HTML](https://primefaces.github.io/primefaces/14_0_0/#/) | [HTTPS](https://primefaces14-showcase-ifqw8.ondigitalocean.app/)
![13.0.x](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=13&color=cyan) | LTS | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) - ![JSF40](https://img.shields.io/badge/JSF-4.0-green.svg) | ![Java](https://img.shields.io/badge/Java%208+-blue.svg) | [HTML](https://primefaces.github.io/primefaces/13_0_0/#/) |

<details>
  <summary>Archive</summary>
  

Version | Status | JSF version | Java version | Documentation
------------ | ------------- | ------------- | ------------- | ------------- |
![12.0.x](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=12&color=cyan) | LTS | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF40](https://img.shields.io/badge/JSF-4.0-green.svg) | ![Java](https://img.shields.io/badge/Java%208+-blue.svg) | [HTML](https://primefaces.github.io/primefaces/12_0_0/#/) 
![11.0.x](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=11&color=cyan) | LTS | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF40](https://img.shields.io/badge/JSF-4.0-green.svg) | ![Java](https://img.shields.io/badge/Java%208+-blue.svg) | [HTML](https://primefaces.github.io/primefaces/11_0_0/#/)
![10.0.x](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=10&color=cyan) | LTS | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF30](https://img.shields.io/badge/JSF-3.0-yellow.svg) | ![Java](https://img.shields.io/badge/Java%208+-blue.svg) | [HTML](https://primefaces.github.io/primefaces/10_0_0/#/)
![8.0](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=8&color=cyan) | LTS | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF23](https://img.shields.io/badge/JSF-2.3-yellow.svg) | ![Java](https://img.shields.io/badge/Java%208+-blue.svg) | [HTML](https://primefaces.github.io/primefaces/8_0/#/)
![7.0](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=7&color=cyan) | Legacy | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF23](https://img.shields.io/badge/JSF-2.3-yellow.svg) | ![Java](https://img.shields.io/badge/Java%207+-red.svg) | [HTML](https://primefaces.github.io/primefaces/7_0/#/)
![6.2](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=6.2&color=cyan) | Legacy | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF23](https://img.shields.io/badge/JSF-2.3-yellow.svg) | ![Java](https://img.shields.io/badge/Java%206+-red.svg) | [PDF](https://www.primefaces.org/docs/guide/primefaces_user_guide_6_2.pdf)
![6.1](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=6.1&color=cyan) | Legacy | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF23](https://img.shields.io/badge/JSF-2.3-yellow.svg) | ![Java](https://img.shields.io/badge/Java%205+-red.svg) | [PDF](https://www.primefaces.org/docs/guide/primefaces_user_guide_6_1.pdf)
![6.0](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=6.0&color=cyan) | Legacy | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF23](https://img.shields.io/badge/JSF-2.3-yellow.svg) | ![Java](https://img.shields.io/badge/Java%205+-red.svg) | [PDF](https://www.primefaces.org/docs/guide/primefaces_user_guide_6_0.pdf)
![5.3](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=5.3&color=cyan) | Legacy | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF22](https://img.shields.io/badge/JSF-2.2-red.svg) | ![Java](https://img.shields.io/badge/Java%205+-red.svg) | [PDF](https://www.primefaces.org/docs/guide/primefaces_user_guide_5_3.pdf)
![5.2](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=5.2&color=cyan) | Legacy | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF22](https://img.shields.io/badge/JSF-2.2-red.svg) | ![Java](https://img.shields.io/badge/Java%205+-red.svg) | [PDF](https://www.primefaces.org/docs/guide/primefaces_user_guide_5_2.pdf)
![5.1](https://img.shields.io/maven-central/v/org.primefaces/primefaces.svg?versionPrefix=5.1&color=cyan) | Legacy | ![JSF20](https://img.shields.io/badge/JSF-2.0-red.svg) -  ![JSF22](https://img.shields.io/badge/JSF-2.2-red.svg) | ![Java](https://img.shields.io/badge/Java%205+-red.svg) | [PDF](https://www.primefaces.org/docs/guide/primefaces_user_guide_5_1.pdf)
</details>


### Maven
***

##### Release 

  ```xml
  <!-- Java EE / javax.* / JSF 2.3 -->
  <dependency>
      <groupId>org.primefaces</groupId>
      <artifactId>primefaces</artifactId>
      <version>15.0.6</version>
  </dependency>

  <!-- Jakarta EE / jakarta.* / Faces 4.0+  -->	
  <dependency>
      <groupId>org.primefaces</groupId>
      <artifactId>primefaces</artifactId>
      <version>15.0.6</version>
      <classifier>jakarta</classifier>
  </dependency>
  ```

##### SNAPSHOT

  ```xml
  <!-- Jakarta EE / jakarta.* / Faces 4.0+  -->
  <dependency>
      <groupId>org.primefaces</groupId>
      <artifactId>primefaces</artifactId>
      <version>16.0.0-SNAPSHOT</version>
  </dependency>

  <repositories>
    <repository>
      <id>sonatype-snapshots</id>
      <name>Sonatype Snapshot Repository</name>
      <url>https://oss.sonatype.org/content/repositories/snapshots</url>
      <releases>
          <enabled>false</enabled>
      </releases>
      <snapshots>
          <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
  ```

### Manual Download
***

PrimeFaces JAR can be downloaded manually via the [Maven Repository](https://repo1.maven.org/maven2/org/primefaces/primefaces/).

### Tag Library
***

The VDL documentation for the PrimeFaces tag library can be found here: https://primefaces.github.io/primefaces/vdldoc/

### Usage
***

```xml
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
	xmlns:h="jakarta.faces.html"
	xmlns:f="jakarta.faces.core"
	xmlns:pt="jakarta.faces.passthrough"
	xmlns:jsf="jakarta.faces"
	xmlns:ui="jakarta.faces.facelets"
	xmlns:p="primefaces">

	<h:head>

	</h:head>

	<h:body>

		<p:spinner />

	</h:body>
</html>

```

### Demo
***
Please refer to the [showcase](https://www.primefaces.org/showcase) in order to see the full usage of the components. Sources of PrimeFaces showcase are available within module [primefaces-showcase](https://github.com/primefaces/primefaces/tree/master/primefaces-showcase).

You can also download the PrimeFaces Showcase WAR via the [Maven Repository](https://repo1.maven.org/maven2/org/primefaces/primefaces-showcase/). This is the version for plain Servlet containers like Tomcat.

### Contribution
***
Visit the [contribution](./CONTRIBUTING.md) page for detailed information.

### Release Instructions
***
Visit the [Release Checklist](https://github.com/primefaces/primefaces/wiki/Release-Checklist) for how to release an LTS or STS version.

### License
***
Licensed under the MIT License.