HTML Helper¶
HTML 헬퍼는 HTML관련 작업에 유용한 함수를 포함합니다.
사용 가능한 함수들 Available Functions¶
아래의 함수들이 사용 가능합니다:
- heading([$data = ''[, $h = '1'[, $attributes = '']]])¶
인수: - $data (string) – Content
- $h (string) – Heading level
- $attributes (mixed) – HTML attributes
반환값: HTML heading tag
반환형: 문자열
HTML heading 태그를 생성합니다. 첫 번째 파라미터는 데이터, 두 번째 파라미터는 글자 크기를 지정합니다. 예제:
echo heading('Welcome!', 3);
위 코드는 다음을 생성합니다 : <h3>Welcome!</h3>
heading 태그에 HTML 클래스 같은 속성을 추가하려면, 세 번째 파라미터를 이용하세요(아이디를 사용할 수도 있고, 스타일을 직접 추가할 수도 있습니다):
echo heading('Welcome!', 3, 'class="pink"'); echo heading('How are you?', 4, array('id' => 'question', 'class' => 'green'));
위 코드는 다음을 생성함:
<h3 class="pink">Welcome!<h3> <h4 id="question" class="green">How are you?</h4>
- img([$src = ''[, $index_page = FALSE[, $attributes = '']]])¶
인수: - $src (string) – Image source data
- $index_page (bool) – Whether to treat $src as a routed URI string
- $attributes (array) – HTML attributes
반환값: HTML image tag
반환형: 문자열
<img />태그를 생성합니다. 첫 번째 파라미터로 이미지 소스를 지정합니다. 예제:
echo img('images/picture.jpg'); // gives <img src="http://site.com/images/picture.jpg" />
옵션인 두 번째 파라미터는 src주소에 $config['index_page']에 정의된 페이지를 포함해야할지 말지를 정의하는 TRUE/FALSE 값입니다. 미디어 컨트롤러(media controller)를 사용하실 경우 필요하실 것입니다:
echo img('images/picture.jpg', TRUE); // gives <img src="http://site.com/index.php/images/picture.jpg" alt="" />
추가적으로, 모든 속성(attributes) 및 값(values)을 설정하기 위해서 img() 함수에 연관배열을 넘겨줄 수 있습니다. alt 속성이 제공되지 않으면. CodeIgniter는 빈 문자열을 생성합니다.
예제:
$image_properties = array( 'src' => 'images/picture.jpg', 'alt' => 'Me, demonstrating how to eat 4 slices of pizza at one time', 'class' => 'post_images', 'width' => '200', 'height'=> '200', 'title' => 'That was quite a night', 'rel' => 'lightbox' ); img($image_properties); // <img src="http://site.com/index.php/images/picture.jpg" alt="Me, demonstrating how to eat 4 slices of pizza at one time" class="post_images" width="200" height="200" title="That was quite a night" rel="lightbox" />
- link_tag([$href = ''[, $rel = 'stylesheet'[, $type = 'text/css'[, $title = ''[, $media = ''[, $index_page = FALSE]]]]]])¶
인수: - $href (string) – What are we linking to
- $rel (string) – Relation type
- $type (string) – Type of the related document
- $title (string) – Link title
- $media (string) – Media type
- $index_page (bool) – Whether to treat $src as a routed URI string
반환값: HTML link tag
반환형: 문자열
<link /> 태그를 만듭니다. 이 함수는 스타일시트(stylesheet)링크 작성시 유용합니다. 파라미터는 href 이며, 옵션으로 rel, type, title, media 그리고 index_page 를 설정할 수 있습니다.
index_page 는 주소에 $config['index_page'] 에 정의된 페이지를 포함해야할지 말지를 정의하는 TRUE/FALSE 값입니다.
예제:
echo link_tag('css/mystyles.css'); // gives <link href="http://site.com/css/mystyles.css" rel="stylesheet" type="text/css" />
추가 예제:
echo link_tag('favicon.ico', 'shortcut icon', 'image/ico'); // <link href="http://site.com/favicon.ico" rel="shortcut icon" type="image/ico" /> echo link_tag('feed', 'alternate', 'application/rss+xml', 'My RSS Feed'); // <link href="http://site.com/feed" rel="alternate" type="application/rss+xml" title="My RSS Feed" />
추가적으로, 모든 속성(attributes) 및 값(values)을 설정하기 위해서 link() 함수에 연관배열을 넘겨줄 수 있습니다:
$link = array( 'href' => 'css/printer.css', 'rel' => 'stylesheet', 'type' => 'text/css', 'media' => 'print' ); echo link_tag($link); // <link href="http://site.com/css/printer.css" rel="stylesheet" type="text/css" media="print" />
- ul($list[, $attributes = ''])¶
인수: - $list (array) – List entries
- $attributes (array) – HTML attributes
반환값: HTML-formatted unordered list
반환형: 문자열
단순배열 혹은 다차원배열로부터 순서(ordered) 혹은 비순서(unordered) 리스트를 생성합니다. 예제:
$list = array( 'red', 'blue', 'green', 'yellow' ); $attributes = array( 'class' => 'boldlist', 'id' => 'mylist' ); echo ul($list, $attributes);
위 코드는 아래를 생성합니다:
<ul class="boldlist" id="mylist"> <li>red</li> <li>blue</li> <li>green</li> <li>yellow</li> </ul>
다차원배열을 이용한 보다 복잡한 예제입니다:
$attributes = array( 'class' => 'boldlist', 'id' => 'mylist' ); $list = array( 'colors' => array( 'red', 'blue', 'green' ), 'shapes' => array( 'round', 'square', 'circles' => array( 'ellipse', 'oval', 'sphere' ) ), 'moods' => array( 'happy', 'upset' => array( 'defeated' => array( 'dejected', 'disheartened', 'depressed' ), 'annoyed', 'cross', 'angry' ) ) ); echo ul($list, $attributes);
위 코드는 아래를 생성합니다:
<ul class="boldlist" id="mylist"> <li>colors <ul> <li>red</li> <li>blue</li> <li>green</li> </ul> </li> <li>shapes <ul> <li>round</li> <li>suare</li> <li>circles <ul> <li>elipse</li> <li>oval</li> <li>sphere</li> </ul> </li> </ul> </li> <li>moods <ul> <li>happy</li> <li>upset <ul> <li>defeated <ul> <li>dejected</li> <li>disheartened</li> <li>depressed</li> </ul> </li> <li>annoyed</li> <li>cross</li> <li>angry</li> </ul> </li> </ul> </li> </ul>
- ol($list, $attributes = '')¶
인수: - $list (array) – List entries
- $attributes (array) – HTML attributes
반환값: HTML-formatted ordered list
반환형: 문자열
<ul> 태그 대신에 <ol> 태그를 생성한다는 것만 빼면, ul() 과 동일합니다.
- meta([$name = ''[, $content = ''[, $type = 'name'[, $newline = "n"]]]])¶
인수: - $name (string) – Meta name
- $content (string) – Meta content
- $type (string) – Meta type
- $newline (string) – Newline character
반환값: HTML meta tag
반환형: 문자열
메타태그를 생성합니다. 문자열이나 단순한 배열 또는 다차원배열을 넘겨줍니다.
예제:
echo meta('description', 'My Great site'); // Generates: <meta name="description" content="My Great Site" /> echo meta('Content-type', 'text/html; charset=utf-8', 'equiv'); // Note the third parameter. Can be "equiv" or "name" // Generates: <meta http-equiv="Content-type" content="text/html; charset=utf-8" /> echo meta(array('name' => 'robots', 'content' => 'no-cache')); // Generates: <meta name="robots" content="no-cache" /> $meta = array( array( 'name' => 'robots', 'content' => 'no-cache' ), array( 'name' => 'description', 'content' => 'My Great Site' ), array( 'name' => 'keywords', 'content' => 'love, passion, intrigue, deception' ), array( 'name' => 'robots', 'content' => 'no-cache' ), array( 'name' => 'Content-type', 'content' => 'text/html; charset=utf-8', 'type' => 'equiv' ) ); echo meta($meta); // Generates: // <meta name="robots" content="no-cache" /> // <meta name="description" content="My Great Site" /> // <meta name="keywords" content="love, passion, intrigue, deception" /> // <meta name="robots" content="no-cache" /> // <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
- doctype([$type = 'xhtml1-strict'])¶
인수: - $type (string) – Doctype name
반환값: HTML DocType tag
반환형: 문자열
문서형식선언을 도와줍니다. DTD’s. XHTML 1.0 Strict 이 기본적으로 사용되지만, 다른 doctypes 도 사용 가능합니다.
예제:
echo doctype(); // <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> echo doctype('html4-trans'); // <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
아래 목록은 Doctype 선택 목록입니다. application/config/doctypes.php 에서 설정 내용을 가져옵니다.
문서 형태 옵션 결과 XHTML 1.1 xhtml11 <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.1//EN” “http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd“> XHTML 1.0 Strict xhtml1-strict <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Strict//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd“> XHTML 1.0 Transitional xhtml1-trans <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd“> XHTML 1.0 Frameset xhtml1-frame <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Frameset//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd“> XHTML Basic 1.1 xhtml-basic11 <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML Basic 1.1//EN” “http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd“> HTML 5 html5 <!DOCTYPE html> HTML 4 Strict html4-strict <!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01//EN” “http://www.w3.org/TR/html4/strict.dtd“> HTML 4 Transitional html4-trans <!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01 Transitional//EN” “http://www.w3.org/TR/html4/loose.dtd“> HTML 4 Frameset html4-frame <!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01 Frameset//EN” “http://www.w3.org/TR/html4/frameset.dtd“> MathML 1.01 mathml1 <!DOCTYPE math SYSTEM “http://www.w3.org/Math/DTD/mathml1/mathml.dtd“> MathML 2.0 mathml2 <!DOCTYPE math PUBLIC “-//W3C//DTD MathML 2.0//EN” “http://www.w3.org/Math/DTD/mathml2/mathml2.dtd“> SVG 1.0 svg10 <!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.0//EN” “http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd“> SVG 1.1 Full svg11 <!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1//EN” “http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd“> SVG 1.1 Basic svg11-basic <!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1 Basic//EN” “http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-basic.dtd“> SVG 1.1 Tiny svg11-tiny <!DOCTYPE svg PUBLIC “-//W3C//DTD SVG 1.1 Tiny//EN” “http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtd“> XHTML+MathML+SVG (XHTML host) xhtml-math-svg-xh <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN” “http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd“> XHTML+MathML+SVG (SVG host) xhtml-math-svg-sh <!DOCTYPE svg:svg PUBLIC “-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN” “http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd”> XHTML+RDFa 1.0 xhtml-rdfa-1 <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML+RDFa 1.0//EN” “http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd“> XHTML+RDFa 1.1 xhtml-rdfa-2 <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML+RDFa 1.1//EN” “http://www.w3.org/MarkUp/DTD/xhtml-rdfa-2.dtd“>
- br([$count = 1])¶
인수: - $count (int) – Number of times to repeat the tag
반환값: HTML line break tag
반환형: 문자열
파라미터로 넘어온 숫자만큼 <br /> 태그를 생성합니다. 예제:
echo br(3);
위 코드는 아래를 생성합니다:
<br /><br /><br />
Note
이 함수는 DEPRECATED 되었습니다. 대신, 내장 함수인 str_repeat() 를 <br /> 와 함께 사용하여 주세요.
- nbs([$num = 1])¶
인수: - $num (int) – Number of space entities to produce
반환값: A sequence of non-breaking space HTML entities
반환형: 문자열
파라미터로 넘어온 숫자만큼 를 생성합니다. 예제:
echo nbs(3);
위 코드는 아래를 생성합니다:
Note
이 함수는 DEPRECATED 되었습니다. 대신, 내장함수인 str_repeat() 과 를 함께 사용하여 주세요.