---
title: "convertToKebabCase"
description: "将对象的所有键名从任意格式转换为 kebab-case（短横线连接）格式，返回新对象。"
seo_title: "convertToKebabCase"
seo_description: "Convert an object’s camelCase keys to kebab-case, optionally deeply, returning a new object useful for CSS or HTML attribute mapping."
canonical_url: "https://core.mhaibaraai.cn/docs/transformers/object/convert-to-kebab-case"
---
# convertToKebabCase

> 将对象的所有键名从任意格式转换为 kebab-case（短横线连接）格式，返回新对象。

## 用法

`convertToKebabCase` 函数用于将对象的键名转换为 kebab-case 格式。

```ts
import { convertToKebabCase } from '@movk/core'

const obj = {
  firstName: 'John',
  lastName: 'Doe',
  userInfo: {
    birthDate: '1990-01-01',
    phoneNumber: '123-456-7890'
  }
}

const converted = convertToKebabCase(obj)
console.log(converted)
// {
//   'first-name': 'John',
//   'last-name': 'Doe',
//   'user-info': { birthDate: '1990-01-01', phoneNumber: '123-456-7890' }
// }

const deepConverted = convertToKebabCase(obj, true)
console.log(deepConverted)
// {
//   'first-name': 'John',
//   'last-name': 'Doe',
//   'user-info': { 'birth-date': '1990-01-01', 'phone-number': '123-456-7890' }
// }
```

## API

### `convertToKebabCase<T>(obj, deep?)`

将对象的键名转换为 kebab-case 格式。

### 参数

**obj** (`T extends AnyObject`) *required*: 待转换的对象。

**deep** (`boolean`): 是否深度转换嵌套对象，默认为 false。

### 返回值

**返回值** (`T`): 转换后的对象。

## Changelog

See commit history for [src/transformers/object/convertToKebabCase.ts](https://github.com/mhaibaraai/movk-core/commits/main/src/transformers/object/convertToKebabCase.ts).


## Sitemap

See the full [sitemap](/sitemap.md) for all pages.