Giter Club home page Giter Club logo

semantic-ui-react's Introduction

Gitter Circle Codecov David npm

Hey, we're in development. Prior to reaching v1.0.0:

  1. MINOR versions represent breaking changes
  2. PATCH versions represent fixes and features
  3. There are no deprecation warnings between releases
  4. You should consult the CHANGELOG and related issues/PRs for more information

Installation & Usage

See the Documentation for an introduction, usage information, and extensive examples.

Built With Semantic UI React

These great products are built on Semantic UI React. Add yours here.

Example Projects

This is a listing of example projects and guides that will help you integrate Semantic UI React into your new or existing projects.

Our example project right here in this repo.

Our example project right here in this repo.

Advanced universal starter with Semantic-UI-React. React/Redux/Lazy-loading/SSR/PWA.

This example modifies the well-known react-redux Todo List to use Semantic UI components. There is also a write-up on the process in the project README.

FAQ

Can I use custom Icons?

Yes. Just use <Icon className='my-icon' /> instead of <Icon name='my-icon' />. See Semantic-Org#931 (comment) for detailed info and examples.

How do I setup CSS?

There are several options. Refer to our doc on CSS Usage.

Can I use a custom CSS theme?

Yes. Semantic UI React includes components that render valid Semantic UI HTML, no CSS is included. This allows you to load any Semantic UI CSS theme on top of your Semantic UI React app.

Here are some helpful links:

Voice Your Opinion

Help shape this library by weighing in on our RFC (request for comments) issues.

How Can I Help?

Our CONTRIBUTING.md is a step-by-step setup and development guide. It is meant to be read from top to bottom. Once you're up to speed, each issue here includes more information on how you can help:

Issues labeled good first issue are a great way to ease into development on this project.

We're seeking component parity with Semantic UI, plus some addons. There is an issue for every missing component, labeled new component. Just comment on the issue you'd like to take.

Any other issue labeled help wanted is ready for a PR.

100% Semantic UI Support

Elements Collections Views Modules Behaviors
✓ Button ✓ Breadcrumb ✓ Advertisement ✓ Accordion Form Validation
✓ Container ✓ Form ✓ Card ✓ Checkbox API (NA)
✓ Divider ✓ Grid ✓ Comment ✓ Dimmer ✓ Visibility
✓ Flag ✓ Menu ✓ Feed ✓ Dropdown
✓ Header ✓ Message ✓ Item ✓ Embed
✓ Icon ✓ Table ✓ Statistic ✓ Modal
✓ Image ✓ Popup
✓ Input ✓ Progress
✓ Label ✓ Rating
✓ List ✓ Search
✓ Loader Shape
✓ Rail ✓ Sidebar
✓ Reveal ✓ Sticky
✓ Segment ✓ Tab
✓ Step ✓ Transition

Principles

  • No jQuery dependency
  • No animation dependencies
  • Reuse SUI CSS transitions
  • Simple declarative component APIs vs intricate HTML markup
  • Complete keyboard support
  • Complete SUI component definition support
  • Completely documented
  • Completely tested

Releasing

On the latest clean master:

yarn release:major
yarn release:minor
yarn release:patch

Releasing will update the changelog which requires github_changelog_generator.

Credit

Originally made for @TechnologyAdvice by @levithomason.

Big thanks to our contributors, especially:

  • @layershifter for essentially taking over during @levithomason's unavailability
  • @jcarbo for thoughtful engineering
  • @jamiehill for early engineering and support

semantic-ui-react's People

Contributors

aabustamante avatar apiv avatar athurman avatar ayastreb avatar chris-r3 avatar deweybot avatar dguo avatar dpkwhan avatar dylankiss avatar eanplatter avatar fracmak avatar gitname avatar greenkeeperio-bot avatar iamcaleberic avatar jayphelps avatar jeffcarbs avatar jhchill666 avatar josie11 avatar kamdz avatar koenvg avatar kyleturco avatar layershifter avatar levithomason avatar lottamus avatar mariolamacchia avatar patrikmolsson avatar pierre-h avatar tadeploy avatar tarang9211 avatar winlost avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.