jiny / html
jiny object html
0.4
2025-08-26 07:41 UTC
Requires
- php: ^8.2
Requires (Dev)
- phpunit/phpunit: ^10.0
This package is auto-updated.
Last update: 2025-08-26 07:42:14 UTC
README
jiny/html
는 서버사이드 HTML 코드를 객체 지향적으로 생성할 수 있는 Laravel 패키지입니다. 복잡한 HTML 구조를 데이터 기반으로 안전하고 유지보수하기 쉽게 빌드할 수 있습니다.
특징
- 📦 객체 지향적 HTML 생성: PHP 객체를 통한 type-safe HTML 생성
- 🎨 풍부한 컴포넌트: 폼, 테이블, SVG 등 다양한 HTML 요소 지원
- 🔧 Laravel 통합: Laravel Service Provider 및 Blade 컴포넌트 지원
- 🛡️ 안전한 출력: XSS 방지를 위한 자동 이스케이프 처리
- 📝 유연한 구조: 메서드 체이닝을 통한 직관적인 API
디렉토리 구조
jiny/html/
├── app/ # 소스 코드
│ ├── Core/ # 핵심 기본 클래스
│ │ └── CTag.php # 모든 HTML 요소의 기본 클래스
│ ├── Components/ # 기본 HTML 컴포넌트
│ │ ├── CDiv.php
│ │ ├── CSpan.php
│ │ ├── CButton.php
│ │ └── ...
│ ├── Forms/ # 폼 관련 컴포넌트
│ │ ├── CForm.php
│ │ ├── CInput.php
│ │ └── ...
│ ├── Tables/ # 테이블 관련 컴포넌트
│ │ ├── CTable.php
│ │ ├── CRow.php
│ │ └── ...
│ ├── Widgets/ # 고급 UI 위젯
│ ├── Svg/ # SVG 관련 컴포넌트
│ └── Helpers/ # 헬퍼 함수들
│ ├── helpers.php
│ └── constants.php
├── tests/ # 테스트 코드
│ ├── Unit/
│ └── Feature/
├── docs/ # 문서화
├── JinyHtmlServiceProvider.php # Laravel 서비스 프로바이더
└── composer.json # Composer 설정
설치방법
Laravel 프로젝트에서 Composer를 통하여 패키지를 설치합니다:
composer require jiny/html
Laravel의 패키지 자동 발견 기능으로 서비스 프로바이더가 자동 등록됩니다.
기본 사용법
헬퍼 함수 사용
// 헬퍼 함수로 간편하게 사용 $div = CDiv('Hello World') ->addClass('container') ->setId('main-content'); echo $div; // <div class="container" id="main-content">Hello World</div> // 버튼 생성 $button = CButton('submit-btn', '전송') ->addClass('btn btn-primary');
메서드 체이닝
대부분의 메서드는 체이닝을 지원합니다:
$button = (new CTag('button')) ->setAttribute('type', 'submit') ->setAttribute('class', 'btn btn-primary') ->setBodyContent('전송');
폼 컴포넌트
// 헬퍼 함수 사용 $form = CForm() ->setAttribute('method', 'post') ->setAttribute('action', '/submit') ->addItem([ CLabel('이메일:', 'email'), CEmail()->setAttribute('name', 'email')->setAttribute('required', 'required'), CTextBox('username', '', false, 100)->setAttribute('placeholder', '사용자명'), CCheckBox('agree', '1')->setLabel('동의합니다'), CButton('submit', '전송')->setAttribute('type', 'submit') ]); echo $form;
테이블 컴포넌트
// 헬퍼 함수 사용 $table = CTable() ->addClass('table table-striped') ->addItem([ CRow([ CColHeader('이름'), CColHeader('이메일'), CColHeader('상태') ]), CRow([ CCol('홍길동'), CCol('hong@example.com'), CCol('활성')->addClass('text-success') ]) ]); echo $table;
고급 기능
조건부 렌더링
$div = new CDiv(); if ($showContent) { $div->setBodyContent('표시할 내용'); } else { $div->setBodyContent('기본 내용'); }
동적 속성 설정
$element = new CTag('span'); $attributes = [ 'class' => 'highlight', 'data-value' => $dynamicValue ]; foreach ($attributes as $key => $value) { $element->setAttribute($key, $value); }
문서
자세한 사용법은 docs 폴더의 문서를 참조하세요:
라이센스
이 패키지는 MIT 라이센스 하에 배포됩니다. 자세한 내용은 license.md를 확인하세요.
기여하기
버그 리포트, 기능 제안, 또는 풀 리퀘스트를 환영합니다. 기여하기 전에 코드 스타일과 테스트를 확인해 주세요.