capitalize

將字符串的第一個字符轉換為大寫，其余字符轉換為小寫。

基礎用法

import { capitalize } from 'radash'

const result = capitalize('hello world')
// 'Hello world'

const result2 = capitalize('JAVASCRIPT')
// 'Javascript'

語法

function capitalize(str: string): string

參數

• str (string): 要轉換的字符串

返回值

返回一個新字符串，第一個字符大寫，其余字符小寫。

示例

基本用法

import { capitalize } from 'radash'

console.log(capitalize('hello'))        // 'Hello'
console.log(capitalize('world'))        // 'World'
console.log(capitalize('javascript'))   // 'Javascript'
console.log(capitalize('react'))        // 'React'

處理全大寫字符串

import { capitalize } from 'radash'

console.log(capitalize('HELLO'))        // 'Hello'
console.log(capitalize('WORLD'))        // 'World'
console.log(capitalize('JAVASCRIPT'))   // 'Javascript'
console.log(capitalize('REACT'))        // 'React'

處理混合大小寫

import { capitalize } from 'radash'

console.log(capitalize('hElLo'))        // 'Hello'
console.log(capitalize('wOrLd'))        // 'World'
console.log(capitalize('jAvAsCrIpT'))   // 'Javascript'
console.log(capitalize('rEaCt'))        // 'React'

處理特殊字符

import { capitalize } from 'radash'

console.log(capitalize('hello world'))  // 'Hello world'
console.log(capitalize('hello-world'))  // 'Hello-world'
console.log(capitalize('hello_world'))  // 'Hello_world'
console.log(capitalize('hello.world'))  // 'Hello.world'

處理數字和符號

import { capitalize } from 'radash'

console.log(capitalize('123hello'))     // '123hello' (數字開頭)
console.log(capitalize('!hello'))       // '!hello' (符號開頭)
console.log(capitalize('@world'))       // '@world' (符號開頭)
console.log(capitalize('hello123'))     // 'Hello123'

處理空字符串和單個字符

import { capitalize } from 'radash'

console.log(capitalize(''))             // ''
console.log(capitalize('a'))            // 'A'
console.log(capitalize('A'))            // 'A'
console.log(capitalize('z'))            // 'Z'

處理Unicode字符

import { capitalize } from 'radash'

console.log(capitalize('café'))         // 'Café'
console.log(capitalize('naïve'))        // 'Naïve'
console.log(capitalize('résumé'))       // 'Résumé'
console.log(capitalize('über'))         // 'Über'

在數組中使用

import { capitalize } from 'radash'

const words = ['hello', 'world', 'javascript', 'react']
const capitalizedWords = words.map(word => capitalize(word))

console.log(capitalizedWords)
// ['Hello', 'World', 'Javascript', 'React']

處理對象屬性

import { capitalize } from 'radash'

const user = {
  firstName: 'john',
  lastName: 'doe',
  city: 'new york'
}

const formattedUser = {
  firstName: capitalize(user.firstName),
  lastName: capitalize(user.lastName),
  city: capitalize(user.city)
}

console.log(formattedUser)
// { firstName: 'John', lastName: 'Doe', city: 'New york' }

處理表單數據

import { capitalize } from 'radash'

function formatName(name: string) {
  return capitalize(name.trim())
}

console.log(formatName('  john  '))     // 'John'
console.log(formatName('  MARY  '))     // 'Mary'
console.log(formatName('  david  '))    // 'David'

注意事項

1. 只轉換第一個字符: 只有字符串的第一個字符會被轉換為大寫
2. 其余字符小寫: 字符串中除第一個字符外的所有字符都會被轉換為小寫
3. 空字符串: 空字符串會返回空字符串
4. 非字母字符: 如果第一個字符不是字母，函數會保持原樣
5. Unicode支持: 函數支持Unicode字符，包括重音符號

與其他方法的區別

• toUpperCase(): 將所有字符轉換為大寫
• toLowerCase(): 將所有字符轉換為小寫
• capitalize(): 只將第一個字符轉換為大寫，其余轉換為小寫
• titleCase(): 將每個單詞的首字母轉換為大寫

實際應用場景

1. 用戶界面: 格式化用戶輸入的名字
2. 數據展示: 格式化顯示數據中的標題
3. 表單處理: 標准化用戶輸入
4. 文件命名: 格式化文件名
5. API響應: 格式化從API返回的數據