README

PHPでHTMLの組み立てができるライブラリ

このライブラリを利用する場合

インストール

$ composer require tyokinuhata/html-builder

サンプルコード

<?php

require_once 'vendor/autoload.php';

$hb = new HtmlBuilder\HtmlBuilder();

$hb
->html('lang', 'ja')
    ->head()
        ->meta('charset', 'utf-8')
        ->title()
            ->text('タイトル')->upstream()
        ->style([
            '#title' => [
                'color' => 'white',
                'background' => 'red'
            ],
            '#content' => [
                'color' => 'green',
                'background' => 'blue'
            ]
        ])->upstream()
    ->body()
        ->h1('id', 'title')
            ->text('見出し')->upstream()
        ->p('id', 'content')
            ->text('本文')->upstream()
        ->input('type', 'text', '@autofocus')
        ->button('type', 'submit')
            ->text('送信')->append();

基本的に要素は, ->要素名()の形式で記述します.
属性と値を取る要素の場合は, ->要素名('属性', '値')のように記述します.
例外として, 値を取らなくて良い属性を記述する場合は, ->要素名('@属性')のように記述します.

プレーンなテキストを記述する場合は, ->text('テキスト')のように, 引数に対して描画したいテキストを渡します.

CSSの記述は, ->div('style', 'プロパティ:値;'), ->link('rel', '.cssファイルのパス')のようにできる他, ->style(['セレクタ' => ['プロパティ' => '値'])のように記述することも可能です.

->upstream()はその階層を抜ける場合に使用します.
複数階層抜ける場合は->upstream(2)のように, 抜ける階層数を引数に指定します.

->build('パス')はビルド用のメソッドです.
引数で指定したパスに対して, PHPファイルを基にHTMLファイルを生成します.

->append()は出力用のメソッドです.

ビルドインサーバの起動

$ php -S localhost:8000 index.php

使用可能な要素一覧

• html
• head
• title
• link
• meta
• style
• script
• body
• section
• nav
• article
• aside
• h1 ~ h6
• header
• footer
• p
• hr
• pre
• ol
• ul
• li
• dl
• dt
• dd
• div
• main
• a
• strong
• sub
• sup
• i
• b
• span
• br
• wbr
• img
• iframe
• table
• caption
• col
• tbody
• thead
• tfoot
• tr
• td
• th
• form
• label
• input
• button
• select
• option
• textarea

このライブラリを開発する場合

クローン

$ git clone https://github.com/tyokinuhata/html-builder.git

セットアップ

$ make setup

ビルドインサーバの起動

$ make up

各ファイルの説明

リンク

GitHub
Packagist