https://github.com/codeschubser/bootstrap-twig-components-bundle

Twig Components bundle for Symfony
https://github.com/codeschubser/bootstrap-twig-components-bundle

codeschubser components reusable reusable-components symfony symfony-bundle twig twig-components

Last synced: about 1 month ago
JSON representation

Twig Components bundle for Symfony

• Host: GitHub
• URL: https://github.com/codeschubser/bootstrap-twig-components-bundle
• Owner: codeschubser
• License: mit
• Created: 2025-02-04T07:07:10.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2025-04-11T08:03:58.000Z (about 1 month ago)
• Last Synced: 2025-04-12T09:53:43.275Z (about 1 month ago)
• Topics: codeschubser, components, reusable, reusable-components, symfony, symfony-bundle, twig, twig-components
• Language: PHP
• Homepage:
• Size: 747 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Twig Components Bundle (experimental)

[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/codeschubser/twig-components-bundle/ci.yml)](https://github.com/codeschubser/twig-components-bundle/actions/workflows/ci.yml)

[![GitHub Tag](https://img.shields.io/github/v/tag/codeschubser/twig-components-bundle)](https://github.com/codeschubser/twig-components-bundle/tags)

[![codecov](https://codecov.io/gh/codeschubser/twig-components-bundle/branch/master/graph/badge.svg?token=6303H9T6XZ)](https://codecov.io/gh/codeschubser/twig-components-bundle)

[![GitHub License](https://img.shields.io/github/license/codeschubser/twig-components-bundle)](https://github.com/codeschubser/twig-components-bundle/blob/master/LICENSE)

> [!WARNING]  

> This Bundle is experimental and subject to change in a future release.

A Symfony bundle for the [Twig Components](https://symfony.com/bundles/ux-twig-component/current/index.html) library.

This bundle allows you to create robust and reusable Twig components.

## Requirements

- PHP 8.2 or higher

- Symfony 6.0 or higher

## Features

All components are [Bootstrap](https://getbootstrap.com/) ready. Recommend version is v5.3 or higher. Some components can be extended with icons. [Bootstrap Icons](https://icons.getbootstrap.com/) and [Font Awesome](https://fontawesome.com/) were tested. But other icons are also possible.

## Accessibility

- Optional icons are hidden from the [accessibility API](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-hidden).

- Alerts are decorated with `role="alert"` to send accessible alert event to assistive technology products.

- Dropdowns are decorated with `aria-expanded` and `aria-current`.

- Icons in components are decorated with `aria-hidden` or `aria-label`.

## Usage

- [Installation](docs/index.md)

- Components

  - [Alert](docs/alert.md) *Provide contextual feedback messages for typical user actions with a handful of available and flexible options.*

  - [Button](docs/button.md) *Provide buttons with support for multiple variants, icon, states, and more.*

  - [Breadcrumbs](docs/breadcrumbs.md) *Provide breadcrumb navigation with valid schema.org markup*

  - [Card](docs/cards.md) *Provide flexible content containers.*

  - [Dropdown](docs/dropdown.md) *Toggleable and contextual overlays.*

  - [Icon](docs/icon.md) *Reusable icon component*

  - Modal *TBD*

  - Toast *TBD*

## Development

TBD

## License

This bundle is licensed under the [MIT License](LICENSE).