Typography 클래스¶

Typography 클래스는 텍스트 형식을 지정하는 데 도움이 되는 메소드를 제공합니다.

Typography 클래스 사용 ¶

클래스 초기화 ¶

CodeIgniter의 대부분의 클래스와 마찬가지로 Typography 클래스는 컨트롤러에서 $this->load->library() 메소드를 사용하여 초기화합니다:

$this->load->library('typography');

로드되면 다음을 사용하여 Typography 라이브러리 객체에 접근할 수 있습니다:

$this->typography

클래스 레퍼런스 ¶

class CI_Typography¶

$protect_braced_quotes = FALSE

템플릿 파서 라이브러리와 함께 Typography 라이브러리를 사용할 때는 중괄호 안의 작은따옴표와 큰따옴표를 보호하는 것이 바람직할 수 있습니다. 이를 활성화하려면 protect_braced_quotes 클래스 속성을 TRUE로 설정합니다.

사용 예시:

$this->load->library('typography');
$this->typography->protect_braced_quotes = TRUE;

auto_typography($str[, $reduce_linebreaks = FALSE])¶

매개변수:

$str (string) – 입력 문자열
$reduce_linebreaks (bool) – 연속 줄 바꿈을 줄일지 여부

반환:

HTML 타이포그래피 안전 문자열

반환 형식:

string

텍스트가 의미론적으로나 타이포그래피적으로 올바른 HTML이 되도록 형식을 지정합니다. 문자열을 입력으로 받아 다음 형식을 적용하여 반환합니다:

단락을 <p></p>로 둘러쌉니다(이중 줄 바꿈을 단락으로 인식).

단일 줄 바꿈은 <br />로 변환됩니다. <pre> 태그 안에 있는 것은 제외.

<div> 태그와 같은 블록 레벨 요소는 단락으로 감싸지지 않지만 단락이 포함된 경우 포함된 텍스트는 감싸집니다.

따옴표는 태그 안에 있는 것을 제외하고 올바르게 향하는 곱슬 따옴표 엔티티로 변환됩니다.

아포스트로피는 곱슬 아포스트로피 엔티티로 변환됩니다.

이중 대시(– this 또는 like–this 형태)는 em 대시(—)로 변환됩니다.

단어 앞이나 뒤에 오는 세 개의 연속 점은 줄임표(…)로 변환됩니다.

문장 뒤의 이중 공백은 이중 간격을 모방하기 위해 줄 바꿈 없는 공백으로 변환됩니다.

사용 예시:

$string = $this->typography->auto_typography($string);

파서가 두 개 이상의 연속 줄 바꿈을 두 개로 줄일지 여부를 결정하는 선택적 매개변수가 있습니다. 줄 바꿈 줄이기를 활성화하려면 불리언 TRUE를 전달합니다:

$string = $this->typography->auto_typography($string, TRUE);

참고

타이포그래피 형식 지정은 특히 많은 콘텐츠를 형식화하는 경우 프로세서 집약적일 수 있습니다. 이 메소드를 사용하기로 선택한 경우 페이지 캐싱을 고려할 수 있습니다.

format_characters($str)¶

매개변수:

$str (string) – 입력 문자열

반환:

형식화된 문자열

반환 형식:

string

이 메소드는 위의 auto_typography()와 유사하지만 문자 변환만 수행합니다:

따옴표는 태그 안에 있는 것을 제외하고 올바르게 향하는 곱슬 따옴표 엔티티로 변환됩니다.

아포스트로피는 곱슬 아포스트로피 엔티티로 변환됩니다.

이중 대시(– this 또는 like–this 형태)는 em 대시(—)로 변환됩니다.

단어 앞이나 뒤에 오는 세 개의 연속 점은 줄임표(…)로 변환됩니다.

문장 뒤의 이중 공백은 이중 간격을 모방하기 위해 줄 바꿈 없는 공백으로 변환됩니다.

사용 예시:

$string = $this->typography->format_characters($string);

nl2br_except_pre($str)¶

매개변수:

$str (string) – 입력 문자열

반환:

형식화된 문자열

반환 형식:

string

<pre> 태그 안에 있는 것을 제외하고 줄 바꿈을 <br /> 태그로 변환합니다. 이 메소드는 기본 PHP nl2br() 함수와 동일하지만 <pre> 태그를 무시합니다.

사용 예시:

$string = $this->typography->nl2br_except_pre($string);

Typography 클래스¶