Full Name Format Pipe

Pipe định dạng tên người: viết hoa chữ cái đầu mỗi từ, viết thường phần còn lại, trim khoảng trắng, xóa khoảng trắng thừa và loại bỏ emoji.

Tính năng

• ✅ Viết hoa chữ cái đầu mỗi từ (Title Case)
• ✅ Viết thường các ký tự còn lại trong mỗi từ
• ✅ Trim khoảng trắng đầu/cuối chuỗi
• ✅ Xóa khoảng trắng thừa giữa các từ
• ✅ Loại bỏ emoji
• ✅ Hỗ trợ tiếng Việt có dấu unicode

Cài đặt

npm install @libs-ui/pipes-format-text-full-name-format

Import

import { LibsUiPipesFormatTextFullNameFormatPipe } from '@libs-ui/pipes-format-text-full-name-format';

@Component({
  standalone: true,
  imports: [LibsUiPipesFormatTextFullNameFormatPipe],
})
export class ExampleComponent {}

Cú pháp

{{ value | LibsUiPipesFormatTextFullNameFormatPipe }}

Ví dụ

Trong Template

<!-- Cơ bản -->
{{ 'john doe' | LibsUiPipesFormatTextFullNameFormatPipe }}
<!-- Output: John Doe -->

<!-- ALL CAPS → Title Case -->
{{ 'NGUYEN VAN A' | LibsUiPipesFormatTextFullNameFormatPipe }}
<!-- Output: Nguyen Van A -->

<!-- Trim & xóa khoảng trắng thừa -->
{{ ' TRAN THI B ' | LibsUiPipesFormatTextFullNameFormatPipe }}
<!-- Output: Tran Thi B -->

<!-- Loại bỏ emoji -->
{{ 'le thu C 😀🎉' | LibsUiPipesFormatTextFullNameFormatPipe }}
<!-- Output: Le Thu C -->

<!-- Tiếng Việt -->
{{ 'phạm thị MỸ LINH' | LibsUiPipesFormatTextFullNameFormatPipe }}
<!-- Output: Phạm Thị Mỹ Linh -->

Dùng trong TypeScript

Pipe là thin wrapper của hàm fullNameFormat trong @libs-ui/utils. Khi cần gọi trong TypeScript, import và dùng thẳng hàm đó — không cần inject pipe:

import { fullNameFormat } from '@libs-ui/utils';

// Dùng thẳng hàm utils — không cần inject pipe
const displayName = fullNameFormat('NGUYEN VAN A');
// Output: 'Nguyen Van A'

// Trong component class:
class ExampleComponent {
  displayName = fullNameFormat(this.user.rawName);
}

API

| Tham số | Kiểu | Bắt buộc | Mô tả | | ------- | -------- | -------- | ----------------------- | | value | string | ✅ | Tên người cần định dạng |

Lưu ý: Pipe không có tham số tùy chỉnh. Options được hardcode: lowercaseOtherCharacter=true, trim=true, removeMultipleSpace=true, removeEmoji=true.

Khi nào sử dụng

• Form nhập tên: Chuẩn hóa tên người dùng nhập vào về dạng "Nguyễn Văn A"
• Import dữ liệu: Tên từ Excel/CSV/hệ thống ngoài thường ở dạng ALL CAPS hoặc lowercase
• Hiển thị profile: Đảm bảo format tên nhất quán trong danh sách, avatar, profile

Lưu ý quan trọng

• Pipe không hỗ trợ tùy chỉnh options — đây là pipe chuyên dụng cho định dạng tên người
• Nếu cần tùy chỉnh options (ví dụ: giữ nguyên emoji), hãy dùng trực tiếp capitalize() từ @libs-ui/utils
• Khi input là null, undefined hoặc chuỗi rỗng, pipe trả về nguyên giá trị đó (không throw error)